Чатва
API: Вебхуки

Вебхуки

Обновлено 7 сентября 2026 г.

Вебхуки шлют события на ваш URL в реальном времени: новые диалоги, сообщения, назначения, закрытия и оценки. Это основа интеграций с CRM, Slack и внутренними системами.

Диалог

Чатва

Вебхук

message:new

Битрикс24

лид + переписка

Событие в Чатве → POST на ваш URL → действие в вашей системе

POST /webhooks — создание подписки

ПолеТипОписание
urlstring, обязательноеHTTPS-адрес обработчика
eventsarray, обязательноеСписок событий: 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 подряд неудачных доставок) отключаются и подсвечиваются в кабинете.
← Контакты →Лимиты и ошибки