Вебхуки

Вебхуки (Event Webhooks) отправляют на ваш URL HTTP-уведомление каждый раз, когда в tuk-tuk.online происходит выбранное событие: пришло сообщение, создан диалог, завершилась цепочка, прошла оплата. Так платформа связывается с любым сервисом, у которого есть HTTP-адрес: Make.com, n8n, Zapier, ERP, собственный сервер.

Вебхук работает независимо от цепочек и AI. Это уведомление «снаружи», а не шаг сценария: для запросов внутри сценария есть блок Webhook.

#Когда это нужно

• Передавать обращения в Make.com, n8n или Zapier и дальше в таблицы, CRM, почту.
• Уведомлять внутреннюю систему (ERP, CMS, 1С) о новых клиентах и сообщениях.
• Вести собственную аналитику по событиям платформы.
• Запускать внешние процессы по событию: выставить счёт после оплаты, отправить SMS после закрытия диалога.

#Какие события доступны

Всего 51 тип события в 10 группах. Имя события приходит в поле event и в заголовке X-Webhook-Event.

#Как настроить

Открыть крупнее

1. Кнопка «Добавить вебхук».
2. Карточка вебхука: название, URL, события, секрет и журнал доставки.

Открыть крупнее

1. Название вебхука.

2. URL вашего сервера.

3. Выбор событий: отметьте нужные группы, всего 50 событий.

4. Откройте Настройки проекта и найдите блок «Вебхуки API».

5. Нажмите «Создать вебхук» и заполните «Название» (например, «Мой CRM webhook») и «URL» (адрес вашего сервера или сценария Make.com, n8n).

6. Отметьте события, о которых хотите получать уведомления, и сохраните: вебхук появится в списке включённым.

7. Нажмите «Секрет» у вебхука и скопируйте Signing Secret: он нужен для проверки подписи на вашей стороне.

У каждого вебхука в списке есть действия «Редактировать», «Секрет», «Логи», «Удалить». Вебхук можно временно выключить, не удаляя.

#Проверить, что работает

1. Создайте вебхук с событием message.inbound и напишите боту с тестового номера: ваш сервер получит POST-запрос.
2. Откройте «Логи» у вебхука: в таблице появится строка с событием, HTTP-статусом ответа, временем доставки и датой.
3. Проверьте подпись из заголовка X-Webhook-Signature по примеру со страницы Event Webhooks.

#Что приходит на ваш URL

При событии платформа отправляет один POST-запрос с JSON-телом и четырьмя заголовками.

Тело всегда одной структуры: event, timestamp, data. Состав data зависит от события.

{
  "event": "message.inbound",
  "timestamp": "2026-01-15T14:30:00.000Z",
  "data": {
    "messageId": "msg-uuid",
    "dialogId": "dialog-uuid",
    "body": "Здравствуйте, хочу узнать о доставке",
    "channelType": "TELEGRAM_BOT",
    "channelId": "ch-uuid",
    "mediaType": null
  }
}

#Как устроена доставка

#Примеры сценариев

#Make.com или n8n

1. Создайте сценарий с триггером «Webhook» и скопируйте его URL.
2. Создайте вебхук в tuk-tuk.online с этим URL и событием message.inbound или dialog.created.
3. Напишите боту: в сценарии появится запрос с телом события, дальше данные можно передать в таблицу или CRM.

#Google Sheets

Прямой записи в таблицу нет. Используйте Make.com или n8n как промежуточный шаг: вебхук → сценарий → строка в Google Sheets.

#Собственный сервер

Поднимите endpoint, который принимает POST с JSON, проверяет подпись X-Webhook-Signature и отвечает 200. Готовый код проверки на JavaScript и PHP: Event Webhooks.

#Вебхуки и блок Webhook в цепочках

#Ограничения

• Одна попытка доставки без повторов, таймаут 10 секунд.
• После 50 ошибок подряд вебхук выключается автоматически.
• Тело только JSON (Content-Type: application/json); другие форматы не поддерживаются.
• Заголовки запроса фиксированы: свои заголовки (например, Authorization) добавить нельзя, защищайте endpoint проверкой подписи.

#Частые проблемы