Tilføj en https-adresse under Integrationer → Webhooks og notifikationer for at modtage opkaldshændelser:
| Hændelse | Hvornår |
|---|---|
call.started | Agenten tog telefonen |
call.ended | Opkaldet sluttede, med varighed og kreditter |
call.analyzed | Resumé, resultat, udtrukne felter og udskrift er klar |
call.transcript | Under opkaldet, de nye linjer i udskriften hvert par sekunder |
call.tool_called | Agenten kaldte en af dine funktioner: name, arguments, status, durationMs |
call.handed_off | Opkaldet blev overdraget til en anden agent: fromAgentId, toAgentId |
call.transferred | Opkaldet blev stillet om til en person: destination |
call.voicemail | Et udgående opkald nåede en telefonsvarer |
call.do_not_call | Personen i et udgående opkald bad om ikke at blive ringet op igen: phone |
call.recording_ready | Optagelsen med to kanaler er gemt: recordingUrl (gyldig i 24 timer), durationMs |
call.message_sent | Agenten viste kort på en web- eller appopringers skærm: items, quickReplies |
alert.triggered | En af dine alarmer (Webhooks og notifikationer → Alarmer) overskred sin tærskel |
alert.resolved | Den alarm er tilbage til normal |
Hændelser, der sendes under et opkald, bærer data.call (id, agentId, channel, direction, numre). Hver anmodning er signeret:
EvaSay-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>">
EvaSay-Delivery: <delivery id>
Verificer signaturen med den webhook-hemmelighed, der blev vist, da du oprettede webhooken, og svar med en 2xx-status. Mislykkede leverancer forsøges igen efter 1 minut, 5 minutter, 30 minutter, 2 timer og 12 timer med samme indhold og samme EvaSay-Delivery-id, så du kan ignorere gentagelser. En webhooks seneste leverancer, med det præcist sendte indhold og den status, dit endpoint svarede, vises af GET /webhooks/{id}/deliveries og i dashboardet; POST /webhooks/{id}/deliveries/{delivery_id} sender én igen.
Ud over e-mail og webhooks alert.triggered / alert.resolved kan alarmer gå til en Slack-kanal (incoming webhook), en WeCom-grupperobot eller Telegram under Webhooks og notifikationer → Alarmer → Send også til.
Opret en webhook via POST /webhooks med { "url": "https://crm.example.com/evasay-events", "events": ["call.analyzed"] }. Svaret indeholder abonnementet og en genereret signeringshemmelighed, der kun returneres ved oprettelsen. Verificer EvaSay-Signature, afdubler EvaSay-Delivery, og opdater dit CRM. Hændelseswebhooks er asynkrone notifikationer; værktøjer under opkald returnerer resultater direkte til agenten.