Покрокова інструкція
Markdown статтіПовідомити про помилку

Як відреагувати на доставку повідомлення бота в 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» від «забагато запитів» чи «ліміт нових контактів».

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

Кроки

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

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

Два способи:

  • У сценарії: задайте змінну echat_delivery_tag вузлом перед текстовим вузлом.
  • Через call_node: додайте поле echat_delivery_tag у тіло запиту.
{ "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}}. Подію створило повідомлення оператора, а не бота.

Пов'язане: Налаштувати внутрішні події, Довідник внутрішніх подій

Працюєте з власним ШІ-агентом?Встановіть відкритий skill, щоб ваш ШІ-агент працював з актуальною офіційною документацією ConnectiveOne.Отримати skillПотрібна підтримка?Не знайшли відповідь або потрібна допомога команди ConnectiveOne? Створіть запит у Client Portal.Створити запит