mode="webhook" ayarındaki yayımlanabilir bir anahtarda başladığında ThunderPhone, eski webhook URL’nize bloklayıcı bir telephony.incoming / web.incoming isteği gönderir ve yapılandırma yanıtı için en fazla 10 saniye bekler. Her çağrı için istemi, sesi ve araçları dinamik olarak seçmek üzere bu alışverişi kullanın — uçtan uca akış için dinamik çağrı yapılandırma kılavuzuna bakın.
Abone olunan webhook uç noktaları da
telephony.incoming / web.incoming alır — yapılandırılmış ajanı
olsun ya da olmasın her gelen çağrı ve web oturumu için — ancak
bu teslimatlar event_id içeren, yanıt beklemeden gönderilen
bildirimlerdir; hiçbir zaman bloklayıcı değildir.
Bu sayfadaki yapılandırma alışverişini yalnızca eski tek URL’li
webhook taşır. Uç nokta bildirim biçimleri
olaylar kataloğunda yer alır.502/422 ile başarısız olur). Hızlı yanıt verin —
karar verirken arayan kişi çalma sesini duyar.
İstek yükü
Telefon çağrıları için (telephony.incoming):
Web bileşeni oturumlarında (
web.incoming) data, telefon numaraları
yerine yerleştirme sayfasını tanımlar:
Webhook modundaki bileşenler, ayarlanmışsa bu isteği yayımlanabilir
anahtarın kendi
webhook_url değerine gönderir; aksi durumda kuruluş
düzeyindeki webhook URL’sine geri döner. Her iki durumda da kuruluş
webhook secret değeriyle imzalanır.Yanıt şeması
Bu çağrı için ajan yapılandırmasını açıklayan bir JSON nesnesi döndürün.prompt ve voice zorunludur; diğer her şey isteğe bağlıdır.
Bilinmeyen üst düzey anahtarlar sessizce yoksayılır — yazım hatalı bir alan
adı yapılandırmayı reddetmez, yalnızca uygulanmaz. Konuşma sırası
ve
max_hold_seconds burada kabul edilmez; yalnızca Agent
üzerinde yapılandırılabilir.prompt ve voice zorunlu olduğundan, {} veya doğrulamayı geçemeyen herhangi bir
yanıt çağrıyı 422 ile reddeder — bu yolda statik ajan geri dönüşü yoktur (webhook modundaki
bir numaraya veya anahtara atanmış bir ajan bulunmaz).
Örnek işleyici
Fonksiyon araçlarıyla yanıt
Yapay zekanın görüşme sırasında API’lerinizi çağırabilmesi için araçlar ekleyin:Ürün katmanı hızlı başvuru tablosu
İlgili
telephony.complete / web.complete
Engellemeyen çağrı sonu olayı.
İşlev Araçları
tools[] için tam JSON şeması ve imzalı uç nokta sözleşmesi.Webhook uç noktaları
Birden fazla URL’yi
telephony.incoming / web.incoming için abone edin.Dinamik çağrı yapılandırması
Arayan bazlı istemler, araçlar ve A/B testleri için kalıplar.