Lisää https-osoite kohdassa Integraatiot → Webhookit ja ilmoitukset saadaksesi puhelutapahtumia:
| Tapahtuma | Milloin |
|---|---|
call.started | Agentti vastasi |
call.ended | Puhelu päättyi, mukana kesto ja krediitit |
call.analyzed | Yhteenveto, lopputulos, poimitut kentät ja litteraatti ovat valmiit |
call.transcript | Puhelun aikana, litteraatin uudet rivit muutaman sekunnin välein |
call.tool_called | Agentti kutsui yhtä funktioistasi: name, arguments, status, durationMs |
call.handed_off | Puhelu luovutettiin toiselle agentille: fromAgentId, toAgentId |
call.transferred | Puhelu siirrettiin ihmiselle: destination |
call.voicemail | Lähtevä puhelu päätyi vastaajaan |
call.do_not_call | Lähtevän puhelun henkilö pyysi, ettei hänelle soiteta enää: phone |
call.recording_ready | Kaksikanavainen tallenne on tallennettu: recordingUrl (voimassa 24 tuntia), durationMs |
call.message_sent | Agentti näytti kortteja verkko- tai sovellussoittajan ruudulla: items, quickReplies |
alert.triggered | Yksi hälytyksistäsi (Webhookit ja ilmoitukset → Hälytykset) ylitti kynnyksensä |
alert.resolved | Kyseinen hälytys on palannut normaaliksi |
Puhelun aikana lähetetyt tapahtumat sisältävät data.call-kentän (id, agentId, channel, direction, numerot). Jokainen pyyntö on allekirjoitettu:
EvaSay-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>">
EvaSay-Delivery: <delivery id>
Varmenna allekirjoitus webhookin luontihetkellä näytetyllä webhook-salaisuudella ja vastaa 2xx-tilalla. Epäonnistuneet toimitukset yritetään uudelleen 1 minuutin, 5 minuutin, 30 minuutin, 2 tunnin ja 12 tunnin kuluttua samalla sisällöllä ja samalla EvaSay-Delivery-tunnuksella, joten voit ohittaa toistot. Webhookin viimeisimmät toimitukset, täsmälleen lähetetty sisältö ja päätepisteesi vastaama tila, listataan komennolla GET /webhooks/{id}/deliveries ja paneelissa; POST /webhooks/{id}/deliveries/{delivery_id} lähettää yhden uudelleen.
Sähköpostin ja alert.triggered- / alert.resolved-webhookien lisäksi hälytykset voivat mennä Slack-kanavalle (incoming webhook), WeCom-ryhmärobotille tai Telegramiin kohdassa Webhookit ja ilmoitukset → Hälytykset → Lähetä myös.
Luo webhook komennolla POST /webhooks ja { "url": "https://crm.example.com/evasay-events", "events": ["call.analyzed"] }. Vastaus sisältää tilauksen ja luodun allekirjoitussalaisuuden, joka palautetaan vain luotaessa. Varmenna EvaSay-Signature, deduplikoi EvaSay-Delivery ja päivitä CRM:si. Tapahtumawebhookit ovat asynkronisia ilmoituksia; puhelun aikaiset työkalut palauttavat tulokset suoraan agentille.