Перейти к основному содержимому

Сообщение в Telegram

Нода Сообщение в Telegram отправляет текст и изображения в указанный чат Telegram от имени бота из Telegram-интеграции проекта. В палитре нода находится в разделе Интеграции.

Назначение​

  • Уведомление менеджеров в рабочий чат: новая заявка с сайта, заказ, обращение клиента.
  • Отправка отчета или сводки, подготовленной агентом или LLM, в канал или группу.
  • Сообщение об ошибке на одном из шагов процесса -- например, в ветке, где предыдущая нода вернула __error.

Перед началом​

  1. Создайте бота в Telegram-интеграции проекта: раздел Интеграции → вкладка Telegram -- см. Telegram-бот.
  2. Дайте боту доступ к чату. В личный чат бот может писать только после того, как пользователь сам написал боту. В группу или канал бота нужно добавить.

Запускать бота для отправки не нужно: остановленный бот тоже отправляет сообщения.

Настройки​

Поля перечислены в порядке, в котором они показаны в панели.

Бот​

Обязательное поле. Подсказка «?»: «Бот из Telegram-интеграции проекта, от имени которого уйдёт сообщение. Запускать бота для отправки не нужно.»

  • В списке -- боты текущего проекта. Остановленный бот помечен «(остановлен)», его можно выбрать.
  • Справа от списка -- кнопки + («Открыть Telegram-интеграцию», открывает раздел интеграций в новой вкладке) и Обновить список (подгружает ботов, созданных в другой вкладке).
  • «Нет ботов в проекте» -- в проекте нет ни одного бота.
  • «Бот не найден в проекте» -- сохраненный бот удален или перенесен в другой проект.
  • «Не удалось загрузить список ботов» с кнопкой Повторить -- список не загрузился.

Чат​

Обязательное поле: ID чата или @username. Принимает переменные; кнопка с фигурными скобками (Вставить переменную) вставляет переменную в позицию курсора. Подсказка «?»: «ID чата или @username; для личных чатов пользователь должен сначала написать боту. Поддерживаются переменные {{variable}}.»

123456789
@my_team_channel
{{input.manager_chat_id}}

Текст​

Многострочное поле. По умолчанию {{lastOutput}} -- результат предыдущей ноды. Принимает переменные. Подсказка «?»: «Поддерживаются переменные {{variable}}. Пустой текст без изображений завершится ошибкой.»

Текст длиннее 4096 символов отправляется несколькими сообщениями -- только при разметке «Без разметки» (см. ниже).

Разметка​

ВариантОписание
Без разметкиПо умолчанию. Текст отправляется как есть
MarkdownРазметка Telegram Markdown
MarkdownV2Разметка Telegram MarkdownV2
HTMLHTML-разметка Telegram

Подсказка «?»: «HTML и Markdown требуют экранирования спецсимволов: неэкранированный текст (например, «_» или «<») Telegram отклонит, и сообщение не уйдёт. Если текст приходит из переменной, оставьте «Без разметки».»

С разметкой текст должен укладываться в 4096 символов: разрезать размеченный текст на части нода не будет и вернет ошибку.

Изображения​

Список ссылок на изображения, до 10 штук. Справа от названия -- счетчик «N / 10». Строки добавляются кнопкой Добавить изображение (недоступна, когда ссылок 10) и удаляются кнопкой корзины. Каждая строка принимает переменные. Подсказка «?»: «Публичные http(s)-ссылки на изображения, отправляются после текста. Не более 10 — если больше, ничего не отправится.»

  • Одно изображение уходит отдельным фото, несколько -- одним альбомом.
  • Пустые строки (и переменные, давшие пустое значение) пропускаются.
  • Если ссылок больше 10, под списком показывается «Больше 10 изображений — ничего не отправится. Удалите лишние.»

Подключения​

  • Вход: один вход (слева)
  • Выход: один выход output (справа)

Ошибка не останавливает процесс: следующая нода получает объект ошибки. Проверить результат можно нодой If/Else с условием вида node_6.__error, где node_6 -- ID ноды.

Входные данные​

