Сообщение в Telegram
Нода Сообщение в Telegram отправляет текст и изображения в указанный чат Telegram от имени бота из Telegram-интеграции проекта. В палитре нода находится в разделе Интеграции.
Назначение
- Уведомление менеджеров в рабочий чат: новая заявка с сайта, заказ, обращение клиента.
- Отправка отчета или сводки, подготовленной агентом или LLM, в канал или группу.
- Сообщение об ошибке на одном из шагов процесса -- например, в ветке, где предыдущая нода вернула
__error.
Перед началом
- Создайте бота в Telegram-интеграции проекта: раздел Интеграции → вкладка Telegram -- см. Telegram-бот.
- Дайте боту доступ к чату. В личный чат бот может писать только после того, как пользователь сам написал боту. В группу или канал бота нужно добавить.
Запускать бота для отправки не нужно: остановленный бот тоже отправляет сообщения.
Настройки
Поля перечислены в порядке, в котором они показаны в панели.
Бот
Обязательное поле. Подсказка «?»: «Бот из Telegram-интеграции проекта, от имени которого уйдёт сообщение. Запускать бота для отправки не нужно.»
- В списке -- боты текущего проекта. Остановленный бот помечен «(остановлен)», его можно выбрать.
- Справа от списка -- кнопки + («Открыть Telegram-интеграцию», открывает раздел интеграций в новой вкладке) и Обновить список (подгружает ботов, созданных в другой вкладке).
- «Нет ботов в проекте» -- в проекте нет ни одного бота.
- «Бот не найден в проекте» -- сохраненный бот удален или перенесен в другой проект.
- «Не удалось загрузить список ботов» с кнопкой Повторить -- список не загрузился.
Чат
Обязательное поле: ID чата или @username. Принимает переменные; кнопка с фигурными скобками (Вставить переменную) вставляет переменную в позицию курсора. Подсказка «?»: «ID чата или @username; для личных чатов пользователь должен сначала написать боту. Поддерживаются переменные {{variable}}.»
123456789
@my_team_channel
{{input.manager_chat_id}}
Текст
Многострочное поле. По умолчанию {{lastOutput}} -- результат предыдущей ноды. Принимает переменные. Подсказка «?»: «Поддерживаются переменные {{variable}}. Пустой текст без изображений завершится ошибкой.»
Текст длиннее 4096 символов отправляется несколькими сообщениями -- только при разметке «Без разметки» (см. ниже).
Разметка
| Вариант | Описание |
|---|---|
| Без разметки | По умолчанию. Текст отправляется как есть |
| Markdown | Разметка Telegram Markdown |
| MarkdownV2 | Разметка Telegram MarkdownV2 |
| HTML | HTML-разметка 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
}
| Поле | Описание |
|---|---|
messageIds | ID отправленных сообщений Telegram: сначала части текста, затем изображения |
chatId | Чат, как он был указан после подстановки переменных |
botId | ID бота |
images | Ссылки на изображения, которые были переданы на отправку |
deduplicated | true, если это повтор той же отправки и сообщение второй раз не отправлялось |
При ошибке:
{
"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 | Что сделать |
|---|---|---|
ConfigurationError | Telegram bot is not selected | Выберите бота |
ConfigurationError | Telegram chat id is empty | Заполните «Чат»; проверьте, что переменная не пустая |
ValidationError | Too many images: N (maximum 10) | Оставьте не больше 10 изображений |
ValidationError | Message text is empty and no images are set | Заполните текст или добавьте изображение; проверьте, что переменная в тексте не пустая |
Отказы при отправке:
errorType | Текст error | Что означает и что сделать |
|---|---|---|
NotFoundError | Telegram bot was not found in this project | Бот удален или принадлежит другому проекту -- выберите другого |
ForbiddenError | Telegram bot cannot write to this chat (blocked, kicked or not a member) | Пользователь заблокировал бота или не писал ему, либо бот не состоит в группе |
BadRequestError | Telegram rejected the message: ... | Telegram отклонил запрос; причина -- после двоеточия, например Bad Request: chat not found |
ParseModeError | Telegram could not parse the message formatting: ... | Разметка содержит неэкранированные символы -- исправьте текст или выберите «Без разметки» |
ValidationError | Telegram send request was rejected: check the text and the images: Formatted text exceeds 4096 characters; split it or send without parse_mode | Размеченный текст длиннее 4096 символов -- сократите его или выберите «Без разметки» |
RateLimitError | Telegram rate limit reached; try again later | Превышен лимит Telegram -- отправляйте реже |
SendInProgress | Telegram message is still being sent; it will probably be delivered | Сообщение еще отправляется; повторно отправлять не нужно |
UpstreamUnavailableError | Telegram service is unavailable | Сервис Telegram или Telegram API недоступны -- повторите позже |
UpstreamError | Telegram send failed | Прочая ошибка отправки |
Защита от повторной отправки
Если та же нода в том же запуске повторяет отправку (например, после обрыва связи), сообщение второй раз не уходит: нода возвращает результат первой отправки с deduplicated: true или ошибку SendInProgress, если первая еще не завершилась. Новый запуск процесса -- это новая отправка. Настраивать эту защиту не нужно.
Проверки на холсте
Если включен показ предупреждений (настройка холста Предупреждения), на ноде появляется красный значок «!», а при наведении -- список проблем:
- «Бот не выбран — сообщение не отправится»
- «Чат не указан — сообщение не отправится»
- «Нет ни текста, ни изображений — сообщение не отправится»
- «Слишком много изображений: не больше 10»
Проверки не мешают сохранить процесс.
Примеры использования
Заявка с сайта в чат менеджеров
Бот: Уведомления
Чат: -1001234567890
Текст: Новая заявка: {{input.name}}, {{input.phone}}
Комментарий: {{input.comment}}
Разметка: Без разметки
Отчет с графиком
Текст: {{node_2.summary}}
Изображения: {{node_3.chart_url}}
Сначала уходит текст отчета, затем изображение.
В заголовке панели есть переключатель тихого режима.