Telegram Bot (независимый издатель)
API Telegram Bot — это http-интерфейс, созданный для разработчиков, стремящихся создавать боты для Telegram.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Woong Choi |
| URL | https://www.linkedin.com/in/woongchoi/ |
| Адрес электронной почты | woong.choi@rapidcircle.com |
| Метаданные соединителя | |
|---|---|
| Publisher | Woong Choi |
| Веб-сайт | https://telegram.org/ |
| Политика конфиденциальности | https://telegram.org/privacy |
| Категории | Communication |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Отправка сообщения |
Используйте этот метод для отправки текстовых сообщений |
| Отправка фотографии |
Используйте этот метод для отправки фотографий. |
| Получение обновлений |
Используйте этот метод для получения входящих обновлений с помощью длинного опроса |
| Получение чата |
Используйте этот метод, чтобы получить актуальные сведения о чате |
| Получить меня |
Возвращает основные сведения о боте в виде объекта User. Простой метод тестирования маркера проверки подлинности бота. |
Отправка сообщения
Используйте этот метод для отправки текстовых сообщений
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Токен бота
|
token | True | string |
Токен Telegram Bot. например, 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11 |
|
Идентификатор чата
|
chat_id | string |
chat_id |
|
|
Текст
|
text | string |
Текст для отправки |
|
|
Режим синтаксического анализа
|
parse_mode | string |
Режим синтаксического анализа сущностей в тексте сообщения. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Хорошо
|
ok | boolean |
Хорошо |
|
Message
|
result | Message |
Этот объект представляет сообщение. |
Отправка фотографии
Используйте этот метод для отправки фотографий.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Токен бота
|
token | True | string |
Токен Telegram Bot. например, 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11 |
|
Идентификатор чата
|
chat_id | string |
chat_id |
|
|
Фото
|
photo | string |
Фотоослать |
Возвращаемое значение
Этот объект представляет сообщение.
- Message
- Message
Получение обновлений
Используйте этот метод для получения входящих обновлений с помощью длинного опроса
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Токен бота
|
token | True | string |
Токен Telegram Bot. например, 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11 |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
ХОРОШО
|
ok | boolean |
Запрос успешно выполнен |
|
результат
|
result | array of Update |
результат |
Получение чата
Используйте этот метод, чтобы получить актуальные сведения о чате
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Токен бота
|
token | True | string |
Токен Telegram Bot. например, 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11 |
|
Идентификатор чата
|
chat_id | string |
chat_id |
Возвращаемое значение
Этот объект представляет сообщение.
- Message
- Message
Получить меня
Возвращает основные сведения о боте в виде объекта User. Простой метод тестирования маркера проверки подлинности бота.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Токен бота
|
token | True | string |
Токен Telegram Bot. например, 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11 |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
ХОРОШО
|
ok | boolean |
Запрос успешно выполнен |
|
User
|
result | User |
Этот объект представляет пользователя Или бота Telegram |
Определения
Chat
Этот объект представляет чат
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор чата
|
id | integer |
Уникальный идентификатор для этого чата |
|
Имя (Первое имя)
|
first_name | string |
Имя другой стороны в частном чате |
|
Фамилия
|
last_name | string |
Фамилия другой стороны в частном чате |
|
Имя пользователя
|
username | string |
Имя пользователя, для частных чатов, супергрупп и каналов при наличии |
|
Chat
|
type | string |
Тип чата может быть "частным", "group", "supergroup" или "channel" |
Update
Этот объект представляет входящее обновление.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор обновления
|
update_id | integer |
Уникальный идентификатор обновления. |
|
Message
|
message | Message |
Этот объект представляет сообщение. |
Message
Этот объект представляет сообщение.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор сообщения
|
message_id | integer |
Уникальный идентификатор сообщения в этом чате |
|
User
|
from | User |
Этот объект представляет пользователя Или бота Telegram |
|
Chat
|
chat | Chat |
Этот объект представляет чат |
|
Date
|
date | integer |
Дата отправки сообщения в unix |
|
Текст
|
text | string |
Для текстовых сообщений фактический текст сообщения UTF-8, 0–4096 символов |
User
Этот объект представляет пользователя Или бота Telegram
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
id | integer |
Уникальный идентификатор для этого пользователя или бота |
|
Является ботом
|
is_bot | boolean |
Значение true, если этот пользователь является ботом |
|
Имя (Первое имя)
|
first_name | string |
Имя пользователя или бота |
|
Фамилия
|
last_name | string |
Фамилия пользователя или бота |
|
Имя пользователя
|
username | string |
Имя пользователя или имя пользователя бота |
|
Код языка
|
language_code | string |
Тег языка IETF языка пользователя |
|
Может присоединяться к группам
|
can_join_groups | boolean |
Значение true, если бот может быть приглашен в группы. |
|
Может считывать все сообщения группы
|
can_read_all_group_messages | boolean |
Значение true, если режим конфиденциальности отключен для бота. |
|
Поддерживает встроенные запросы
|
supports_inline_queries | boolean |
Значение true, если бот поддерживает встроенные запросы. |