---
title: "Як відреагувати на доставку повідомлення бота в e-chat (Telegram)"
description: "Позначте повідомлення бота в e-chat (Telegram) тегом і запустіть вузол, коли e-chat підтвердить доставку або повідомить про помилку."
---

# Як відреагувати на доставку повідомлення бота в e-chat (Telegram)?

Коли бот пише клієнту через e-chat (Telegram), ви можете дізнатися, чи повідомлення справді дійшло, і запустити вузол сценарію: «E-chat (Telegram): повідомлення доставлено» або «E-chat: помилка доставки повідомлення». Це потрібно, наприклад, щоб створити нагоду в CRM лише після доставки першого повідомлення кампанії.

> **Увага: лише e-chat (Telegram).** Це працює тільки для ботів, підключених через e-chat, і тільки для Telegram. На інших каналах (власний Telegram-бот, Viber, WhatsApp, віджет, email) тег `echat_delivery_tag` ігнорується, а подія «E-chat (Telegram): повідомлення доставлено» не запускається. Подія «E-chat: помилка доставки повідомлення» для повідомлень бота теж приходить лише з Telegram.

## Коли знадобиться

- Кампанія пише лідам, і лід у CRM має змінити стан лише після доставки.
- Потрібно відрізнити «нема такого користувача в Telegram» від «забагато запитів» чи «ліміт нових контактів».

## Перед початком

- Бот підключений до e-chat (Telegram).
- У сценарії є секція зі стартовим вузлом **Внутрішні події** (див. [Налаштувати внутрішні події](/uk/scenariobuilder/how-to/configure-start-node-internal-events.md)).

## Кроки

### 1. Позначте повідомлення тегом

Тег — це змінна `echat_delivery_tag` перед повідомленням, яке треба відстежити. У тезі передайте ідентифікатор ліда **без персональних даних** (не телефон, не email).

Два способи:

- **У сценарії:** задайте змінну `echat_delivery_tag` вузлом перед текстовим вузлом.
- **Через `call_node`:** додайте поле `echat_delivery_tag` у тіло запиту.

```json
{ "echat_delivery_tag": "lead-77" }
```

Тег діє на **одну** відправку: наступні повідомлення без нового тегу статусу не повертають. Повідомлення оператора й прості «Розсилки» тег не беруть.

### 2. Додайте вузол на подію

1. У секції оберіть стартовий вузол → тригер **Внутрішні події**.
2. Категорія **Повідомлення**: **E-chat (Telegram): повідомлення доставлено** або **E-chat: помилка доставки повідомлення**.
3. Опублікуйте сценарій.

### 3. Використайте дані події

У вузлі, який запускає подія, доступні змінні:

| Змінна | Значення |
|--------|----------|
| `{{echat_tag}}` | Тег з відправки. Порожній — подія від повідомлення оператора |
| `{{echat_delivery_status}}` | `1` — доставлено, `4` — помилка |
| `{{echat_delivery_error_code}}` | Код помилки e-chat (для доставленого — порожній) |
| `{{echat_delivery_error_description}}` | Текст помилки e-chat як є |
| `{{echat_delivery_error_reason}}` | `user_not_found`, `rate_limited`, `contact_limit` або `other` |
| `{{echat_delivered_message_id}}` | Ідентифікатор повідомлення в e-chat |
| `{{echat_delivered_chat_id}}` | chat_id отримувача |
| `{{echat_delivered_channel}}` | Канал (Telegram) |

Код `4` не завжди означає «у користувача нема Telegram». Для рішення використовуйте `{{echat_delivery_error_reason}}`.

## Важливо знати

- Вузол події запускається **в новій сесії**, а не в діалозі отримувача. Повідомлення з цього вузла клієнту **не надсилаються** (їх пропущено як успішні). Результат записуйте в CRM або через API.
- Подія приходить один раз на повідомлення. Для одного отримувача — не більше 3 подій на годину і не більше 3 подій помилки на добу.
- Протягом першої години до тегованих повідомлень з одного номера бота — не більше одного повідомлення на секунду (до відповіді e-chat про унікальність ідентифікаторів).

## Коли події не буде

Подія не запускається, якщо: відправка не вдалась; статус прийшов пізніше ніж за 1 годину; вичерпано ліміти; два повідомлення з одного номера бота отримали однаковий ідентифікатор в e-chat; сховище тимчасово не відповіло вчасно; e-chat надіслав статус, відмінний від `1` і `4` (такий статус ігнорується, справжній статус після нього спрацює); або на подію нема вузла (ліміт при цьому все одно витрачається). У CRM лід лишається в стані «статус невідомий» — продумайте це в процесі.

## Типові помилки

- **Подія не приходить.** Перевірте, що повідомлення позначене тегом і що в секції є вузол саме на цю подію.
- **Порожній `{{echat_tag}}`.** Подію створило повідомлення оператора, а не бота.

**Пов'язане:** [Налаштувати внутрішні події](/uk/scenariobuilder/how-to/configure-start-node-internal-events.md), [Довідник внутрішніх подій](/uk/scenariobuilder/reference/internal-events-trigger-reference.md)

<!-- Скріншоти й GIF додасть демо: список подій у вузлі «Старт», вузол із `{{echat_tag}}`. -->
