Додайте 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 |
call.message_status | Що оператор зрештою повідомив про SMS, надіслане агентом: status (delivered, failed або unconfirmed), reason |
alert.triggered | Одне з ваших оповіщень (Вебхуки та сповіщення → Оповіщення) перевищило поріг |
alert.resolved | Це оповіщення повернулося в норму |
conversation.created | У вхідних почалася розмова: conversation |
conversation.message | До розмови додано повідомлення: conversation, messages (role, content, via) |
conversation.updated | У розмови змінився відповідальний або статус (зокрема «вирішено»): conversation, changes |
conversation.needs_human | Розмова чекає на співробітника: conversation, reason |
conversation.closed | Розмову вирішено: conversation |
conversation.unanswered_timeout | Розмова чекала на вашу команду стільки, скільки дозволяє сценарій «Команда не відповіла»: conversation, minutes |
contact.created | Додано нового клієнта: contact_id |
contact.updated | Змінилися дані клієнта: contact_id, fields |
contact.consent_changed | Змінилася згода клієнта: contact_id, kind, status, source |
contact.merged | Двох клієнтів об’єднано: contact_id (той, що лишився), from_id |
appointment.created | У календарі з’явився запис: від агента, вашої команди, API чи форми запису (status — booked або waitlisted): appointment |
appointment.updated | Змінилися стан, нотатки чи послуга запису: appointment, previous_status |
workflow.webhook | Сценарій дійшов до кроку Надіслати у вебхук: name, workflow, conversation, contact, answers |
Події, що надсилаються під час дзвінка, містять 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. Вебхуки подій — це асинхронні сповіщення; інструменти під час дзвінка повертають результати безпосередньо агентові.