Ses webhook'ları
Bir agent'la telefon görüşmesi sırasında ses sağlayıcısından gelen çağrı olayları ve araç istekleri, nasıl doğrulandıkları ve limitleri.
Bir agent telefon görüşmesi kabul ettiğinde ses sağlayıcısı (Speko), her görüşme boyunca Veyra ile iki webhook üzerinden konuşur:
POST https://intelligence-api.veyra.so/api/voice-webhooks/{publicId}/events
POST https://intelligence-api.veyra.so/api/voice-webhooks/{publicId}/tools- events, görüşmenin yaşam döngüsünü bildirir: başladı, yanıtlandı, bitti.
- tools, ses oturumunun görüşme sırasında agent'ın araçlarına yaptığı istekleri taşır.
Doğrulama
Her geri çağrı, özgün baytları üzerinde sağlayıcının imzasıyla ve oturuma özgü bir yetkiyle doğrulanır. Bu denetimi hiçbir şey atlayamaz; oturum açmış bir kişi bile.
Yanıtlar ve limitler
| Durum | Anlamı |
|---|---|
200 |
İşlendi; JSON gövdesi sağlayıcıya verilen yanıttır. |
400 |
Geri çağrı hatalı biçimlenmiş. |
401 |
İmza geçersiz. |
403 |
Ses bağlantıları kapalı. |
413 |
Geri çağrının gövdesi çok büyük. |
429 |
Bir adresten dakikada 600'den fazla geri çağrı. |
Yanıtlar asla önbelleğe alınmaz (Cache-Control: no-store).
Görüşmeler ve görevler
Bir görüşme bir göreve bağlanır; böylece dökümü ve sonucu işle birlikte kalır. Doğrulanmış üye olmayan arayanlar yalnızca yapılandırdığınız kısıtlı misafir kabulüne ulaşabilir; özel işler kimliği doğrulanmış bir arayan gerektirir.
Ses kurulumu konsoldan yönetilir. Arkasındaki uç noktalar yalnızca oturum açılmış bir konsol oturumunda çalışır, bu yüzden anahtar tabanlı API referansının parçası değildir.