Skip to main content
Bir gelen telefon çağrısı, atanmış bir ajanı olmayan bir numaraya ulaştığında veya bir web bileşeni oturumu 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.
Bloklayıcı alışverişin geri dönüşü yoktur: işleyiciniz 2xx olmayan bir durum döndürürse, zaman aşımına uğrarsa veya doğrulamayı geçemeyen bir yapılandırma döndürürse çağrı reddedilir (telefon çağrısı bağlanmaz; bileşen oturumu isteği 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:
Araç uç noktası istekleri, bu alışverişi imzalayan aynı kuruluş webhook gizli anahtarı ile imzalanır. Tam yapı ve imzalı istek biçimi için Fonksiyon Araçları sayfasına bakın.

Ü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.