---
title: "Блок «Webhook» в цепочке: HTTP-запрос к внешнему API | tuk-tuk.online"
nav_title: "Webhook"
url: https://docs.tuk-tuk.online/chains/blocks/webhook
markdown: https://docs.tuk-tuk.online/chains/blocks/webhook.md
section: "Блоки"
description: "Блок WEBHOOK: GET или POST на любой URL, параметры с переменными, автоматическая передача данных клиента, цепочки и диалога, таймаут 15 секунд, ответ в {{webhook_N}}."
keywords: ["webhook бот", "HTTP запрос бот", "API интеграция бот", "внешний сервис бот", "REST API автоматизация", "webhook цепочка"]
lang: ru
product: tuk-tuk.online
app: https://lk.tuk-tuk.online
api_base: https://back.tuk-tuk.online
---

> [!AI] Кратко
> Блок WEBHOOK отправляет GET- или POST-запрос на внешний URL с параметрами из переменных цепочки и сохраняет ответ в {{webhookResult}} и {{webhook_N}}.
>
> - Методы: POST (по умолчанию) и GET; только HTTP/HTTPS
> - Таймаут 15 секунд; при ошибке блок сохраняет { error } и цепочка продолжается
> - includeUserData добавляет client_name, phone, email, client_identifier, tags
> - includeChainData добавляет last_message, ai_result, channel_type, chain_id, python_result, integration_result
> - includeDialog добавляет поле dialog с полной перепиской
> - Ответ: {{webhookResult}} как { status, body } или { error }, {{webhook_N}} как строка тела
>
> Связанные страницы: https://docs.tuk-tuk.online/chains/blocks, https://docs.tuk-tuk.online/chains/blocks/python-code, https://docs.tuk-tuk.online/integrations/webhooks, https://docs.tuk-tuk.online/api/webhooks, https://docs.tuk-tuk.online/api/rest

# Webhook

Блок отправляет HTTP-запрос на указанный URL, ждёт ответ до 15 секунд и сохраняет его в контекст цепочки. Так цепочка обменивается данными с CRM, 1С, интернет-магазином или любым другим API.

К запросу можно автоматически добавить данные клиента, данные цепочки и полную историю диалога, а свои параметры заполнить переменными.

## Настройки

| Поле | Описание |
|---|---|
| URL | Адрес, на который уходит запрос |
| Метод | GET или POST |
| Параметры | Пары ключ-значение, значения поддерживают переменные |
| Передать данные клиента | Добавить к запросу имя, телефон, email, идентификатор и теги клиента |
| Передать данные цепочки | Добавить последнее сообщение, результат AI, тип канала и другие поля |
| Передать историю диалога | Добавить поле `dialog` с полным текстом переписки |

Когда какой метод:

| Метод | Назначение |
|---|---|
| POST (по умолчанию) | Передать данные: создать запись, обновить, отправить информацию |
| GET | Запросить данные: статус, наличие, справочник |

## Автоматические поля

Данные клиента (`includeUserData`):

| Поле | Значение |
|---|---|
| `client_name` | Имя клиента |
| `phone` | Телефон |
| `email` | Email |
| `client_identifier` | Уникальный идентификатор клиента |
| `tags` | Теги клиента |

Данные цепочки (`includeChainData`):

| Поле | Значение |
|---|---|
| `last_message` | Последнее сообщение |
| `ai_result` | Результат AI |
| `channel_type` | Тип канала |
| `chain_id` | Идентификатор цепочки |
| `python_result` | Результат Python |
| `integration_result` | Результат интеграции |

История диалога (`includeDialog`): поле `dialog` с полной перепиской.

Свои параметры добавляются парами ключ-значение, в значениях работают переменные:

| Ключ | Значение |
|---|---|
| `order_id` | `{{lastMessage}}` |
| `client` | `{{name}}` |
| `ai_summary` | `{{aiResult}}` |

## Пример

Статус заказа из CRM:

```text
Отправка сообщения: «Напишите номер заказа»
Ожидание ответа
Webhook: POST https://api.myshop.com/orders/status
  Параметр: order_id = {{lastMessage}}
Отправка сообщения: «Статус вашего заказа: {{webhook_3}}»
```

Запись в Google Sheets через Apps Script:

```text
AI-обработка: «Извлеки имя и телефон»
Webhook: POST https://script.google.com/...
  Передать данные клиента: включено
  Параметр: ai_result = {{aiResult}}
```

## Что сохраняется в контексте

| Переменная | Значение |
|---|---|
| `{{webhookResult}}` | Полный ответ: объект `{ status, body }` или `{ error }` |
| `{{webhook_N}}` | Тело ответа строкой, N: номер блока |

Разобрать JSON из ответа удобно в блоке [Python-код](https://docs.tuk-tuk.online/chains/blocks/python-code).

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

- Таймаут 15 секунд. Если сервер не ответил, блок сохраняет ошибку в `{{webhookResult}}` и цепочка продолжается.
- Только HTTP и HTTPS, другие протоколы не поддерживаются.

> [!TIP] Чтобы принимать события от tuk-tuk.online в обратную сторону (новое сообщение, смена статуса), используйте [Event Webhooks](https://docs.tuk-tuk.online/api/webhooks).