Webhook-канал принимает заявки и данные от любых внешних источников: форм на сайте, конструкторов (Tilda, WordPress), CRM и любых сервисов, которые умеют отправлять HTTP-запросы. Каждая заявка становится диалогом с карточкой клиента, а назначенная каналу цепочка запускается автоматически.
Канал односторонний: данные приходят в tuk-tuk.online, ответить клиенту через Webhook нельзя.
#Когда это нужно
- На сайте есть форма обратной связи: имя, телефон, email.
- Сайт собран на конструкторе (Tilda, WordPress, Bitrix), и заявки нужно отправлять в tuk-tuk.online.
- Создавать диалоги автоматически при каждой заявке.
- Запускать цепочку автоматизации по входящей заявке.
#Как подключить
#Создать канал
Название канала: по нему потом видно источник заявок.
Адрес источника, если он нужен для справки.
Кнопка «Подключить»: после создания канал получит собственный URL для приёма заявок.
Откройте Каналы связи.
Нажмите «Подключить» на карточке Webhook.
Нажмите «Сохранить»: в карточке канала появится уникальный URL вебхука.
#URL вебхука
https://api.tuk-tuk.online/webhooks/incoming/<ID канала>URL принимает запросы двумя способами:
| Метод | Формат данных |
|---|---|
| GET | Параметры в URL: ?name=Иван&phone=+79001234567 |
| POST | JSON в теле запроса: {"name": "Иван", "phone": "+79001234567"} |
Большинство конструкторов сайтов (Tilda, WordPress) отправляют данные методом POST в JSON.
#Настроить отправку данных
Пример для Tilda:
- Откройте настройки формы в Tilda.
- В разделе «Приём данных» выберите Webhook.
- Вставьте URL вебхука.
- Сохраните и опубликуйте страницу: заявки с формы начнут приходить в tuk-tuk.online.
Пример запроса из своего кода: отправьте POST на URL вебхука с заголовком Content-Type: application/json и телом:
{
"name": "Иван Петров",
"phone": "+79001234567",
"email": "ivan@example.com",
"message": "Хочу записаться на консультацию"
}#Проверить, что работает
- Отправьте тестовую заявку через форму или запрос.
- Откройте Диалоги: появится новый диалог с данными заявки во входящем сообщении.
- Откройте карточку клиента: имя, телефон и email заполнены.
#Что умеет
#Автоматическое распознавание полей
Маппинг настраивать не нужно: платформа ищет знакомые имена полей.
| Что ищем | Какие имена полей распознаются |
|---|---|
| Имя | name, first_name, firstName, client_name, Имя |
| Телефон | phone, telephone, tel, mobile, Телефон |
| email, e-mail, mail, Email |
Остальные поля сохраняются в customFields диалога.
#Что происходит при получении заявки
- Платформа создаёт новый диалог или находит существующий по телефону или email.
- Данные заявки показываются как входящее сообщение.
- Имя, телефон и email сохраняются в карточке клиента.
- Остальные поля попадают в customFields.
- Если каналу назначена цепочка, она запускается автоматически.
#Флаг _skipChains
| Флаг | Описание |
|---|---|
_skipChains | Передайте "_skipChains": true, и цепочки не запустятся. Удобно, когда нужно только сохранить данные |
#Ограничения
- Каждый запрос создаёт один диалог или обновляет существующий.
- Канал односторонний: ответить клиенту через Webhook нельзя. Для ответа используйте другие каналы: Email, SMS, Telegram.
Исходящие уведомления о событиях платформы описаны отдельно: Event Webhooks.
#Частые проблемы
| Проблема | Что делать |
|---|---|
| Заявки не приходят | Сверьте URL вебхука: он должен совпадать символ в символ |
| Данные пустые | Убедитесь, что форма отправляет JSON |
| Имя или телефон не распознались | Они сохранены в customFields: проверьте карточку диалога |
| Цепочка не запускается | Проверьте, что цепочка назначена каналу и в запросе нет флага _skipChains |