Voeg een https-adres toe onder Integraties → Webhooks en meldingen om gespreksgebeurtenissen te ontvangen:
| Gebeurtenis | Wanneer |
|---|---|
call.started | De agent nam op |
call.ended | Het gesprek eindigde, met duur en credits |
call.analyzed | De samenvatting, uitkomst, geëxtraheerde velden en het transcript zijn klaar |
call.transcript | Tijdens het gesprek, om de paar seconden de nieuwe regels van het transcript |
call.tool_called | De agent riep een van je functies aan: name, arguments, status, durationMs |
call.handed_off | Het gesprek werd aan een andere agent overgedragen: fromAgentId, toAgentId |
call.transferred | Het gesprek werd doorverbonden naar een persoon: destination |
call.voicemail | Een uitgaand gesprek bereikte een voicemail |
call.do_not_call | De persoon in een uitgaand gesprek vroeg niet meer gebeld te worden: phone |
call.recording_ready | De opname met twee kanalen is opgeslagen: recordingUrl (24 uur geldig), durationMs |
call.message_sent | De agent toonde kaarten op het scherm van een web- of appbeller: items, quickReplies |
alert.triggered | Een van je alerts (Webhooks en meldingen → Alerts) overschreed zijn drempel |
alert.resolved | Die alert is weer normaal |
Gebeurtenissen die tijdens een gesprek worden verstuurd, bevatten data.call (id, agentId, channel, direction, nummers). Elk verzoek is ondertekend:
EvaSay-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>">
EvaSay-Delivery: <delivery id>
Controleer de handtekening met het webhookgeheim dat werd getoond toen je de webhook maakte, en antwoord met een 2xx-status. Mislukte bezorgingen worden na 1 minuut, 5 minuten, 30 minuten, 2 uur en 12 uur opnieuw geprobeerd met dezelfde inhoud en hetzelfde EvaSay-Delivery-id, zodat je herhalingen kunt negeren. De laatste bezorgingen van een webhook, met de exact verstuurde inhoud en de status die je endpoint antwoordde, worden getoond door GET /webhooks/{id}/deliveries en in het dashboard; POST /webhooks/{id}/deliveries/{delivery_id} verstuurt er een opnieuw.
Naast e-mail en de webhooks alert.triggered / alert.resolved kunnen alerts naar een Slack-kanaal (incoming webhook), een WeCom-groepsrobot of Telegram gaan onder Webhooks en meldingen → Alerts → Ook versturen naar.
Maak een webhook via POST /webhooks met { "url": "https://crm.example.com/evasay-events", "events": ["call.analyzed"] }. Het antwoord bevat het abonnement en een gegenereerd ondertekeningsgeheim, dat alleen bij het aanmaken wordt teruggegeven. Controleer EvaSay-Signature, dedupliceer EvaSay-Delivery en werk je CRM bij. Gebeurtenis-webhooks zijn asynchrone meldingen; tools tijdens een gesprek geven resultaten rechtstreeks aan de agent terug.