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.

Veyra Docs TeamGüncellendi 1 dk okumaSürüm 2 · Geçmiş

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:

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

GelenSesWebhook'lar