Yerleşik araçlar

ThunderPhone yapay zeka ajanlarını aramaları sonlandırmaya, arayanları aktarmaya, tuş takımlarında gezinmeye, hatta beklemeye, bilgi aramaya, ses çalmaya ve e-posta göndermeye yönlendirin.

Yerleşik araçlar, kendi API'nizi bağlamadan ajanın yaygın çağrı işlemlerini gerçekleştirmesini sağlar. Çoğu otomatik olarak kullanılabilir; e-posta, sesler ve bilgi araması yalnızca ilgili ayarı veya kaynağı yapılandırdıktan sonra görünür. Ajana, isteminde her işlemi ne zaman kullanacağını belirtin.

end_call#

İstem modele bunu yapmasını söylediğinde mevcut çağrıyı sonlandırır. Varsayılan olarak kullanılabilir ve ajan ayarı yoktur.

Koşulu ve gerekli vedayı isteme yazın:

When the caller confirms they need nothing else, say goodbye and end the call.

Model tarafından sonlandırılan bir aramanın end_reason: "ai_hangup" değeri olur; buna arama süresi sınırı uyarısından sonra sonlanan aramalar da dahildir. Arama yalnızca süre sınırına önce ulaşılırsa max_duration ile, ön ödemeli bakiye tükendiğinde ise balance_exhausted ile sonlanır.

transfer_call#

Bir telefon arayanını model tarafından sağlanan sabit bir numaraya aktarır. Soğuk aktarım anında gerçekleşir. Kontrollü sıcak aktarım, tarafları bağlamadan önce hedefi özel olarak arar. Sıcak aktarım, giden çağrı yapabilen doğrulanmış içe aktarılmış bir VoIP numarası gerektirir.

Hedef numarayı ve kesin yönlendirme koşulunu isteme yazın:

If the caller asks for billing, transfer them to +15551234567.

Başarılı bir soğuk aktarımda end_reason: "ai_transfer" bulunur; tamamlanmış bir sıcak aktarımda end_reason: "ai_warm_transfer" bulunur. Başarısız bir sıcak aktarım denemesi kontrolü ajana geri verir; bu nedenle çağrının sonraki sonlanması, sonlandırma nedenini belirler. Telefon dışı oturumlarda ise aktarım isteği oturumu sonlandırır.

Kontrol paneli ve API kurulumu, yönlendirme, tarama, hata yönetimi, sınırlar ve test hakkında bilgi için Çağrıları aktarma bölümüne bakın.

send_keypad_input#

DTMF (telefon tuş takımı) rakamlarını 0–9, * ve # bir telefon hattına gönderir. Model bunu, arayanlardan tuşlara basmalarını isteyen otomatik menü olan IVR'de gezinmek için kullanır. Varsayılan olarak kullanılabilir ve ajan ayarı yoktur.

Modele hangi menülerde gezinebileceğini ve istenen değerlerin nereden geleceğini belirtin. Menü seçeneklerini tahmin etmesini istemeyin:

Follow the phone menu for account status. Press a key only after the menu
states what that key does. Enter the account number supplied by the caller.

Platform, desteklenmeyen karakterleri kaldırır ve geçerli rakamları sırayla gönderir. Geçerli rakam kalmazsa veya çağrı tuş takımı girdisi gönderemezse, ajanın durumu düzeltebilmesi için hata ajana döndürülür.

no_response#

Otomatik bir sistem hâlâ konuşurken veya dinlemeye devam etmesini istediğinde, ayrıca arayan kişi sesli düşünürken ("şey, bir bakayım") ya da başka biriyle konuşmak için döndüğünde ajanı sessiz tutar. Arayan kişi bir şey yaparken ajandan beklemesini istediğinde ("bir saniye", "bir bakayım", "bir saniye bekler misiniz?") ve yanıtlanacak başka bir şey söylemediğinde, ajan yalnızca "Elbette." der ("Acele etmeyin." demez) ve arayanın yeniden konuşmasını bekler. Hatta sessizlik sürerse ajanın sessizlik yoklamaları çalışmaya devam eder ve her zaman sesli olarak yapılır. Bu özellik, canlı bir kişinin selamlaması, bir soru veya gerçek bir bekletme sırası için değildir. Varsayılan olarak kullanılabilir ve ajana yönelik bir ayarı yoktur.

İsteminiz, arayan kişi biraz zaman istediğinde ajanın ne söyleyeceğini belirtiyorsa istem önceliklidir.

Genellikle yerleşik açıklama yeterlidir. IVR ağırlıklı çağrılarda, sınırı istemde pekiştirin:

Stay silent while a phone menu is still speaking. Answer a live person as soon
as they address you.

Bu işlem çağrıyı sonlandırmaz.

wait_on_hold#

Giden aramadaki ajanı, gerçek bir kişi dönene kadar sessiz bekletme durumuna alır. Model bunu yalnızca karşı taraf açıkça ajanın beklemeye alındığını söylediğinde kullanır. Giden aramalarda otomatik olarak kullanılabilir ve pano ayarı yoktur.

