Damla aramaları
Uygulaman, kullanıcının açık izni varsa onu inkiveta'nın sesli yapay zekâ asistanı Damla'ya arattırabilir. Damla senin adına kısa bir telefon görüşmesi yapar, tanımladığın soruları doğal bir konuşmayla sorar ve cevapları sana tipli, doğrulanmış değerler olarak bir update ile iletir: true/false, sayı, tarih, seçenek ya da kısa metin.
Örnek kullanımlar:
- Bir spor kulübü, birkaç gündür gelmeyen üyesini aratıp ne zaman uğrayacağını sorar.
- Bir market, yarınki teslimat saatinin uygun olup olmadığını teyit eder.
- Bir kuaför, randevuyu bir gün önceden teyit eder; bir abonelik hizmeti, bitiş tarihini hatırlatır.
Bütün uygulamalara açık, genel bir yetenektir. Arama ücretlidir: uygulamanın Damla arama cüzdanına geliştirici panelinden dakika paketi yüklersin (Dakika paketleri). Her istekte aramanın amacını beyan edersin; Damla aramaları varsayılan olarak hizmet aramasıdır ve tanıtım içeremez (Hizmet aramaları).
Dikkat: Damla bir telefon santrali değildir: serbest bir metin okutamaz, istediğin her şeyi sordurtamazsın. Arama, platformun hazır şablonlarıyla açılır; senin tanımladığın kısa sorular kurallardan ve denetimden geçer. Konuşmanın yazılı dökümü ya da ses kaydı sana hiçbir zaman verilmez.
Nasıl çalışır?#
- Kullanıcı arama izni verir (Kullanıcı izni). Sana
inki_call_accessupdate'i gelir. - Geliştirici panelinden (web Atölye) uygulamanın Damla arama cüzdanına dakika paketi yüklersin.
inkiDamlaCallile arama istersin. İstek kuyruğa alınır, azami süre kadar bakiye ayrılır.- Damla uygun ilk anda arar: sessiz saatler dışında ve istediğin zaman penceresi içinde.
- Arama bitince sana
inki_damla_call_resultgelir: sonuç, süre, ücret, soruların cevapları, kullanıcının söylediklerinden notlar ve kısa bir özet. Ücret kesinleşir, ayrılan bakiyenin kalanı geri döner.
Arama eşzamansızdır: inkiDamlaCall yanıtı aramanın yapıldığı değil, sıraya alındığı anlamına gelir. Kullanıcının o an meşgul olması ya da gece olması hata değildir; arama uygun zamanı bekler.
Kullanıcı izni#
İzin inkiveta'da tutulur: kullanıcı platformun kendi penceresinde verir, uygulaman izni yazamaz ya da "izin var" diye bildiremez. Kendi sisteminde tuttuğun iletişim tercihleri yalnız ön filtre olabilir.
Mini App'ten (inkiveta uzantısı):
jsInki.inkiRequestCallAccess((r) => {
// r.status: "allowed" | "cancelled"
if (r.status === 'allowed') goster('Teşekkürler, gerektiğinde Damla seni arayabilir.');
});
- Kullanıcıya platformun izin penceresi açılır; metni sen yazmazsın. İzin zaten verilmişse pencere açılmaz,
alloweddöner. - Olay adı
inki_request_call_access, yanıtinki_call_access_requested;WebApp.onEvent('inkiCallAccessRequested', …)da tetiklenir. Web sürümündeinkiveta-web-app.jsyüklüyse aynı çalışır; yalnız resmîtelegram-web-app.jsileTelegram.WebView.postEvent('inki_request_call_access', false, {})gönder. İşlev olarak sına:window.Inki && typeof Inki.inkiRequestCallAccess === 'function'(Mini App).
Sohbetten: inkiRequestCallAccess(user_id) sohbete platformun izin kartını gönderir: "<Uygulama>, seni Damla ile arayıp kısa hatırlatmalar yapmak istiyor. Günde en çok 1 arama, 09:00–20:00 arası (pazar ve resmî tatiller hariç). İstediğin an kapatabilirsin." Kart kullanıcıya yazma kurallarına tabidir. Dönüş {"status":"sent"} ya da izin zaten varsa {"status":"already_allowed"}.
İzin değişince (verildi ya da kapandı; kullanıcı kartta "İzin verme" derse de) sana gelir. allowed_updates'te inki_call_access istemiş olmalısın; kullanıcı uygulamanı engellemiş olsa da teslim edilir:
json{"update_id":7710,"inki_call_access":{"from":{"id":4185489292941965,"is_bot":false,"first_name":"Kullanıcı"},"allowed":false,"date":1794657600}}
Kapanmanın nedeni verilmez. Kullanıcı izni şu yollarla kapatabilir: uygulama ayarlarındaki "Damla aramaları" anahtarı, uygulamayı engellemek, aramada "beni bir daha arama" demek ya da Damla aramalarını genel olarak kapatmak. Kullanıcının genel ayarı uygulamaya verdiği izni her zaman ezer.
- Kullanıcı izni reddettiyse ya da kapattıysa 30 gün yeniden soramazsın; aramada "beni bir daha arama" dediyse izni yalnız kendisi yeniden açabilir. Bu durumlarda istek
403 Forbidden: CALL_ACCESS_RECENTLY_DECLINEDdöner. - Uygulama devredilirse ya da aydınlatma bağlantın değişirse izin düşer ve yeniden istenir (Gizlilik).
Fiyatlandırma ve cüzdan#
- 1 dakika = 5,00 TL. Bütün tutarlar kuruş cinsinden tam sayıdır (
unit_price: 500,currency: "TRY"). - Başlayan dakika ücretlenir: ücretli dakika = bağlı saniye / 60, yukarı yuvarlanır.
- Bağlanmayan arama ücretsizdir: cevapsız, meşgul, zili reddedilen, ulaşılamayan ve Damla tarafında kurulamayan aramalar 0 TL'dir. "Bağlandı", kullanıcının aramayı açtığı andır; zilin çaldığı süre ücretlenmez. Açıp hemen kapatan kullanıcıda da 1 dakika ücretlenir.
- Bağlantı ilk 10 saniyede bizim tarafımızdan (teknik bir sorunla) koparsa arama ücretsizdir.
- Her arama, istendiği andaki birim fiyatla hesaplanır; fiyat sonradan değişse de geçmiş aramaların ücreti değişmez.
| Arama | Bağlı süre | Ücretli dakika | Tutar |
|---|---|---|---|
| Kullanıcı açmadı | — | 0 | 0,00 TL |
| Kullanıcı meşguldü ya da zili reddetti | — | 0 | 0,00 TL |
| Açtı, hemen kapattı | 4 sn | 1 | 5,00 TL |
| Kısa teyit | 45 sn | 1 | 5,00 TL |
| Tam bir dakika | 60 sn | 1 | 5,00 TL |
| Üç soruluk görüşme | 74 sn | 2 | 10,00 TL |
| Azami süre | 180 sn | 3 | 15,00 TL |
Bakiye ayırma. İstek anında, azami görüşme süresi (max_duration) kadar bakiye ayrılır: 60 saniyeye kadar 5 TL, 120 saniyeye kadar 10 TL, 180 saniyeye kadar 15 TL. Kullanılabilir bakiye yetmezse arama başlamaz (402 Payment Required: CALL_BALANCE_INSUFFICIENT). Damla görüşmeyi azami sürede bitirir, bu yüzden konuşma ortasında bakiye bitmez ve tutar ayrılan miktarı asla aşmaz. Arama bitince gerçek tutar düşülür, kalanı kullanılabilir bakiyeye döner.
Bütçe örneği. 200 üyeyi max_duration: 120 ile aratıyorsun; 120'si açıyor, görüşmeler ortalama 80 saniye sürüyor. 120 × 2 dakika × 5 TL = 1.200 TL. Açmayan 80 arama ücretsizdir; ama istek anında 200 × 10 TL = 2.000 TL ayrılacağı için o anda kullanılabilir bakiyen en az bu kadar olmalı (aramalar bittikçe geri döner).
Bakiye ve döküm:
bashcurl -s "https://app.inkiveta.com/bot$BOT_TOKEN/inkiGetDamlaCallBalance"
# {"ok":true,"result":{"balance":25000,"reserved":1000,"available":24000,"unit_price":500,"currency":"TRY","billing_unit":"started_minute"}}
inkiGetDamlaCallTransactions (offset ≤ 5.000, limit 1–100) yüklemeleri ve kesinleşmiş aramaları listeler: tarih, kullanıcı (uygulamanın gördüğü kimlik), süre, ücretli dakika, birim fiyat, tutar, sonuç kodu. Konuşma içeriği yoktur. Aynı bilgiler Atölye'deki cüzdan ekranında da görünür.
Uygulama devredilir ya da silinirse kalan bakiye sahibine iade edilir (dökümde refund). Kuyrukta ya da sürmekte olan arama varken (ayrılmış bakiye varken) devir ve silme 409 DAMLA_REZERV_BEKLIYOR ile bekletilir: önce aramaları iptal et ya da bitmelerini bekle.
Dakika paketleri#
Cüzdana bakiye yalnız dakika paketiyle yüklenir. Paket fiyatı dakika × 5,00 TL'dir; indirim yoktur. Tutarlar KDV dahildir.
| Paket | Dakika | Tutar (KDV dahil) |
|---|---|---|
dk_60 | 60 | 300 TL |
dk_200 | 200 | 1.000 TL |
dk_600 | 600 | 3.000 TL |
dk_2000 | 2.000 | 10.000 TL |
- Paketler geliştirici panelinden (web) alınır: web.inkiveta.com → Keşfet → Atölye → uygulaman → Damla dakikaları. Mobil uygulamada paket satın alınmaz (mağaza kuralları); bakiyeni ve dökümünü her yerden görebilirsin.
- Yalnız uygulama sahibi yükler; ekip rolleri yükleyemez. Ödeme kartla, açılan güvenli ödeme sayfasında alınır; bakiye ödeme onaylanınca yüklenir. Damla aramaları Ink ile ödenmez.
- Yüklenen tutar cüzdana kuruş olarak eklenir; aramalar başlayan dakika × o anki birim fiyatla düşer.
- Uygulama devredilir ya da silinirse kalan bakiye sahibine iade edilir.
- Test ortamında gerçek para yoktur: Atölye → Damla dakikaları → Test'te "test bakiyesi ekle" seçtiğin paketin tutarı kadar test bakiyesi ekler (mobilden de).
İpucu: Token'ın sızarsa kayıp, cüzdandaki bakiye ve günlük sınırlarla sınırlıdır. Cüzdanda yakın dönemde kullanacağın kadar bakiye tut.
Arama isteği#
inkiDamlaCall:
| Parametre | Tür | Zorunlu | Açıklama |
|---|---|---|---|
user_id | int | evet | uygulamanı başlatmış kullanıcı |
purpose_declaration | string | evet | aramanın amacı: appointment (randevu) · delivery (teslimat) · membership_status (üyelik durumu) · membership_followup (üyelik takibi) · general_service (diğer hizmet bildirimi) · marketing (pazarlama) |
service_only | bool | hizmet amacında evet | marketing dışındaki her amaçta true göndermelisin: "bu arama yalnız hizmet bildirimidir, tanıtım içermez" beyanı |
marketing | bool | pazarlamada evet | purpose_declaration: "marketing" ise true (Pazarlama aramaları) |
health_consent | bool | hayır | varsayılan false. Sağlık alanı (sensitive: "health") soruyorsan true göndermelisin: kullanıcının bu veri için açık rızası sende kayıtlı |
template | string | evet | açılış şablonu (aşağıda) |
params | object | şablona göre | şablonun alanları, en çok 4 |
fields | array | hayır | sorulacak 0–6 alan (Soru alanları) |
knowledge | array | hayır | kullanıcının sorabileceği şeyler için kısa bilgi (Damla'nın bildikleri) |
accept_notes | array | hayır | kabul ettiğin not türleri; verilmezse hepsi, [] = not alma (Neyi iletir, neyi iletmez) |
max_duration | int | hayır | azami görüşme süresi, 30–180 sn, varsayılan 120 |
not_before, not_after | int (Unix) | hayır | arama penceresi; not_after en çok 72 saat sonrası |
idempotency_key | string | evet | 1–64 karakter, [A-Za-z0-9_:-]; aynı anahtarla tekrar istek ikinci arama açmaz |
Dönüş:
json{"ok":true,"result":{"call_request_id":"dc_01JD8Q…","status":"queued","reserved_amount":1000,"unit_price":500,"currency":"TRY","balance":24000}}
balance ayırmadan sonraki kullanılabilir bakiyedir. Ağ hatasında aynı idempotency_key ile güvenle yeniden dene; aynı anahtarı farklı parametrelerle gönderirsen 400 Bad Request: IDEMPOTENCY_KEY_REUSED.
Amaç beyanı yoksa, listede değilse ya da service_only: true (pazarlamada marketing: true) gönderilmemişse istek 400 Bad Request: CALL_PURPOSE_REQUIRED döner. Beyanın kaydı tutulur; yanlış beyan geliştirici şartlarına aykırıdır.
Damla aramayı, istediğin pencerenin içinde ve kullanıcının saatiyle izinli ilk anda yapar (Sınırlar). Pencere hiçbir izinli saatle kesişmiyorsa (ör. yalnız pazar günü ya da gece) istek 400 Bad Request: CALL_PARAM_INVALID: not_after döner.
Şablonlar#
Şablon yalnız aramanın açılışını ve tonunu belirler. Bilgiyi fields ile toplarsın. Damla her aramayı aynı biçimde açar: kim olduğunu, yapay zekâ olduğunu, hangi uygulama adına aradığını söyler; sorulara geçmeden önce cevapların sana iletileceğini ve istemediği soruyu geçebileceğini belirtir.
template | Damla'nın açılışı | params |
|---|---|---|
general | purpose'u arama nedeni olarak söyler | purpose (zorunlu, ≤ 80), place_name |
visit_reminder | "X gündür görüşemedik, seni merak ettik" | place_name, days_absent (zorunlu, 1–365) |
appointment_confirm | randevu teyidi | place_name, when (zorunlu, ISO 8601), service (≤ 40) |
renewal_reminder | üyeliğin bitiş tarihini yalnız bildirir; yenileme teklifi, fiyat, ödeme konuşulmaz | place_name, ends_on (zorunlu, YYYY-MM-DD) |
check_in | kısa hal hatır ("nasıl gidiyor") | place_name, topic (≤ 40) |
place_name(≤ 40) verilmezse uygulamanın işletme adı ya da görünen adı kullanılır. Damla her zaman uygulamanın adını da söyler: "Kulüp uygulamasından, Sahil Kulübü adına arıyorum."- Metin parametreleri tek satırdır; bağlantı, alan adı,
@, telefon/IBAN gibi 6 ve daha uzun rakam dizileri ve kontrol karakteri içeremez. Hepsi içerik denetiminden geçer. Hizmet aramasındapurpose,service,topicfiyat, indirim, kampanya gibi tanıtım dili içeremez (400 Bad Request: CALL_CONTENT_REJECTED). - Açılış her aramada aynı biçimdedir: "Merhaba, Ayşe ile mi görüşüyorum? Ben Damla, Kulüp uygulamasından, Sahil Kulübü adına arıyorum; yapay zekâ asistanıyım." Kimlik doğrulanınca: "Birkaç kısa soru soracağım; söylediklerini Sahil Kulübü'ne ileteceğim, istemediğin soruyu geçebiliriz." Pazarlama aramasında açılışa "Tanıtım ve kampanya amaçlı arıyorum." eklenir.
- Parametreler, sorular ve bilgi çiftleri Damla'ya veri olarak verilir, talimat olarak değil: içlerine "önceki kuralları unut" gibi bir şey yazılsa da Damla'nın davranışı değişmez.
Soru alanları#
Her alan, Damla'nın konuşmada soracağı bir soru ve beklenen cevabın tipidir:
| Anahtar | Kural |
|---|---|
key | küçük harfle başlar; küçük harf, rakam ve _, en çok 32 karakter; istek içinde tekil |
question | 3–80 karakter, tek satır; bağlantı, @, 6 ve daha fazla haneli rakam dizisi, tırnak içeremez |
type | yes_no · number · date · choice · text |
required | varsayılan false. Damla zorunlu alanları önce sorar |
include_raw | varsayılan false. true ise sonuçta kullanıcının o cevaptaki sözü de (raw, ≤ 60 karakter) gelir |
sensitive | yalnız "health": alan sağlıkla ilişkili bir beyan soruyor (kilo, ölçü…). İstekte health_consent: true yoksa alan reddedilir |
number için | min ve max (zorunlu), unit (≤ 12, ör. kg), decimals (0–2) |
date için | range_days: [geçmiş, gelecek] gün penceresi, varsayılan [0, 30] |
choice için | options: 2–6 adet {id, label} (label ≤ 30) |
text için | max_length 10–120, varsayılan 60 |
En çok 6 alan; bütün soru ve seçenek metinlerinin toplamı en çok 600 karakter. Alanlar arasında koşul tanımlanamaz: her soruyu tek başına anlamlı olacak şekilde yaz. Hizmet aramasında soru ve seçenek metinleri tanıtım dili içeremez (CALL_CONTENT_REJECTED).
Cevaplar nasıl normalize edilir?#
Değeri yapay zekâ değil sunucu hesaplar; sonuç her zaman aynı kurallarla gelir:
type | Gelen value | Örnek | unclear olur |
|---|---|---|---|
yes_no | true / false | "Tartıldım" → true | net evet/hayır yoksa |
number | sayı, decimals'a yuvarlanmış | "elli sekiz buçuk" → 58.5; "58,4" → 58.4 | min–max dışındaysa |
date | YYYY-MM-DD, kullanıcının saat diliminde | "yarın", "cuma", "haftaya salı" | range_days dışında ya da çözülemezse |
choice | seçeneğin id'si | "kapıya bırakın" → "kapiya" | seçeneklerde yoksa |
text | kırpılmış kısa metin | gizli bilgi (parola, kod) içeriyorsa |
Sayı ve tarih cevaplarını Damla bir kez geri okur ("58 kilo, doğru mu?"). Kullanıcı teyit ederse confidence: "high", etmezse "low". Kullanıcı bir cevabı sorulmadan söylerse ("Bugün tartıldım, 58 geldi") Damla onu ilgili alana yazar, teyit eder ve soruyu tekrar sormaz. Kullanıcı cevap vermek istemezse Damla ısrar etmez.
Sorulamayan konular#
Aşağıdaki konulardaki alanlar istek anında reddedilir (400 Bad Request: CALL_FIELD_FORBIDDEN: <key>); Damla bu soruları görüşmede de sormaz. Para, kart, şifre ya da kod konusunu kullanıcı kendisi açsa bile Damla telefonda konuşmaz:
- parola, PIN, doğrulama kodu;
- kart, IBAN, hesap numarası, ödeme;
- T.C. kimlik ya da pasaport numarası;
- adres ve konum;
- başka kişilerin bilgileri;
- özel nitelikli kişisel veriler: sağlık teşhisi, din, siyasi görüş, cinsel yaşam, sendika üyeliği, ceza mahkûmiyeti.
Kilo, ölçü gibi sayısal beyanlar sorulabilir, ama sağlık verisidir. Böyle bir alanı "sensitive": "health" ile işaretle ve istekte "health_consent": true gönder; sensitive: "health" işaretli alanda health_consent: true yoksa istek 400 Bad Request: CALL_FIELD_FORBIDDEN: <key> döner. İşaretlemek senin yükümlülüğündür: inkiveta işaretsiz alanı reddetmez, ama sağlık verisini işaretsiz ve rızasız toplamak geliştirici şartlarına aykırıdır. Bu veriyi toplamak için kullanıcının ayrıca açık rızası olmalı ve aydınlatma metnin bunu anlatmalı; bu senin sorumluluğundadır ve health_consent bu rızanın sende kayıtlı olduğu beyanıdır. inkiveta burada yalnız taşıyıcıdır: değeri saklamaz, kullanıcıya cevabının sana iletileceğini aramanın başında söyler. Rızası olmayan kullanıcıya bu alanı sorma; isteği gönderirken alanı çıkar.
Neyi iletir, neyi iletmez#
Gerçek bir görüşmede kullanıcı soruların dışına çıkar: hal hatır sorar, bir şey ister, şikâyet eder, alakasız bir şey anlatır. Damla aracıdır; kullanıcının söylediği her şey (sır değerleri hariç) not olarak sana iletilir ve bu verinin veri sorumlusu sensin. Damla süzmez, yorum katmaz ve "ileteyim mi?" diye sormaz; kullanıcı bunu açılışta duyar ("söylediklerini … ileteceğim"). Sana alan cevapları, notlar ve kısa bir özet gelir; konuşmanın dökümü gelmez.
| Kullanıcı ne der? | Damla ne yapar? | Sana ne gelir? |
|---|---|---|
| Sorulara cevap verir | cevabı alana yazar, sayı/tarihi teyit eder | fields[] içinde tipli değer |
| "Bunu söylemek istemiyorum" | ısrar etmez, geçer | alan refused |
| "Beni bir daha arama" | izni kapatır, teyit eder | opted_out: true ve inki_call_access {allowed:false} |
| Acil bir durumdan ya da kendine zarar vermekten söz eder | 112/183'e yönlendirir, aramayı sürdürmez | urgent: true, ayrıntı yok |
| "Şimdi müsait değilim, akşam ara" | uygun zamanı sorar, teyit eder | reschedule: {at}. inkiveta yeniden aramaz; istersen yeni bir istek gönderirsin |
| "Sen kimsin, neden arıyorsun?" | kim olduğunu, kimin adına aradığını ve iznin nereden geldiğini söyler | — |
| Para, kart, şifre, kod konusu açar | "Bunu telefonda konuşamam, uygulamadan bakabilirsin" der | konuyla ilgili söylediği not olarak gelir; şifre, doğrulama kodu, kart numarası, CVV, IBAN, T.C. kimlik numarası gibi değerler iletilmez |
| İşletmeyle ilgili bir istek, soru, şikâyet ya da görüş bildirir | kısa karşılık verir, sormadan not alır | notes[] içinde ilgili türde bir not |
| Bilgi sorar ("Cumartesi açık mısınız?") | knowledge'da varsa cevaplar; yoksa uydurmaz | cevaplanamadıysa question notu |
| Sağlık, aile, din, siyaset gibi kişisel bir şey anlatır | kısa karşılık verir, sorulara döner | not olarak gelir (other ya da uyduğu tür) |
| Hal hatır, alakasız muhabbet, başka kişilerden söz | kısa ve sıcak karşılık verir, sorulara döner | not olarak gelir (other) |
Notlar#
Kabul ettiğin not türlerini accept_notes ile söylersin:
type | Örnek söz |
|---|---|
request | "Üyeliğimi bir hafta dondurun" |
question | "Cumartesi kaçta açıksınız?" (Damla cevabı bilmiyorsa) |
complaint | "Geçen hafta siparişim geç geldi" |
feedback | "Grup dersleri çok iyi" |
human_contact | "Yetkiliyle konuşmak istiyorum" |
other | yukarıdakilere uymayan her söz: "Bu hafta annem hastaydı", "Hava çok güzel" |
- Not biçimi
{type, text, at?}.text, kullanıcının söylediğinin yorumsuz kısa aktarımıdır (≤ 140 karakter, kullanıcının dilinde); kullanıcının adı yerine "kullanıcı" yazılır. Konu süzgeci yoktur: sağlık, aile gibi kişisel bilgiler de gelir; bu veriyi işlerken veri sorumlusu olarak yükümlülükler sende.at, yalnız zaman içeren taleplerde ISO 8601 tarih/saattir. - Bir aramada en çok 3 not gelir (Damla önce istek, şikâyet ve soruları yazar); fazlası "kullanıcının başka talepleri de var" tek notunda birleşir.
accept_notesileother'ı istemezsen yalnız seçtiğin türler gelir; kabul etmediğin türde Damla söz vermez: "Bunu bu aramadan iletemiyorum; uygulamanın sohbetinden yazabilirsin."- Sır değeri (şifre, doğrulama kodu, kart numarası, CVV, IBAN, T.C. kimlik numarası) içeren not dolandırıcılık riskine karşı iletilmez, yerine
{"type":"request","text":null,"dropped":true}gelir: bir şey söylendiğini ama iletilemediğini bilirsin. Özet de aynı denetimden geçer.
Damla'nın bildikleri#
Kullanıcı görüşmede soru sorabilir. Cevaplayabilmesi için Damla'ya kısa bilgi verirsin:
json"knowledge": [
{"q": "Cumartesi açık mısınız?", "a": "Cumartesi 09.00 ile 14.00 arası açığız."},
{"q": "Siparişimi değiştirebilir miyim?", "a": "Değişiklik ve iptal için uygulamanın sohbetinden yazman yeterli."}
]
- En çok 8 çift; her cevap ≤ 200, toplam ≤ 1.200 karakter. Metinler içerik denetiminden geçer; fiyat, kampanya ya da sağlık iddiası içeren cevaplar reddedilebilir (
CALL_CONTENT_REJECTED). - Damla yalnız bu bilgiden cevap verir. Bilmediğini uydurmaz; kullanıcıya soruyu sana iletmeyi önerir (
questionnotu).
Sonuç: inki_damla_call_result#
Arama bitince gelir; allowed_updates listesine inki_damla_call_result eklemelisin (Güncellemeleri almak). Bir isteği inkiCancelDamlaCall ile iptal ettiysen o istek için update gelmez.
| Alan | Anlamı |
|---|---|
call_request_id | isteğin kimliği. İşleyicini bununla tekilleştir: aynı update iki kez gelebilir |
from | kullanıcı (adı yalnız görünen ad izniyle gelir) |
outcome | answered (açtı) · no_answer · busy · declined (zili reddetti) · opted_out (açtı, "beni arama" dedi) · failed (arama kurulamadı, teknik olarak koptu ya da pencere içinde aranamadı) |
call_status | yalnız açılan aramada (answered, opted_out): completed · unclear · declined (kullanıcı görüşmede konuşmak istemedi; zil reddi outcome: "declined"'dır) |
connected_seconds, billed_minutes, amount, unit_price, currency | ücret; açılmayan aramada 0 |
fields | istediğin her alan, senin sıranla, tam bir kez |
notes | kullanıcının soru dışı söyledikleri (sır değerleri hariç) |
summary | en çok 280 karakter: yalnız alanlar, arama sonucu ve "N not iletildi". Kullanıcının adı geçmez. Denetime takılırsa ya da açılmayan aramada alan hiç gelmez; alanlar yine gelir |
reschedule | {at}: kullanıcı başka bir zaman istedi (yoksa alan gelmez) |
opted_out, urgent | true / false |
lang | görüşme dili; notes[].text ve summary bu dildedir |
date | Unix zamanı |
Her alanın status'u:
status | Anlamı | value |
|---|---|---|
answered | cevap alındı ve tipe uygun | var |
refused | kullanıcı söylemek istemedi | yok |
unclear | soruldu ama değer çıkarılamadı ya da doğrulanamadı | yok |
not_asked | süre bitti, kullanıcı kapattı ya da sıra gelmedi | yok |
Dikkat: Ücreti
outcome'dan çıkarma; her zamanamountvebilled_minutes'a bak. Ücret, aramanın açılıp açılmadığına bağlıdır:opted_outaçılmış bir aramadır ve ücretlenir; bizim tarafımızdaki kısa bir kopuşansweredolsa da ücretsizdir.no_answer,busy,declinedvefailedher zaman ücretsizdir.
Değerler saklanmaz. inkiveta alan cevaplarını, notları ve özeti saklamaz: yalnız sana teslim edilene kadar kuyrukta durur, teslim edilemezse 24 saat sonra silinir. inkiGetDamlaCall yalnız sonuç kodunu ve ücreti döner. Update'i aldığın an kendi sisteminde kaydet.
python# python-telegram-bot — allowed_updates: [..., "inki_damla_call_result", "inki_call_access"]
from telegram.ext import TypeHandler
async def damla(update, context):
s = update.api_kwargs.get("inki_damla_call_result")
if not s or zaten_islendi(s["call_request_id"]):
return
for alan in s["fields"]:
if alan["status"] == "answered":
kaydet(s["from"]["id"], alan["key"], alan["value"], alan.get("confidence"))
for n in s.get("notes", []):
sahibe_ilet(n) # n.get("dropped") → "iletilemeyen bir not vardı"
if s.get("reschedule"):
yeniden_planla(s["from"]["id"], s["reschedule"]["at"])
islendi_isaretle(s["call_request_id"])
app.add_handler(TypeHandler(Update, damla))
Kullanıcı da kendi tarafında görür: sohbetinde "📞 Damla, <Uygulama> adına seni aradı (2 dk)" mesajı ve "Bu aramayı bildir" seçeneği, arama geçmişinde "Damla · <Uygulama> adına".
Örnek: birkaç gündür gelmeyen üye#
Bir spor kulübü uygulaması, üç gündür gelmeyen ve kilo takibine açık rıza vermiş üyesini aratıyor (üyelik takibi: aynı üyeye 3 günde en çok bir kez):
bashcurl -s "https://app.inkiveta.com/bot$BOT_TOKEN/inkiDamlaCall" -H 'Content-Type: application/json' -d '{
"user_id": 4185489292941965,
"purpose_declaration": "membership_followup",
"service_only": true,
"health_consent": true,
"template": "visit_reminder",
"params": {"place_name": "Sahil Kulübü", "days_absent": 3},
"fields": [
{"key": "tartildi", "question": "Bugün tartıldın mı?", "type": "yes_no", "required": true},
{"key": "kilo", "question": "Kaç kilo geldin?", "type": "number", "unit": "kg", "min": 30, "max": 250, "decimals": 1, "sensitive": "health"},
{"key": "gelis", "question": "Kulübe ne zaman uğrarsın?", "type": "date", "range_days": [0, 14], "required": true}
],
"knowledge": [{"q": "Cumartesi açık mısınız?", "a": "Cumartesi 09.00 ile 14.00 arası açığız."}],
"accept_notes": ["request", "question", "human_contact"],
"max_duration": 120,
"idempotency_key": "gelmeyen:2026-11-14:uye-812"
}'
Damla: "Merhaba, Ayşe ile mi görüşüyorum? Ben Damla, Kulüp uygulamasından Sahil Kulübü adına arıyorum; yapay zekâ asistanıyım. Üç gündür seni göremedik, merak ettik. Birkaç kısa soru soracağım; söylediklerini Sahil Kulübü'ne ileteceğim, istemediğin soruyu geçebiliriz."
Üye tartıldığını, 58 kilo geldiğini ve yarın uğrayacağını söylüyor. Arada "kızım da gelmek istiyor ama okulu var" diyor: istekteki accept_notes other'ı içermediği için bu sana gelmez (accept_notes verilmeseydi other notu olarak gelirdi). Sonra "üyeliğimi bir hafta dondurun" diyor; Damla sormadan not alıyor:
json{"update_id":9001,"inki_damla_call_result":{
"call_request_id":"dc_01JD8Q…","from":{"id":4185489292941965,"is_bot":false,"first_name":"Ayşe"},
"outcome":"answered","call_status":"completed",
"connected_seconds":74,"billed_minutes":2,"amount":1000,"unit_price":500,"currency":"TRY",
"fields":[
{"key":"tartildi","status":"answered","value":true,"confidence":"high"},
{"key":"kilo","status":"answered","value":58.0,"confidence":"high"},
{"key":"gelis","status":"answered","value":"2026-11-15","confidence":"high"}
],
"notes":[{"type":"request","text":"Üyeliğini gelecek hafta için bir hafta dondurmak istiyor."}],
"summary":"Kullanıcı bugün tartıldığını ve yarın kulübe geleceğini söyledi; 1 not iletildi.",
"lang":"tr","opted_out":false,"urgent":false,"date":1794657600}}
74 saniye → 2 başlayan dakika → 10,00 TL. Ayrılan 10 TL'nin tamamı kullanıldı. Üye açmasaydı: "outcome":"no_answer", her alan not_asked, "amount":0 ve ayrılan 10 TL geri dönerdi.
Örnek: sipariş teslimatını teyit etmek#
Bir market uygulaması, yarınki teslimatın saatini teyit ediyor. Hazır şablonlardan hiçbiri uymadığı için general kullanıyor:
bashcurl -s "https://app.inkiveta.com/bot$BOT_TOKEN/inkiDamlaCall" -H 'Content-Type: application/json' -d '{
"user_id": 7731020045117730,
"purpose_declaration": "delivery",
"service_only": true,
"template": "general",
"params": {"purpose": "Yarınki teslimatının saatini teyit etmek için arıyorum", "place_name": "Mahalle Market"},
"fields": [
{"key": "saat_uygun", "question": "Yarın 14.00 ile 16.00 arası teslimat sana uygun mu?", "type": "yes_no", "required": true},
{"key": "uygun_gun", "question": "Teslimat için sana en uygun gün hangisi?", "type": "date", "range_days": [1, 7]},
{"key": "teslim_sekli", "question": "Kapıya mı bırakalım, yoksa mağazadan mı alırsın?", "type": "choice",
"options": [{"id": "kapiya", "label": "Kapıya bırakılsın"}, {"id": "magazadan", "label": "Mağazadan alırım"}]}
],
"knowledge": [
{"q": "Teslimatı kim getiriyor?", "a": "Siparişini kendi kuryemiz getirir; kurye yola çıkınca uygulamadan haber veririz."},
{"q": "Siparişimi değiştirebilir miyim?", "a": "Değişiklik ve iptal için uygulamanın sohbetinden yazman yeterli."}
],
"accept_notes": ["request", "question", "complaint", "human_contact"],
"max_duration": 60,
"not_after": 1794686400,
"idempotency_key": "teslim-teyit:siparis-8f3a2c"
}'
# {"ok":true,"result":{"call_request_id":"dc_01JD9C…","status":"queued","reserved_amount":500,"unit_price":500,"currency":"TRY","balance":11500}}
Adres ve ödeme sorulmaz (yasak konular); sipariş numarası soruya yazılmaz (uzun rakam dizisi). Siparişi idempotency_key ve call_request_id ile kendi tarafında eşlersin. Teslimat amacındaki aramalar 21:00'e kadar yapılabilir.
json{"update_id":9188,"inki_damla_call_result":{
"call_request_id":"dc_01JD9C…","from":{"id":7731020045117730,"is_bot":false,"first_name":"Kullanıcı"},
"outcome":"answered","call_status":"completed",
"connected_seconds":48,"billed_minutes":1,"amount":500,"unit_price":500,"currency":"TRY",
"fields":[
{"key":"saat_uygun","status":"answered","value":false,"confidence":"high"},
{"key":"uygun_gun","status":"answered","value":"2026-11-17","confidence":"high"},
{"key":"teslim_sekli","status":"answered","value":"kapiya"}
],
"notes":[{"type":"request","text":"Teslimatta zile basılmamasını, kapıya bırakılmasını istiyor."}],
"summary":"Kullanıcı yarınki saate uygun değil; teslimatın 17 Kasım'da kapıya bırakılmasını istiyor; 1 not iletildi.",
"lang":"tr","opted_out":false,"urgent":false,"date":1794661200}}
48 saniye → 1 dakika → 5,00 TL. Kullanıcı "şu an araba kullanıyorum, akşam ara" deseydi alanlar not_asked gelir, "reschedule":{"at":"2026-11-14T19:00:00+03:00"} eklenirdi; yeni bir istek göndermek senin kararındır.
Diğer yöntemler#
| Yöntem | Parametreler | Döner |
|---|---|---|
inkiCancelDamlaCall | call_request_id | true. Yalnız henüz aranmamış istek iptal edilir, ayrılan bakiye tamamen geri döner. Zil çalmaya başladıysa 400 Bad Request: CALL_ALREADY_STARTED |
inkiGetDamlaCall | call_request_id | status (queued · calling · finished · cancelled · expired), outcome, call_status, süre, ücretli dakika, tutar, birim fiyat. Alan değerleri, notlar ve özet dönmez |
inkiGetDamlaCallBalance | — | balance, reserved, available, unit_price, currency, billing_unit |
inkiGetDamlaCallTransactions | offset (≤ 5.000), limit (1–100) | döküm kalemleri: {id, date, type, amount, call_request_id?, user?, billed_minutes?, connected_seconds?, unit_price?, outcome?}; type = topup (yükleme) · call (kesinleşmiş arama; açılmayanda amount: 0) · refund (iade) · withdraw (geri çekme) |
inkiRequestCallAccess | user_id | {"status":"sent"} ya da {"status":"already_allowed"} |
expired: istek, pencere (not_after) içinde aranamadı; sonuç outcome: "failed" ve ücret 0 olarak gelir.
Sınırlar#
| Sınır | Değer |
|---|---|
| Aynı uygulama → aynı kullanıcı | günde 1, 7 günde 3 arama (açılan ve açılmayan sayılır) |
| Bütün uygulamalardan → aynı kullanıcı | günde 2 arama |
| Uygulama başına | günde 200 arama (doğrulanmış uygulamada 1.000) |
| Uygulama başına aynı anda | 10 arama; fazlası sırada bekler |
| Arama saatleri | kullanıcının saatiyle 09:00–20:00 (teslimat amacında 21:00'e kadar); pazar ve resmî tatillerde arama yapılmaz |
Üyelik takibi (membership_followup) | aynı kullanıcıya 3 günde en çok 1 |
Pazarlama (marketing) | aynı kullanıcıya 7 günde en çok 1 |
| Cevapsız arama sonrası | kullanıcı açmadıysa 24 saat aynı kullanıcı yeniden aratılamaz |
| Arama penceresi | istekten en çok 72 saat sonrası |
| Görüşme süresi | 30–180 sn |
| Alan · bilgi · not | 6 alan (600 karakter) · 8 bilgi çifti (1.200 karakter) · 3 not |
| Reddedilen izni yeniden sorma | 30 gün sonra |
- Sınıra takılan istek hiçbir şey ayırmaz ve
429 Too Many Requests: retry after Ndöner; N, sınırın açılmasına kalan saniyedir. İptal ettiğin istekler sayılmaz. - Gerçek ortamda kendini ya da ekibini aratamazsın.
- Arama zamanı geldiğinde izin, engel ve arama saati yeniden denetlenir; o arada izin kapandıysa arama yapılmaz, sonuç
failedve ücret 0 olur. Kullanıcı o an başka bir aramadaysa Damla 5 dakika arayla en çok 3 kez yeniden dener; olmazsa sonuçbusy, ücret 0. - 30 gün içinde birden çok kullanıcı ("Bu aramayı bildir" ile) aramalarını şikâyet ederse uygulamanın Damla araması askıya alınır: yeni istekler
403 Forbidden: CALL_SUSPENDEDdöner, kuyruktaki aramalar ücretsizfailedolur. Askıyı yalnız inkiveta kaldırır; destekle iletişime geç.
Test ortamında (Test ortamı) aramalar yalnız test kullanıcılarına (sen ve ekibin dahil) gider; bakiyeyi Atölye → Test'ten "test bakiyesi ekle" ile yüklersin, gerçek para kullanılmaz. Aramalar gerçek Damla aramasıdır; bu yüzden test ortamında uygulama başına günde en çok 20 arama yapılır.
Hatalar#
| Yanıt | Ne zaman | Ne yapmalı |
|---|---|---|
403 Forbidden: CALL_NOT_ALLOWED | izin yok, kullanıcı Damla aramalarını kapatmış, engel var ya da "beni arama" demiş; pazarlama aramasında İYS onayı yok. Neden bilerek ayrılmaz | kullanıcıyı arama; izni bir kez iste |
400 Bad Request: CALL_PURPOSE_REQUIRED | amaç beyanı (purpose_declaration) yok ya da geçersiz, veya service_only: true (pazarlamada marketing: true) gönderilmedi | amacı beyan et (Hizmet aramaları) |
403 Forbidden: CALL_SUSPENDED | uygulamanın Damla araması şikâyetler nedeniyle askıda | destekle iletişime geç |
403 Forbidden: CALL_ACCESS_RECENTLY_DECLINED | izni yakın zamanda reddetti ya da kapattı | 30 gün bekle; "beni arama" dediyse bir daha isteme |
403 Forbidden: bot can't initiate conversation with a user | kullanıcı uygulamanı başlatmamış | — |
403 Forbidden: bot was blocked by the user | kullanıcı uygulamanı engellemiş | — |
402 Payment Required: CALL_BALANCE_INSUFFICIENT | kullanılabilir bakiye ayrılacak tutara yetmiyor | bakiye yükle ya da max_duration'ı düşür |
400 Bad Request: CALL_TEMPLATE_INVALID | bilinmeyen şablon | |
400 Bad Request: CALL_PARAM_INVALID: <ad> | şablon parametresi, health_consent, süre, pencere, knowledge, accept_notes ya da döküm offset/limit hatalı; not_after: pencere izinli arama saatleriyle kesişmiyor | adı geçen parametreyi düzelt |
400 Bad Request: CALL_FIELD_INVALID: <key> | alan tanımı kurala uymuyor | |
400 Bad Request: CALL_FIELD_FORBIDDEN: <key> | alan sorulamayan bir konuda, ya da sensitive: "health" alan var ama health_consent: true yok | alanı kaldır ya da rızayı beyan et |
400 Bad Request: CALL_CONTENT_REJECTED | bir metin içerik denetimine takıldı; hizmet aramasında tanıtım dili (fiyat, indirim, kampanya, satın alma çağrısı) | metni sadeleştir; iddia, fiyat ve kampanya içermesin |
400 Bad Request: IDEMPOTENCY_KEY_INVALID / IDEMPOTENCY_KEY_REUSED | anahtar yok ya da bozuk / aynı anahtar farklı parametreyle | |
400 Bad Request: USER_ID_INVALID | kullanıcı çözülemedi | |
400 Bad Request: CALL_USER_UNSUPPORTED | kullanıcının uygulaması aramayı desteklemeyen eski bir sürüm | kullanıcı güncelleyince yeniden dene |
400 Bad Request: can't call the bot owner or team | gerçek ortamda kendini ya da ekibini aratmaya çalıştın | test ortamını kullan |
400 Bad Request: CALL_ALREADY_STARTED | iptal etmek istediğin arama başlamış | |
400 Bad Request: CALL_REQUEST_NOT_FOUND | bilinmeyen call_request_id | |
400 Bad Request: damla calls are not enabled | Damla aramaları şu an kapalı | daha sonra yeniden dene |
403 Forbidden: bot is suspended | uygulaman askıda | |
429 Too Many Requests: retry after N | kullanıcı ya da uygulama sınırı | N saniye sonra |
503 Service Unavailable: retry after N | ses servisi geçici olarak kapalı (bakiye ayrılmaz) | N saniye sonra |
Hizmet aramaları: kurallar#
Damla aramaları varsayılan olarak hizmet bildirimidir: kullanıcıyla aranızdaki mevcut hizmet ilişkisine dair hatırlatma, teyit ve kısa bilgi toplama. Bu aramalar ticari elektronik ileti onayı gerektirmez (Ticari İletişim ve Ticari Elektronik İletiler Hakkında Yönetmelik md.6/1-2 ve md.6/5; 6563 sayılı Kanun). Bunun karşılığında aşağıdaki kurallar platformda mekanik olarak uygulanır:
| Kural | Nasıl uygulanır |
|---|---|
Amaç beyanı. Her istekte purpose_declaration ve hizmet aramasında service_only: true | eksikse 400 CALL_PURPOSE_REQUIRED; beyan aramanın kaydına yazılır |
| Tanıtım yasağı. Hizmet aramasında ürün, fiyat, indirim, kampanya, paket önerisi, "yenile/satın al" çağrısı yok | istekteki metinler denetlenir (400 CALL_CONTENT_REJECTED); Damla görüşmede de tanıtım yapmaz. Kullanıcı satın almak isterse Damla satış yapmaz, onayıyla request notu alır |
Yenileme hatırlatması yalnız bilgi verir. renewal_reminder üyeliğin bitiş tarihini söyler | teklif, fiyat, ödeme konuşulmaz |
| Açılış anonsu. Damla işletme adını, yapay zekâ asistanı olduğunu, aramanın amacını ve cevapların işletmeye iletileceğini söyler | platform metni; değiştirilemez |
| Saat. Kullanıcının saatiyle 09:00–20:00 (teslimat 21:00); pazar ve resmî tatil yok | istek anında ve arama anında |
| Sıklık. Üyelik takibi 3 günde 1; cevapsız aramadan sonra 24 saat yeniden arama yok; genel sınırlar | 429 Too Many Requests |
Sağlık verisi. Sağlıkla ilişkili alan sensitive: "health" + health_consent: true ister | yoksa 400 CALL_FIELD_FORBIDDEN |
| Kayıtlar. Amaç beyanı, sağlık rızası beyanı, izin kararları ve İYS sorguları | inkiveta'da 3 yıl saklanır |
Kampanya duyurusu, satış ya da yeniden satın almaya yönlendirme içeren her arama pazarlama aramasıdır (aşağıda). Borç ya da ödeme tahsili için Damla araması hiçbir durumda yapılmaz. inkiveta Damla'yı kendi ürünlerinin pazarlaması için kullanmaz.
Pazarlama aramaları ve İYS#
Damla aramaları iki türdür:
- Hizmet araması: kullanıcıyla aranızdaki mevcut hizmete dair hatırlatma, teyit ve kısa bilgi toplama (randevu, teslimat, üyelik durumu). Ticari elektronik ileti onayı gerektirmez.
- Pazarlama araması: ürün ya da hizmetini tanıtan, kampanya duyuran ya da satışa yönelik arama. Ticari elektronik iletidir; İleti Yönetim Sistemi (İYS) kurallarına tabidir. İstekte amacı
purpose_declaration: "marketing"olarak beyan edersin.
Pazarlama araması yapabilmek için:
- İşletmen İYS'ye kayıtlı olmalı. Atölye → İYS bölümüne işletmenin İYS numarasını ve aramanın yapılacağı marka kodunu gir.
- inkiveta'yı İYS'de yetkilendir. İYS'de bu marka için inkiveta'yı iş ortağı (entegratör) olarak, ARAMA izinlerini okuma yetkisiyle ekle. Ardından Atölye'de "Doğrula"ya bas. Botunun inkiveta'da doğrulanmış olması gerekir.
- Onayı sen al. Alıcının ARAMA kanalındaki onayını kendi kanalların üzerinden alır ve İYS'ye sen (ya da entegratörün) kaydedersin. inkiveta senin adına onay toplamaz. inkiveta'daki arama izni ile İYS onayı birbirinin yerine geçmez; pazarlama araması için ikisi birlikte gerekir.
inkiveta her pazarlama aramasından önce, arama anında alıcının İYS'deki ARAMA onayını sorgular. Onay yoksa, ret varsa ya da İYS'ye ulaşılamazsa arama başlatılmaz ve sonuç failed olur, ücret alınmaz. Sorgu istek anında da yapılır; kapı geçilmezse 403 CALL_NOT_ALLOWED döner; nedeni sana söylenmez.
Pazarlama aramasında Damla açılışta "Tanıtım ve kampanya amaçlı arıyorum" der; ürün ya da kampanya anlatabilir, ama telefonda sözleşme kurmaz, sipariş ya da ödeme almaz: satın almak isteyen kullanıcıyı uygulamana yönlendirir ve isteğini not olarak iletir. Aynı kullanıcıya 7 günde en çok bir pazarlama araması yapılır; arama saatleri ve diğer sınırlar aynen geçerlidir.
Ret: inki_marketing_optout#
Kullanıcı pazarlama aramasında "beni arama" dediğinde, arama iznini kapattığında ya da botunu engellediğinde sana inki_marketing_optout gelir. Bu update allowed_updates ayarından bağımsız olarak her zaman teslim edilir.
json{"update_id": 81234567, "inki_marketing_optout": {
"from": {"id": 7412589630, "is_bot": false, "first_name": "Kullanıcı"},
"iys_type": "ARAMA", "source": "call",
"opted_out_at": 1763121600, "iys_deadline": 1763499599,
"iys_code": "123456", "brand_code": "654321", "platform_iys_report": true}}
| Alan | Anlamı |
|---|---|
source | call aramada sözlü ret · settings ayarlardan izin kapatma · card · mini_app · block engelleme |
opted_out_at | reddin inkiveta'ya ulaştığı an (unix) |
iys_deadline | reddi İYS'ye işlemen gereken son an: 3 iş günü sonra, Türkiye saatiyle günün sonu (unix) |
platform_iys_report | true ise inkiveta reddi İYS'ye kendisi de bildirmeyi dener; senin yükümlülüğün devam eder. inkiveta son tarihe 1 iş günü kala hâlâ bildiremediyse aynı ret (aynı opted_out_at) false ile ikinci kez gelir |
Bu update'i aldığında reddi iys_deadline'a kadar İYS'ye RET olarak işle ve kullanıcıyı pazarlama listelerinden çıkar. Reddi inkiveta da kaydeder: İYS'de bundan daha yeni bir onay görünmedikçe o kullanıcıya pazarlama araması yapılamaz.
Onay ve ret kayıtlarını 3 yıl saklarsın; ayrıntı Uygulama Geliştirici Şartları, "Damla aramaları" bölümü.
İyi uygulamalar#
- Önce izin, sonra arama. İzni kullanıcıya faydasını anlatan bir anda iste (ör. üyelik başlarken "gelmediğin günlerde seni arayıp hatırlatalım mı?").
CALL_NOT_ALLOWEDaldığında arka arkaya yeniden deneme; nedeni sana söylenmez. - Rızası olmayan kullanıcıya hassas soru sorma. Kilo, ölçü gibi sağlıkla ilişkili bir alanı yalnız o veri için açık rızası olan kullanıcıya sor; rıza yoksa alanı istekten çıkar. Rıza sonradan geri alındıysa gelen değeri yazma.
- Az ve net soru. 2–3 alan çoğu zaman yeter. Her soru tek başına anlaşılsın; zorunlu olanları
requiredyap. Uzun aramalar hem pahalı olur hem de sonlara doğru sorularnot_askedkalır. - **Kısa
max_duration.** Bir teyit için 60 saniye yeter: ayrılan bakiye de, olası ücret de düşer. - **
knowledgever.** Kullanıcının soracağı tahmin edilen 2–3 şeyi yaz; yoksa her soru not olarak sana döner. - Update'i hemen kaydet ve tekilleştir. Değerler sonradan alınamaz; aynı update iki kez gelebilir.
- **
confidence: "low"değerini doğrula.** Kritik bir kararı (ör. randevu iptali) düşük güvenli bir değere bağlama; kullanıcıya sohbetten teyit ettir. - **
unclearverefused'a saygı göster.** Aynı soruyu hemen yeniden aratma; sohbetten sormayı tercih et. - **
opted_outveurgent.**opted_outgelen kullanıcıyı listenden çıkar.urgentgelirse kullanıcıyı yeniden aratma; durumu bir insanın değerlendirmesi gerekebilir. Ayrıntı verilmez. - **
reschedulebir istektir, otomatik değildir.** Yeni arama açarsan sınırlar yine geçerlidir. - Notları bir insana göster.
requestvehuman_contactnotları bir yanıt bekler; kullanıcıya sohbetten dönüş yap. - Amacı doğru beyan et. Hatırlatma, teyit ve kısa bilgi toplama hizmet aramasıdır. Kampanya duyurusu ya da satış içeren her arama pazarlama aramasıdır ve İYS şartlarına tabidir; hizmet aramasının içine tanıtım ekleme. Borç ya da ödeme tahsili için Damla araması yapılmaz.
- Aydınlatma metnini güncelle. Damla aramasıyla hangi bilgileri topladığını ve ne için kullandığını yaz (Gizlilik).