Legg til en https-adresse under Integrasjoner → Webhooks og varsler for å motta samtalehendelser:
| Hendelse | Når |
|---|---|
call.started | Agenten tok telefonen |
call.ended | Samtalen ble avsluttet, med varighet og kreditter |
call.analyzed | Sammendrag, utfall, uttrukne felt og utskrift er klare |
call.transcript | Under samtalen, de nye linjene i utskriften hvert par sekunder |
call.tool_called | Agenten kalte en av funksjonene dine: name, arguments, status, durationMs |
call.handed_off | Samtalen ble overlatt til en annen agent: fromAgentId, toAgentId |
call.transferred | Samtalen ble koblet videre til en person: destination |
call.voicemail | En utgående samtale nådde en telefonsvarer |
call.do_not_call | Personen i en utgående samtale ba om ikke å bli oppringt igjen: phone |
call.recording_ready | Opptaket med to kanaler er lagret: recordingUrl (gyldig i 24 timer), durationMs |
call.message_sent | Agenten viste kort på skjermen til en nett- eller appinnringer: items, quickReplies |
alert.triggered | En av alarmene dine (Webhooks og varsler → Alarmer) passerte terskelen |
alert.resolved | Den alarmen er tilbake til normalt |
Hendelser som sendes under en samtale, bærer data.call (id, agentId, channel, direction, numre). Hver forespørsel er signert:
EvaSay-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>">
EvaSay-Delivery: <delivery id>
Verifiser signaturen med webhook-hemmeligheten som ble vist da du opprettet webhooken, og svar med en 2xx-status. Mislykkede leveringer prøves på nytt etter 1 minutt, 5 minutter, 30 minutter, 2 timer og 12 timer med samme innhold og samme EvaSay-Delivery-id, så du kan ignorere gjentakelser. En webhooks siste leveringer, med det nøyaktige innholdet som ble sendt og statusen endpointet ditt svarte med, listes av GET /webhooks/{id}/deliveries og i panelet; POST /webhooks/{id}/deliveries/{delivery_id} sender én på nytt.
I tillegg til e-post og webhookene alert.triggered / alert.resolved kan alarmer gå til en Slack-kanal (incoming webhook), en WeCom-gruppebot eller Telegram under Webhooks og varsler → Alarmer → Send også til.
Opprett en webhook via POST /webhooks med { "url": "https://crm.example.com/evasay-events", "events": ["call.analyzed"] }. Svaret inneholder abonnementet og en generert signeringshemmelighet, som bare returneres ved opprettelsen. Verifiser EvaSay-Signature, avduplisér EvaSay-Delivery, og oppdater CRM-et ditt. Hendelseswebhooks er asynkrone varsler; verktøy under samtaler returnerer resultater direkte til agenten.