---
title: "Webhook-канал: приём заявок с сайтов и форм в tuk-tuk.online"
nav_title: "Webhook-канал"
url: https://docs.tuk-tuk.online/channels/webhook
markdown: https://docs.tuk-tuk.online/channels/webhook.md
section: "Каналы связи"
description: "Как принимать заявки с форм, Tilda, WordPress и любых сервисов в tuk-tuk.online через Webhook-канал: URL вебхука, GET и POST, автоматическое распознавание имени, телефона и email, запуск цепочек."
keywords: ["Webhook канал", "Webhook подключить", "приём заявок", "форма обратной связи", "Tilda webhook", "WordPress webhook", "заявки с сайта", "интеграция форм", "лидогенерация"]
lang: ru
product: tuk-tuk.online
app: https://lk.tuk-tuk.online
api_base: https://back.tuk-tuk.online
---

> [!AI] Кратко
> Webhook-канал принимает заявки по HTTP от форм, конструкторов сайтов и любых сервисов: каждая заявка становится диалогом с карточкой клиента и запускает назначенную цепочку. Канал односторонний, ответить через него нельзя.
>
> - Путь в кабинете: Каналы связи → Подключить → Webhook → Сохранить. URL вебхука показан в карточке канала.
> - Эндпоинт: https://api.tuk-tuk.online/webhooks/incoming/<ID канала>; методы GET (параметры в URL) и POST (JSON в теле).
> - Распознаваемые поля: name, first_name, firstName, client_name, Имя; phone, telephone, tel, mobile, Телефон; email, e-mail, mail, Email. Остальное сохраняется в customFields.
> - Диалог создаётся или находится по телефону и email; назначенная каналу цепочка запускается автоматически.
> - Флаг "_skipChains": true в теле запроса отключает запуск цепочек.
> - Канал односторонний: ответить клиенту через Webhook нельзя, URL вебхука секретный.
>
> Связанные страницы: https://docs.tuk-tuk.online/channels, https://docs.tuk-tuk.online/integrations/webhooks, https://docs.tuk-tuk.online/api/webhooks, https://docs.tuk-tuk.online/chains/triggers, https://docs.tuk-tuk.online/chains/blocks/webhook

# Подключение Webhook-канала

Webhook-канал принимает заявки и данные от любых внешних источников: форм на сайте, конструкторов (Tilda, WordPress), CRM и любых сервисов, которые умеют отправлять HTTP-запросы. Каждая заявка становится диалогом с карточкой клиента, а назначенная каналу цепочка запускается автоматически.

Канал односторонний: данные приходят в tuk-tuk.online, ответить клиенту через Webhook нельзя.

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

- На сайте есть форма обратной связи: имя, телефон, email.
- Сайт собран на конструкторе (Tilda, WordPress, Bitrix), и заявки нужно отправлять в tuk-tuk.online.
- Создавать диалоги автоматически при каждой заявке.
- Запускать цепочку автоматизации по входящей заявке.

## Как подключить

### Создать канал


![Форма создания Webhook-канала](https://docs.tuk-tuk.online/assets/screens/channels/webhook-form.webp)

1. Название канала: по нему потом видно источник заявок.
2. Адрес источника, если он нужен для справки.
3. Кнопка «Подключить»: после создания канал получит собственный URL для приёма заявок.

1. Откройте [Каналы связи](https://lk.tuk-tuk.online/channels).
2. Нажмите «Подключить» на карточке Webhook.
3. Нажмите «Сохранить»: в карточке канала появится уникальный URL вебхука.

### URL вебхука

```text
https://api.tuk-tuk.online/webhooks/incoming/<ID канала>
```

URL принимает запросы двумя способами:

| Метод | Формат данных |
|---|---|
| GET | Параметры в URL: `?name=Иван&phone=+79001234567` |
| POST | JSON в теле запроса: `{"name": "Иван", "phone": "+79001234567"}` |

Большинство конструкторов сайтов (Tilda, WordPress) отправляют данные методом POST в JSON.

> [!DANGER] URL вебхука секретный. Не публикуйте его в открытом доступе.

### Настроить отправку данных

Пример для Tilda:

1. Откройте настройки формы в Tilda.
2. В разделе «Приём данных» выберите Webhook.
3. Вставьте URL вебхука.
4. Сохраните и опубликуйте страницу: заявки с формы начнут приходить в tuk-tuk.online.

Пример запроса из своего кода: отправьте POST на URL вебхука с заголовком `Content-Type: application/json` и телом:

```json
{
  "name": "Иван Петров",
  "phone": "+79001234567",
  "email": "ivan@example.com",
  "message": "Хочу записаться на консультацию"
}
```

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

1. Отправьте тестовую заявку через форму или запрос.
2. Откройте [Диалоги](https://lk.tuk-tuk.online/dialogs): появится новый диалог с данными заявки во входящем сообщении.
3. Откройте карточку клиента: имя, телефон и email заполнены.

## Что умеет

### Автоматическое распознавание полей

Маппинг настраивать не нужно: платформа ищет знакомые имена полей.

| Что ищем | Какие имена полей распознаются |
|---|---|
| Имя | name, first_name, firstName, client_name, Имя |
| Телефон | phone, telephone, tel, mobile, Телефон |
| Email | email, e-mail, mail, Email |

Остальные поля сохраняются в customFields диалога.

> [!TIP] Если форма называет поле нестандартно (например, `kontaktniy_telefon`), данные не пропадут: они попадут в пользовательские поля диалога.

### Что происходит при получении заявки

1. Платформа создаёт новый диалог или находит существующий по телефону или email.
2. Данные заявки показываются как входящее сообщение.
3. Имя, телефон и email сохраняются в карточке клиента.
4. Остальные поля попадают в customFields.
5. Если каналу назначена цепочка, она запускается автоматически.

### Флаг `_skipChains`

| Флаг | Описание |
|---|---|
| `_skipChains` | Передайте `"_skipChains": true`, и цепочки не запустятся. Удобно, когда нужно только сохранить данные |

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

- Каждый запрос создаёт один диалог или обновляет существующий.
- Канал односторонний: ответить клиенту через Webhook нельзя. Для ответа используйте другие каналы: Email, SMS, Telegram.

Исходящие уведомления о событиях платформы описаны отдельно: [Event Webhooks](https://docs.tuk-tuk.online/api/webhooks).

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

| Проблема | Что делать |
|---|---|
| Заявки не приходят | Сверьте URL вебхука: он должен совпадать символ в символ |
| Данные пустые | Убедитесь, что форма отправляет JSON |
| Имя или телефон не распознались | Они сохранены в customFields: проверьте карточку диалога |
| Цепочка не запускается | Проверьте, что цепочка назначена каналу и в запросе нет флага `_skipChains` |