Як відреагувати на доставку повідомлення бота в 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).
- У сценарії є секція зі стартовим вузлом Внутрішні події (див. Налаштувати внутрішні події).
Кроки
1. Позначте повідомлення тегом
Тег — це змінна echat_delivery_tag перед повідомленням, яке треба відстежити. У тезі передайте ідентифікатор ліда без персональних даних (не телефон, не email).
Два способи:
- У сценарії: задайте змінну
echat_delivery_tagвузлом перед текстовим вузлом. - Через
call_node: додайте полеechat_delivery_tagу тіло запиту.
{ "echat_delivery_tag": "lead-77" }
Тег діє на одну відправку: наступні повідомлення без нового тегу статусу не повертають. Повідомлення оператора й прості «Розсилки» тег не беруть.
2. Додайте вузол на подію
- У секції оберіть стартовий вузол → тригер Внутрішні події.
- Категорія Повідомлення: E-chat (Telegram): повідомлення доставлено або E-chat: помилка доставки повідомлення.
- Опублікуйте сценарій.
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}}. Подію створило повідомлення оператора, а не бота.
Пов'язане: Налаштувати внутрішні події, Довідник внутрішніх подій