Telegram MTProto
Взаимодействие с Telegram через протокол MTProto — отправка сообщений, история чатов, список диалогов
Telegram MTProto — это собственный protocol powering the Telegram platform, offering lower-level access compared to the Bot API. It allows reading message history from regular accounts, listing all accessible dialogs, и sending messages programmatically.
С помощью Telegram MTProto интеграции в AACFlow можно:
- Отправить messages: Dispatch text messages to any chat, group, или channel accessible to the account
- Получить history: Получить message history of a conversation
- Список dialogs: Enumerate all dialogs (chats, groups, channels) available to the authenticated account
This integration — это ideal для automation scenarios that require access beyond the Bot API scope, such as reading existing conversations или working с personal Telegram accounts.
Инструкции по использованию
Интегрируйте Telegram MTProto в рабочий процесс. Требуется API ID и API Hash from my.telegram.org, и a session string для user account access (or a Bot Token для Bot API fallback).
Инструменты
telegram_mtproto_send_message
Отправить a message to a Telegram chat
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
apiId | string | Да | API ID from my.telegram.org, or Bot Token for Bot API |
apiHash | string | Да | API Hash from my.telegram.org |
sessionString | string | Нет | Serialized session string for user account auth |
chatId | string | Да | Target chat ID or username |
message | string | Да | Text message to send |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
messageId | number | ID of the sent message |
success | boolean | Произошла ли message was sent |
telegram_mtproto_get_history
Получить message history from a chat
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
apiId | string | Да | API ID or Bot Token |
apiHash | string | Да | API Hash |
sessionString | string | Нет | Session string |
chatId | string | Да | Chat ID or username |
limit | number | Нет | Number of messages to retrieve |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
messages | array | Массив message objects |
count | number | Total messages returned |
telegram_mtproto_get_dialogs
Список всех accessible dialogs
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
apiId | string | Да | API ID or Bot Token |
apiHash | string | Да | API Hash |
sessionString | string | Нет | Session string |
limit | number | Нет | Maximum dialogs to return |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
dialogs | array | Массив dialog objects (chats, groups, channels) |
Ссылки
- Official API: https://core.telegram.org/api
- AACFlow block source: apps/aacflow/blocks/blocks/telegram_mtproto.ts