Webhooks

Вебхук отправляет HTTP-запрос на ваш адрес, когда в Kulpunai происходит событие. Так платформу связывают с собственными системами.

Настройка

1. Откройте Настройки → Интеграции → Webhooks.
2. Нажмите добавление вебхука.
3. Укажите:
   • URL — адрес, куда отправлять запросы;
   • События — на какие изменения реагировать.

События

• conversation_created — создан диалог;
• conversation_updated — диалог изменён;
• conversation_status_changed — сменился статус;
• message_created — новое сообщение;
• message_updated — сообщение изменено;
• webwidget_triggered — посетитель открыл виджет на сайте.

Формат данных

Запрос приходит методом POST с телом в формате JSON:

{
  "event": "message_created",
  "id": 123,
  "content": "Здравствуйте",
  "conversation": { },
  "sender": { },
  "account": { }
}

Состав полей зависит от события.

Применение

• Передача заявок в собственную CRM или учётную систему;
• Уведомления в корпоративный чат;
• Запись обращений во внешнюю базу;
• Запуск своих сценариев обработки.

Рекомендации

• Используйте адрес по HTTPS.
• Отвечайте на запрос быстро: долгий ответ приводит к повторным отправкам.
• Предусмотрите повторную обработку — одно и то же событие может прийти дважды.
• Проверяйте вебхук на тестовом адресе, прежде чем подключать боевую систему.