Вебхуки звонков: передавать звонки в свою систему

Обновлено: 9 октября 2026 · 4 мин чтения

Шаги

1. 1

   Отметьте события звонков

   На странице «Settings › Workspace settings › Integrations» нажмите «Configure» на карточке «Webhook», затем «Add new webhook». Впишите «Webhook URL» (HTTPS) и отметьте нужные события в разделе «Calls». Нажмите «Create webhook» и скопируйте секретный ключ: по нему проверяется подпись. Чтобы добавить события в существующий вебхук, нажмите «Edit» рядом с ним. Другие вебхуки не меняются, событие звонка уходит только туда, где оно отмечено.

2. 2

   Какое событие когда приходит

   • «Call started» (call_started): входящий звонок начал звонить или сотрудник позвонил клиенту.
   • «Call answered» (call_answered): на звонок ответили в панели, в приложении или на телефоне.
   • «Call ended» (call_ended): с длительностью, результатом и тем, кто завершил звонок.
   • «Call recording ready» (call_recording_ready): со ссылкой на запись, текстом разговора и кратким содержанием.

   Каждое событие приходит один раз на звонок. Подробнее в статье «Вебхуки звонков: события и когда они приходят».

3. 3

   Что важно знать

   • Ваш сервер должен ответить 2xx за 5 секунд. Если ответа нет, Clomni повторяет отправку, всего до 5 попыток, с тем же delivery_id.
   • Для звонка WhatsApp (QR), на который ответили на телефоне, длительность берётся из журнала звонков телефона. Если журнал не пришёл за 10 минут, «Call ended» приходит без длительности, с duration_known: false.
   • Краткое содержание готовится только для отвеченных звонков длиннее 10 секунд.
   • Проверяйте, что запрос пришёл от Clomni, по секретному ключу и заголовку X-ChatX-Signature.
4. 4

   Полное руководство

   • PDF: Руководство по вебхукам звонков на английском и азербайджанском: примеры запросов, все поля, проверка подписи и различия между сервисами.
   • В панели: «Guide (PDF)» рядом с «Calls» в форме вебхука.
   • Отдельные статьи: события, поля запроса, подпись, доставка и повторы, различия между сервисами, решение проблем.