Arama olaylarını almak için Entegrasyonlar → Webhook'lar ve bildirimler altına bir https adresi ekleyin:
| Olay | Ne zaman |
|---|---|
call.started | Ajan açtı |
call.ended | Arama bitti; süresi ve kredileriyle |
call.analyzed | Özet, sonuç, çıkarılan alanlar ve döküm hazır |
call.transcript | Arama sırasında, dökümün yeni satırları birkaç saniyede bir |
call.tool_called | Ajan fonksiyonlarınızdan birini çağırdı: name, arguments, status, durationMs |
call.handed_off | Arama başka bir ajana devredildi: fromAgentId, toAgentId |
call.transferred | Arama bir kişiye aktarıldı: destination |
call.voicemail | Giden bir arama telesekretere ulaştı |
call.do_not_call | Giden aramadaki kişi bir daha aranmak istemediğini söyledi: phone |
call.recording_ready | İki kanallı kayıt saklandı: recordingUrl (24 saat geçerli), durationMs |
call.message_sent | Ajan, web veya uygulama arayanının ekranında kartlar gösterdi: items, quickReplies |
alert.triggered | Uyarılarınızdan biri (Webhook'lar ve bildirimler → Uyarılar) eşiğini aştı |
alert.resolved | O uyarı normale döndü |
Arama sırasında gönderilen olaylar data.call taşır (id, agentId, channel, direction, numaralar). Her istek imzalıdır:
EvaSay-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>">
EvaSay-Delivery: <delivery id>
İmzayı webhook'u oluştururken gösterilen webhook gizli anahtarıyla doğrulayın ve 2xx durumuyla yanıt verin. Başarısız teslimatlar aynı gövde ve aynı EvaSay-Delivery kimliğiyle 1 dakika, 5 dakika, 30 dakika, 2 saat ve 12 saat sonra yeniden denenir; böylece tekrarları yok sayabilirsiniz. Bir webhook'un son teslimatları, gönderilen tam gövde ve uç noktanızın verdiği durumla birlikte GET /webhooks/{id}/deliveries ve panel tarafından listelenir; POST /webhooks/{id}/deliveries/{delivery_id} birini yeniden gönderir.
E-postanın ve alert.triggered / alert.resolved webhook'larının yanı sıra uyarılar Webhook'lar ve bildirimler → Uyarılar → Şuraya da gönder altından bir Slack kanalına (incoming webhook), bir WeCom grup robotuna veya Telegram'a gidebilir.
POST /webhooks ile { "url": "https://crm.example.com/evasay-events", "events": ["call.analyzed"] } kullanarak bir webhook oluşturun. Yanıt, aboneliği ve yalnızca oluşturma sırasında döndürülen, üretilmiş bir imza gizli anahtarını içerir. EvaSay-Signature değerini doğrulayın, EvaSay-Delivery değerini tekilleştirin ve CRM'inizi güncelleyin. Olay webhook'ları eşzamansız bildirimlerdir; arama sırasındaki araçlar sonuçları doğrudan ajana döndürür.