If a person explicitly puts you on hold, wait silently. When they return,
continue from the question you were discussing.

Ajanı, bir IVR'ın "lütfen bekleyin" mesajı için bunu kullanmaya yönlendirmeyin. Bekletme varsayılan olarak en fazla 15 dakika sürer. Normal giden aramalarda, POST /v1/call pozitif tamsayı olan max_hold_seconds değerini kabul eder; satır içi Realtime, max_hold_seconds değerini 10–900 saniye ile sınırlar. Kişi geri dönerse, ajan aramanın bitiş nedenini değiştirmeden devam eder. Sınır dolarsa platform aramayı end_reason: "ai_hangup" ile sonlandırır.

search_knowledge_base#

Ajana eklenmiş belgelerde arama yapar ve ilgili bölümleri döndürür. Etkinleştirmek için bir bilgi bankası veya ayrı bilgi belgelerini ekleyin; ardından modele hangi yanıtların bu kaynaklardan gelmesi gerektiğini söyleyin:

Search the knowledge base before answering policy questions. If the first
search is inconclusive, try once more with different key terms.

Arama başarısız olursa sonuç ajana döndürülür. Pano ve API kurulumu için Bilgi bankası bölümüne bakın.

play_sound#

Aynı turdaki herhangi bir konuşmadan sonra ajanın yapılandırılmış bildirim sesini çalır. Panoda Gelişmiş → Araç sesi ayarını Çan, Ding veya Bip olarak belirleyin, ardından ajanı yayınlayın. Yok aracı kaldırır.

Agents API ile play_sound_asset değerini "chime", "ding" veya "beep" olarak ayarlayın, ardından yayınlayın. Aracı devre dışı bırakmak için "" olarak ayarlayın.

After confirming that an appointment was saved, say "You're all set" and play
the notification sound.

Çalma hatası ajana döndürülür ve aramayı sonlandırmaz.

send_email#

Ajan sahibinin yapılandırdığı tek alıcıya düz metin e-posta gönderir. Model konuyu ve gövdeyi sağlar. Alıcı parametresini hiçbir zaman görmez ve adresi seçemez veya değiştiremez.

Panoda Gelişmiş → E-posta gönder seçeneğini etkinleştirin, bir alıcı adresi kaydedin, ardından ajanı yayınlayın. Agents API ile hem send_email_enabled: true hem de boş olmayan bir send_email_recipient değeri ayarlayın, ardından yayınlayın. Tetikleyiciyi ve gerekli içerikleri istemde tanımlayın:

When the caller asks to leave a message, collect their name, callback number,
and message. Read the details back for confirmation, then email them.

Bir arama en fazla üç e-posta göndermeyi deneyebilir. Her konu 300 karakterle, her gövde ise 20.000 karakterle sınırlıdır. Eksik yapılandırma, geçersiz içerik, arama başına sınır ve teslimat hataları ajana döndürülür. Başarısız bir teslimat yine de üç denemeden birini kullanır.

Geniş çapta yayınlamadan önce kontrollü bir alıcıyla test edin. Tarayıcı Talk ve simülasyonlar gerçek e-posta gönderir; deneme çalıştırması modu yoktur.

Uyumluluk notu#

Gelişmiş → Kesintiye uğratılamayan bilgilendirmeler ayarı ve eski speak_uninterruptible_enabled alanı uyumluluk için korunur, ancak bunları etkinleştirmenin etkisi yoktur. Ayarı kapalı bırakın; hiçbir istem bu aracı etkinleştiremez.

Zorunlu arama başlangıcı bilgilendirmesi için Onay duyurusu kullanın. Bu duyuru normal konuşmadan önce aynen oynatılır ve kesintiye uğratılamaz. Arama kaydı onay yasaları bölümüne bakın.

Yerleşik araçları test edin ve izleyin#

İstemleri, bilgi aramasını, sesleri ve e-postayı kontrol etmek için tarayıcı Talk veya simülasyon kullanın. Bu ortamlar telefon ağı davranışını yeniden üretemez. Tuş takımıyla gezinmeyi ve bekletmeyi giden bir telefon aramasında test edin; uygun içe aktarılmış bir VoIP numarası kullanarak gerçek bir aramada eksiksiz sıcak aktarımı test edin. Realtime desteği yukarıdaki tabloda gösterildiği şekilde sınırlıdır.

Aramalar, fiyatlandırma ve webhook'lar#

Yerleşik eylemler için kullanım başına araç ücreti alınmaz. Normal arama ve sağlayıcı ücretleri geçerliliğini korur; bkz. Fiyatlandırma. Aramaları ve sonuçları tamamlanan transkriptte görünebilir, ancak telephony.tool veya web.tool olaylarını tetiklemezler. Bu olaylar kullanıcı tanımlı işlevler içindir. Yalnızca tamamlanan bir arama sonlandırma veya aktarma, aramanın end_reason değerini değiştirir; diğer hatalar yapay zeka ajanına iletilir. Arama kaydı için Tamamlama webhook'ları bölümüne bakın.