Lägg till en https-adress under Integrationer → Webhooks och aviseringar för att ta emot samtalshändelser:
| Händelse | När |
|---|---|
call.started | Agenten svarade |
call.ended | Samtalet slutade, med längd och krediter |
call.analyzed | Sammanfattning, utfall, extraherade fält och utskrift är klara |
call.transcript | Under samtalet, de nya raderna i utskriften var några sekunder |
call.tool_called | Agenten anropade en av dina funktioner: name, arguments, status, durationMs |
call.handed_off | Samtalet lämnades över till en annan agent: fromAgentId, toAgentId |
call.transferred | Samtalet kopplades vidare till en person: destination |
call.voicemail | Ett utgående samtal nådde en röstbrevlåda |
call.do_not_call | Personen i ett utgående samtal bad att inte bli uppringd igen: phone |
call.recording_ready | Tvåkanalsinspelningen är sparad: recordingUrl (giltig i 24 timmar), durationMs |
call.message_sent | Agenten visade kort på en webb- eller appuppringares skärm: items, quickReplies |
alert.triggered | Ett av dina larm (Webhooks och aviseringar → Larm) passerade sitt tröskelvärde |
alert.resolved | Det larmet är tillbaka till normalt |
Händelser som skickas under ett samtal bär data.call (id, agentId, channel, direction, nummer). Varje anrop är signerat:
EvaSay-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>">
EvaSay-Delivery: <delivery id>
Verifiera signaturen med den webhook-hemlighet som visades när du skapade webhooken, och svara med en 2xx-status. Misslyckade leveranser försöks igen efter 1 minut, 5 minuter, 30 minuter, 2 timmar och 12 timmar med samma innehåll och samma EvaSay-Delivery-id, så du kan ignorera upprepningar. En webhooks senaste leveranser, med exakt skickat innehåll och den status din endpoint svarade, listas av GET /webhooks/{id}/deliveries och i panelen; POST /webhooks/{id}/deliveries/{delivery_id} skickar en igen.
Förutom e-post och webhooks alert.triggered / alert.resolved kan larm gå till en Slack-kanal (incoming webhook), en WeCom-grupprobot eller Telegram under Webhooks och aviseringar → Larm → Skicka även till.
Skapa en webhook via POST /webhooks med { "url": "https://crm.example.com/evasay-events", "events": ["call.analyzed"] }. Svaret innehåller prenumerationen och en genererad signeringshemlighet, som bara returneras vid skapandet. Verifiera EvaSay-Signature, avduplicera EvaSay-Delivery och uppdatera ditt CRM. Händelsewebhooks är asynkrona aviseringar; verktyg under samtal returnerar resultat direkt till agenten.