Поделиться через


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, если бот поддерживает встроенные запросы.