Вебхуки
Обновлено 7 сентября 2026 г.
На этой странице
Вебхуки шлют события на ваш URL в реальном времени: новые диалоги, сообщения, назначения, закрытия и оценки. Это основа интеграций с CRM, Slack и внутренними системами.
Диалог
Чатва
Вебхук
message:new
Битрикс24
лид + переписка
POST /webhooks — создание подписки
| Поле | Тип | Описание |
|---|---|---|
| url | string, обязательное | HTTPS-адрес обработчика |
| events | array, обязательное | Список событий: message:new, conversation:new, conversation:update |
Пример запроса
curl -X POST https://api.chatva.app/v1/webhooks \
-H "Authorization: Bearer ch_live_9f3ka2" \
-H "Content-Type: application/json" \
-d '{"url": "https://crm.yourco.ru/hooks/chatva", "events": ["message:new", "conversation:new"]}'События
| Событие | Когда срабатывает |
|---|---|
| message:new | Новое сообщение в любом диалоге — от клиента, оператора или бота |
| conversation:new | Создан новый диалог в любом канале |
| conversation:update | Изменились статус, ответственный, отдел, теги или оценка диалога |
Формат payload
Пример payload
{
"type": "message:new",
"payload": {
"conversation": {
"id": "cv_018f3a",
"channel": "telegram",
"client": "Кира Мещерякова"
},
"message": {
"id": "m_5521",
"from": "client",
"text": "Здравствуйте!",
"createdAt": "2026-09-07T12:00:00Z"
}
}
}Доставка и ретраи
- Ответьте 2xx в течение 5 секунд — иначе событие повторится до трёх раз с нарастающей паузой.
- Каждый запрос подписан заголовком X-Chatva-Signature: HMAC-SHA256 от тела по секрету вебхука. Сверяйте подпись, чтобы отбросить чужие запросы.
- Порядок событий не гарантируется — ориентируйтесь на createdAt внутри payload.
- Неактивные вебхуки (10 подряд неудачных доставок) отключаются и подсвечиваются в кабинете.