Telegram
Сообщения и медиа бота Telegram в процессах Pailot
Telegram — мессенджер. Блок шлёт текст и медиа через Bot API (Application Programming Interface бота) и может запускать процесс по входящему сообщению.
С Telegram в Pailot вы можете:
- Отправлять текст в личку, группу или канал (
chatId)
- Удалять сообщение по
messageId
- Отправлять фото, видео, аудио и GIF:
file_id или HTTP URL
- Отправлять документ (PDF, ZIP, DOC и др., до 50 МБ)
- Запускать процесс в режиме триггера, когда в чат бота приходит сообщение
Нужен токен бота от @BotFather. Токен — в переменных окружения. Для триггера включите режим и скопируйте URL вебхука (входящий HTTP-запрос). Не публикуйте URL.
Блок ставят на холст как отдельный шаг или прикрепляют к агенту.
Текст в чат или канал через Bot API.
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен Bot API Telegram |
chatId | string | Да | ID чата назначения |
text | string | Да | Текст сообщения |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Данные сообщения Telegram |
↳ message_id | number | Уникальный ID сообщения |
↳ from | object | Данные отправителя |
↳ id | number | ID чата |
↳ is_bot | boolean | Это бот или нет |
↳ first_name | string | Имя (если есть) |
↳ username | string | Username или название чата |
↳ id | number | ID бота |
↳ is_bot | boolean | Это бот или нет |
↳ first_name | string | Имя бота |
↳ username | string | Username бота |
↳ chat | object | Данные чата, куда ушло сообщение |
↳ id | number | ID чата |
↳ first_name | string | Имя бота |
↳ username | string | Username бота |
↳ type | string | Тип чата: private или channel |
↳ type | string | Тип чата: private или channel |
↳ date | number | Unix-время отправки |
↳ text | string | Текст отправленного сообщения |
Удаление сообщения по ID.
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен Bot API Telegram |
chatId | string | Да | ID чата назначения |
messageId | string | Да | ID сообщения для удаления |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Результат удаления |
↳ ok | boolean | Успех ответа API |
↳ deleted | boolean | Удалось ли удалить сообщение |
Фото в чат или канал.
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен Bot API Telegram |
chatId | string | Да | ID чата назначения |
photo | string | Да | Фото: file_id или HTTP URL |
caption | string | Нет | Подпись к фото |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Данные сообщения, включая фото |
↳ message_id | number | Уникальный ID сообщения |
↳ from | object | Данные отправителя |
↳ id | number | ID чата |
↳ is_bot | boolean | Это бот или нет |
↳ first_name | string | Имя (если есть) |
↳ username | string | Username или название чата |
↳ id | number | ID бота |
↳ is_bot | boolean | Это бот или нет |
↳ first_name | string | Имя бота |
↳ username | string | Username бота |
↳ chat | object | Данные чата |
↳ id | number | ID чата |
↳ first_name | string | Имя бота |
↳ username | string | Username бота |
↳ type | string | Тип чата: private, group, supergroup, channel |
↳ type | string | Тип чата: private, group, supergroup, channel |
↳ date | number | Unix-время отправки |
↳ text | string | Текст сообщения (если есть) |
↳ photo | array | Фото в сообщении |
↳ file_id | string | Уникальный file_id фото |
↳ file_unique_id | string | Стабильный ID файла между ботами |
↳ file_size | number | Размер файла в байтах |
↳ width | number | Ширина в пикселях |
↳ height | number | Высота в пикселях |
↳ file_id | string | Уникальный file_id фото |
↳ file_unique_id | string | Стабильный ID файла между ботами |
↳ file_size | number | Размер файла в байтах |
↳ width | number | Ширина в пикселях |
↳ height | number | Высота в пикселях |
Видео в чат или канал.
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен Bot API Telegram |
chatId | string | Да | ID чата назначения |
video | string | Да | Видео: file_id или HTTP URL |
caption | string | Нет | Подпись к видео |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Данные сообщения, включая медиа |
↳ message_id | number | Уникальный ID сообщения |
↳ from | object | Данные отправителя |
↳ id | number | ID отправителя |
↳ is_bot | boolean | Это бот или нет |
↳ first_name | string | Имя отправителя |
↳ username | string | Username отправителя |
↳ id | number | ID чата |
↳ is_bot | boolean | Это бот или нет |
↳ first_name | string | Имя чата (для лички) |
↳ username | string | Username чата (личка или канал) |
↳ chat | object | Данные чата |
↳ id | number | ID чата |
↳ first_name | string | Имя чата (для лички) |
↳ username | string | Username чата (личка или канал) |
↳ type | string | Тип чата: private, group, supergroup, channel |
↳ type | string | Тип чата: private, group, supergroup, channel |
↳ date | number | Unix-время отправки |
↳ text | string | Текст сообщения (если есть) |
↳ format | object | Формат медиа (видео, GIF и др.) |
↳ file_name | string | Имя файла медиа |
↳ mime_type | string | MIME-тип медиа |
↳ duration | number | Длительность в секундах |
↳ width | number | Ширина превью в пикселях |
↳ height | number | Высота превью в пикселях |
↳ thumbnail | object | Превью |
↳ file_id | string | file_id превью |
↳ file_unique_id | string | Стабильный ID превью |
↳ file_size | number | Размер превью в байтах |
↳ width | number | Ширина превью в пикселях |
↳ height | number | Высота превью в пикселях |
↳ file_id | string | file_id медиа |
↳ file_unique_id | string | Стабильный ID медиа |
↳ file_size | number | Размер медиа в байтах |
↳ thumb | object | Дубль превью (совместимость) |
↳ file_id | string | file_id превью |
↳ file_unique_id | string | Стабильный ID превью |
↳ file_size | number | Размер превью в байтах |
↳ width | number | Ширина превью в пикселях |
↳ height | number | Высота превью в пикселях |
↳ file_name | string | Имя документа |
↳ mime_type | string | MIME-тип документа |
↳ duration | number | Длительность в секундах |
↳ width | number | Ширина превью в пикселях |
↳ height | number | Высота превью в пикселях |
↳ thumbnail | object | Превью документа |
↳ file_id | string | file_id превью |
↳ file_unique_id | string | Стабильный ID превью |
↳ file_size | number | Размер превью в байтах |
↳ width | number | Ширина превью в пикселях |
↳ height | number | Высота превью в пикселях |
↳ file_id | string | file_id документа |
↳ file_unique_id | string | Стабильный ID документа |
↳ file_size | number | Размер документа в байтах |
↳ thumb | object | Дубль превью (совместимость) |
↳ file_id | string | file_id превью |
↳ file_unique_id | string | Стабильный ID превью |
↳ file_size | number | Размер превью в байтах |
↳ width | number | Ширина превью в пикселях |
↳ height | number | Высота превью в пикселях |
↳ document | object | Документ, если сообщение содержит файл |
↳ file_name | string | Имя документа |
↳ mime_type | string | MIME-тип документа |
↳ thumbnail | object | Превью документа |
↳ file_id | string | file_id превью |
↳ file_unique_id | string | Стабильный ID превью |
↳ file_size | number | Размер превью в байтах |
↳ width | number | Ширина превью в пикселях |
↳ height | number | Высота превью в пикселях |
↳ file_id | string | file_id документа |
↳ file_unique_id | string | Стабильный ID документа |
↳ file_size | number | Размер документа в байтах |
↳ width | number | Ширина превью в пикселях |
↳ height | number | Высота превью в пикселях |
↳ thumb | object | Дубль превью (совместимость) |
↳ file_id | string | file_id превью |
↳ file_unique_id | string | Стабильный ID превью |
↳ file_size | number | Размер превью в байтах |
↳ width | number | Ширина превью в пикселях |
↳ height | number | Высота превью в пикселях |
Аудиофайл в чат или канал.
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен Bot API Telegram |
chatId | string | Да | ID чата назначения |
audio | string | Да | Аудио: file_id или HTTP URL |
caption | string | Нет | Подпись к аудио |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Данные сообщения, включая аудио |
↳ message_id | number | Уникальный ID сообщения |
↳ from | object | Данные отправителя |
↳ id | number | ID отправителя |
↳ is_bot | boolean | Это бот или нет |
↳ first_name | string | Имя отправителя |
↳ username | string | Username отправителя |
↳ id | number | ID чата |
↳ is_bot | boolean | Это бот или нет |
↳ first_name | string | Имя чата (для лички) |
↳ username | string | Username чата (личка или канал) |
↳ chat | object | Данные чата |
↳ id | number | ID чата |
↳ first_name | string | Имя чата (для лички) |
↳ username | string | Username чата (личка или канал) |
↳ type | string | Тип чата: private, group, supergroup, channel |
↳ type | string | Тип чата: private, group, supergroup, channel |
↳ date | number | Unix-время отправки |
↳ text | string | Текст сообщения (если есть) |
↳ audio | object | Данные аудиофайла |
↳ duration | number | Длительность в секундах |
↳ performer | string | Исполнитель |
↳ title | string | Название трека |
↳ file_name | string | Исходное имя файла |
↳ mime_type | string | MIME-тип аудио |
↳ file_id | string | Уникальный file_id аудио |
↳ file_unique_id | string | Стабильный ID файла между ботами |
↳ file_size | number | Размер файла в байтах |
↳ duration | number | Длительность в секундах |
↳ performer | string | Исполнитель |
↳ title | string | Название трека |
↳ file_name | string | Исходное имя файла |
↳ mime_type | string | MIME-тип аудио |
↳ file_id | string | Уникальный file_id аудио |
↳ file_unique_id | string | Стабильный ID файла между ботами |
↳ file_size | number | Размер файла в байтах |
Анимация (GIF) в чат или канал.
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен Bot API Telegram |
chatId | string | Да | ID чата назначения |
animation | string | Да | Анимация: file_id или HTTP URL |
caption | string | Нет | Подпись к анимации |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Данные сообщения, включая медиа |
↳ message_id | number | Уникальный ID сообщения |
↳ from | object | Данные отправителя |
↳ id | number | ID отправителя |
↳ is_bot | boolean | Это бот или нет |
↳ first_name | string | Имя отправителя |
↳ username | string | Username отправителя |
↳ id | number | ID чата |
↳ is_bot | boolean | Это бот или нет |
↳ first_name | string | Имя чата (для лички) |
↳ username | string | Username чата (личка или канал) |
↳ chat | object | Данные чата |
↳ id | number | ID чата |
↳ first_name | string | Имя чата (для лички) |
↳ username | string | Username чата (личка или канал) |
↳ type | string | Тип чата: private, group, supergroup, channel |
↳ type | string | Тип чата: private, group, supergroup, channel |
↳ date | number | Unix-время отправки |
↳ text | string | Текст сообщения (если есть) |
↳ format | object | Формат медиа (видео, GIF и др.) |
↳ file_name | string | Имя файла медиа |
↳ mime_type | string | MIME-тип медиа |
↳ duration | number | Длительность в секундах |
↳ width | number | Ширина превью в пикселях |
↳ height | number | Высота превью в пикселях |
↳ thumbnail | object | Превью |
↳ file_id | string | file_id превью |
↳ file_unique_id | string | Стабильный ID превью |
↳ file_size | number | Размер превью в байтах |
↳ width | number | Ширина превью в пикселях |
↳ height | number | Высота превью в пикселях |
↳ file_id | string | file_id медиа |
↳ file_unique_id | string | Стабильный ID медиа |
↳ file_size | number | Размер медиа в байтах |
↳ thumb | object | Дубль превью (совместимость) |
↳ file_id | string | file_id превью |
↳ file_unique_id | string | Стабильный ID превью |
↳ file_size | number | Размер превью в байтах |
↳ width | number | Ширина превью в пикселях |
↳ height | number | Высота превью в пикселях |
↳ file_name | string | Имя документа |
↳ mime_type | string | MIME-тип документа |
↳ duration | number | Длительность в секундах |
↳ width | number | Ширина превью в пикселях |
↳ height | number | Высота превью в пикселях |
↳ thumbnail | object | Превью документа |
↳ file_id | string | file_id превью |
↳ file_unique_id | string | Стабильный ID превью |
↳ file_size | number | Размер превью в байтах |
↳ width | number | Ширина превью в пикселях |
↳ height | number | Высота превью в пикселях |
↳ file_id | string | file_id документа |
↳ file_unique_id | string | Стабильный ID документа |
↳ file_size | number | Размер документа в байтах |
↳ thumb | object | Дубль превью (совместимость) |
↳ file_id | string | file_id превью |
↳ file_unique_id | string | Стабильный ID превью |
↳ file_size | number | Размер превью в байтах |
↳ width | number | Ширина превью в пикселях |
↳ height | number | Высота превью в пикселях |
↳ document | object | Документ, если сообщение содержит файл |
↳ file_name | string | Имя документа |
↳ mime_type | string | MIME-тип документа |
↳ thumbnail | object | Превью документа |
↳ file_id | string | file_id превью |
↳ file_unique_id | string | Стабильный ID превью |
↳ file_size | number | Размер превью в байтах |
↳ width | number | Ширина превью в пикселях |
↳ height | number | Высота превью в пикселях |
↳ file_id | string | file_id документа |
↳ file_unique_id | string | Стабильный ID документа |
↳ file_size | number | Размер документа в байтах |
↳ width | number | Ширина превью в пикселях |
↳ height | number | Высота превью в пикселях |
↳ thumb | object | Дубль превью (совместимость) |
↳ file_id | string | file_id превью |
↳ file_unique_id | string | Стабильный ID превью |
↳ file_size | number | Размер превью в байтах |
↳ width | number | Ширина превью в пикселях |
↳ height | number | Высота превью в пикселях |
Документ (PDF, ZIP, DOC и др.) в чат или канал.
| Параметр | Тип | Обязательный | Описание |
|---|
botToken | string | Да | Токен Bot API Telegram |
chatId | string | Да | ID чата назначения |
files | file[] | Нет | Файл документа (PDF, ZIP, DOC и др.). Макс. 50 МБ |
caption | string | Нет | Подпись к документу |
| Параметр | Тип | Описание |
|---|
message | string | Сообщение об успехе или ошибке |
data | object | Данные сообщения, включая документ |
↳ message_id | number | Уникальный ID сообщения |
↳ from | object | Данные отправителя |
↳ id | number | ID отправителя |
↳ is_bot | boolean | Это бот или нет |
↳ first_name | string | Имя отправителя |
↳ username | string | Username отправителя |
↳ id | number | ID чата |
↳ is_bot | boolean | Это бот или нет |
↳ first_name | string | Имя чата (для лички) |
↳ username | string | Username чата (личка или канал) |
↳ chat | object | Данные чата |
↳ id | number | ID чата |
↳ first_name | string | Имя чата (для лички) |
↳ username | string | Username чата (личка или канал) |
↳ type | string | Тип чата: private, group, supergroup, channel |
↳ type | string | Тип чата: private, group, supergroup, channel |
↳ date | number | Unix-время отправки |
↳ document | object | Данные документа |
↳ file_name | string | Имя файла |
↳ mime_type | string | MIME-тип |
↳ file_id | string | file_id документа |
↳ file_unique_id | string | Стабильный ID документа |
↳ file_size | number | Размер файла в байтах |
↳ file_name | string | Имя файла |
↳ mime_type | string | MIME-тип |
↳ file_id | string | file_id документа |
↳ file_unique_id | string | Стабильный ID документа |
↳ file_size | number | Размер файла в байтах |
