Webhook
ThinkVoice, belirli olaylar gerçekleştiğinde sisteminize otomatik HTTP POST isteği gönderir. Bu bölümde webhook olaylarına ait model örnekleri ve alan açıklamaları yer almaktadır.
Nasıl Çalışır
- Webhook adresi, özel header'lar ve (opsiyonel) kuyruk filtresi ThinkVoice yönetim paneli üzerinden, olay tipi (event type) bazında tanımlanır. Her olay tipi için tenant başına tek bir webhook tanımı bulunabilir.
- Bir çağrının analizi tamamlandığında sistem, ilgili tenant'ın o olay tipi için tanımlı aktif webhook adresine, tanımda kayıtlı özel header'larla birlikte tek bir JSON nesnesi (dizi değil) POST eder.
- Kuyruk filtresi tanımlanmışsa yalnızca o kuyruklara ait çağrılar için webhook tetiklenir; filtre boşsa tüm kuyruklar için tetiklenir.
- Teslimat başarısız olursa (timeout,
429veya5xx) sistem üstel bekleme ile en fazla 3 deneme yapar. 3 denemenin ardından da başarısız olursa webhook sessizce düşer — bu durum analiz sürecini asla bloklamaz veya başarısız kılmaz. - Aktif webhook tanımı olmayan bir tenant için herhangi bir teslimat denemesi yapılmaz.
Mevcut Olay Tipleri
| Değer | Ad | Açıklama |
|---|---|---|
| 1 | CompletedCallAnalysis | Tamamlanan Çağrı Analizi — bir çağrının analiz süreci tamamlandığında tetiklenir. |
Şu an sistemde tanımlı tek olay tipi Tamamlanan Çağrı Analizi'dir. Model örneği için Çağrı Analizi Tamamlandı Webhook Model Örneği sayfasına bakınız.