Додайте https-адресу в Інтеграції → Вебхуки та сповіщення, щоб отримувати події дзвінків:
| Подія | Коли |
|---|---|
call.started | Агент відповів на дзвінок |
call.ended | Дзвінок завершився; указано тривалість і кредити |
call.analyzed | Готові короткий зміст, підсумок, витягнуті поля та розшифровка |
call.transcript | Під час дзвінка, нові рядки розшифровки кожні кілька секунд |
call.tool_called | Агент викликав одну з ваших функцій: name, arguments, status, durationMs |
call.handed_off | Дзвінок передано іншому агентові: fromAgentId, toAgentId |
call.transferred | Дзвінок переведено на людину: destination |
call.voicemail | Вихідний дзвінок потрапив на автовідповідач |
call.do_not_call | Людина у вихідному дзвінку попросила більше їй не телефонувати: phone |
call.recording_ready | Двоканальний запис збережено: recordingUrl (чинний 24 години), durationMs |
call.message_sent | Агент показав картки на екрані веб- або застосункового абонента: items, quickReplies |
alert.triggered | Одне з ваших оповіщень (Вебхуки та сповіщення → Оповіщення) перевищило поріг |
alert.resolved | Це оповіщення повернулося в норму |
Події, що надсилаються під час дзвінка, містять data.call (id, agentId, channel, direction, номери). Кожен запит підписано:
EvaSay-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>">
EvaSay-Delivery: <delivery id>
Перевіряйте підпис секретом вебхука, показаним під час його створення, і відповідайте статусом 2xx. Невдалі доставки повторюються через 1 хвилину, 5 хвилин, 30 хвилин, 2 години та 12 годин з тим самим тілом і тим самим ідентифікатором EvaSay-Delivery, тож повтори можна ігнорувати. Останні доставки вебхука з точним надісланим тілом і статусом, який відповів ваш endpoint, виводяться через GET /webhooks/{id}/deliveries і в панелі; POST /webhooks/{id}/deliveries/{delivery_id} надсилає одну з них знову.
Окрім електронної пошти та вебхуків alert.triggered / alert.resolved, оповіщення можна надсилати в канал Slack (incoming webhook), груповий бот WeCom або Telegram у Вебхуки та сповіщення → Оповіщення → Також надсилати в.
Створіть вебхук через POST /webhooks з { "url": "https://crm.example.com/evasay-events", "events": ["call.analyzed"] }. У відповіді — підписка та згенерований секрет підпису, що повертається лише під час створення. Перевіряйте EvaSay-Signature, дедуплікуйте за EvaSay-Delivery і оновлюйте свій CRM. Вебхуки подій — це асинхронні сповіщення; інструменти під час дзвінка повертають результати безпосередньо агентові.