Adj hozzá egy https-címet az Integrációk → Webhookok és értesítések alatt, hogy hívásesemények érkezzenek:
| Esemény | Mikor |
|---|---|
call.started | Az ügynök felvette |
call.ended | A hívás véget ért, az időtartammal és a kreditekkel |
call.analyzed | Az összefoglaló, az eredmény, a kinyert mezők és az átirat elkészült |
call.transcript | A hívás közben, az átirat új sorai néhány másodpercenként |
call.tool_called | Az ügynök meghívta az egyik függvényedet: name, arguments, status, durationMs |
call.handed_off | A hívást átadták egy másik ügynöknek: fromAgentId, toAgentId |
call.transferred | A hívást átkapcsolták egy személyhez: destination |
call.voicemail | Egy kimenő hívás hangpostára jutott |
call.do_not_call | A kimenő hívás személye azt kérte, hogy ne hívják újra: phone |
call.recording_ready | A kétcsatornás felvétel el van mentve: recordingUrl (24 óráig érvényes), durationMs |
call.message_sent | Az ügynök kártyákat mutatott egy webes vagy alkalmazásból hívó képernyőjén: items, quickReplies |
alert.triggered | Az egyik riasztásod (Webhookok és értesítések → Riasztások) átlépte a küszöbét |
alert.resolved | Az a riasztás visszatért a normális állapotba |
A hívás közben küldött események data.call mezőt hordoznak (id, agentId, channel, direction, számok). Minden kérés alá van írva:
EvaSay-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>">
EvaSay-Delivery: <delivery id>
Ellenőrizd az aláírást a webhook létrehozásakor megjelenített webhook-titokkal, és válaszolj 2xx állapottal. A sikertelen kézbesítéseket 1 perc, 5 perc, 30 perc, 2 óra és 12 óra múlva újrapróbálja ugyanazzal a törzzsel és ugyanazzal az EvaSay-Delivery azonosítóval, így az ismétlődéseket figyelmen kívül hagyhatod. Egy webhook legutóbbi kézbesítéseit, a pontosan elküldött törzzsel és a végpontod által adott állapottal, a GET /webhooks/{id}/deliveries és a vezérlőpult listázza; a POST /webhooks/{id}/deliveries/{delivery_id} újra elküld egyet.
Az e-mail és az alert.triggered / alert.resolved webhookok mellett a riasztások mehetnek egy Slack-csatornára (incoming webhook), egy WeCom csoportrobotnak vagy Telegramra a Webhookok és értesítések → Riasztások → Küldés ide is alatt.
Hozz létre egy webhookot a POST /webhooks hívással és a { "url": "https://crm.example.com/evasay-events", "events": ["call.analyzed"] } tartalommal. A válasz tartalmazza a feliratkozást és egy generált aláírási titkot, amelyet csak a létrehozáskor ad vissza. Ellenőrizd az EvaSay-Signature értékét, deduplikáld az EvaSay-Delivery értékét, és frissítsd a CRM-edet. Az eseménywebhookok aszinkron értesítések; a hívás közbeni eszközök az eredményeket közvetlenül az ügynöknek adják vissza.