Нода использует результат предыдущей ноды через переменные в полях -- по умолчанию через {{lastOutput}} в поле «Текст».

Выходные данные​

{
"success": true,
"__success": true,
"__error": false,
"messageIds": [512, 513],
"chatId": "-1001234567890",
"botId": "tgbot_...",
"images": ["https://example.com/report.png"],
"deduplicated": false
}
ПолеОписание
messageIdsID отправленных сообщений Telegram: сначала части текста, затем изображения
chatIdЧат, как он был указан после подстановки переменных
botIdID бота
imagesСсылки на изображения, которые были переданы на отправку
deduplicatedtrue, если это повтор той же отправки и сообщение второй раз не отправлялось

При ошибке:

{
"success": false,
"__success": false,
"__error": true,
"error": "Telegram rejected the message: Bad Request: chat not found",
"errorType": "BadRequestError",
"code": null,
"status": 409,
"chatId": "123456789",
"botId": "tgbot_...",
"messageIds": []
}

Если часть сообщений успела уйти до ошибки, их ID остаются в messageIds.

Типичные ошибки​

Проверки до отправки:

errorTypeТекст errorЧто сделать
ConfigurationErrorTelegram bot is not selectedВыберите бота
ConfigurationErrorTelegram chat id is emptyЗаполните «Чат»; проверьте, что переменная не пустая
ValidationErrorToo many images: N (maximum 10)Оставьте не больше 10 изображений
ValidationErrorMessage text is empty and no images are setЗаполните текст или добавьте изображение; проверьте, что переменная в тексте не пустая

Отказы при отправке:

errorTypeТекст errorЧто означает и что сделать
NotFoundErrorTelegram bot was not found in this projectБот удален или принадлежит другому проекту -- выберите другого
ForbiddenErrorTelegram bot cannot write to this chat (blocked, kicked or not a member)Пользователь заблокировал бота или не писал ему, либо бот не состоит в группе
BadRequestErrorTelegram rejected the message: ...Telegram отклонил запрос; причина -- после двоеточия, например Bad Request: chat not found
ParseModeErrorTelegram could not parse the message formatting: ...Разметка содержит неэкранированные символы -- исправьте текст или выберите «Без разметки»
ValidationErrorTelegram send request was rejected: check the text and the images: Formatted text exceeds 4096 characters; split it or send without parse_modeРазмеченный текст длиннее 4096 символов -- сократите его или выберите «Без разметки»
RateLimitErrorTelegram rate limit reached; try again laterПревышен лимит Telegram -- отправляйте реже
SendInProgressTelegram message is still being sent; it will probably be deliveredСообщение еще отправляется; повторно отправлять не нужно
UpstreamUnavailableErrorTelegram service is unavailableСервис Telegram или Telegram API недоступны -- повторите позже
UpstreamErrorTelegram send failedПрочая ошибка отправки

Защита от повторной отправки​

Если та же нода в том же запуске повторяет отправку (например, после обрыва связи), сообщение второй раз не уходит: нода возвращает результат первой отправки с deduplicated: true или ошибку SendInProgress, если первая еще не завершилась. Новый запуск процесса -- это новая отправка. Настраивать эту защиту не нужно.

Проверки на холсте​

Если включен показ предупреждений (настройка холста Предупреждения), на ноде появляется красный значок «!», а при наведении -- список проблем:

  • «Бот не выбран — сообщение не отправится»
  • «Чат не указан — сообщение не отправится»
  • «Нет ни текста, ни изображений — сообщение не отправится»
  • «Слишком много изображений: не больше 10»

Проверки не мешают сохранить процесс.

Примеры использования​

Заявка с сайта в чат менеджеров​

Бот:      Уведомления
Чат: -1001234567890
Текст: Новая заявка: {{input.name}}, {{input.phone}}
Комментарий: {{input.comment}}
Разметка: Без разметки

Отчет с графиком​

Текст:        {{node_2.summary}}
Изображения: {{node_3.chart_url}}

Сначала уходит текст отчета, затем изображение.

Тихий режим

В заголовке панели есть переключатель тихого режима.