Telegram Bot （独立发布者）
Telegram 机器人 API 是一个基于 HTTP 的接口，是为热衷于为 Telegram 构建机器人的开发人员创建的。
此连接器在以下产品和区域中可用：
| 服务 | Class | 区域 |
|---|---|---|
| Copilot Studio | 高级 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 逻辑应用程序 | 标准 | 除以下各项外的所有 逻辑应用区域 ： - Azure 政府区域 - Azure 中国区域 - 美国国防部（DoD） |
| Power Apps | 高级 | 除以下各项外的所有 Power Apps 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| Power Automate | 高级 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 联系人 | |
|---|---|
| Name | Woong Choi |
| URL | https://www.linkedin.com/in/woongchoi/ |
| woong.choi@rapidcircle.com |
| 连接器元数据 | |
|---|---|
| 发布者 | Woong Choi |
| 网站 | https://telegram.org/ |
| 隐私策略 | https://telegram.org/privacy |
| 类别 | Communication |
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 100 | 60 秒 |
操作
| 发送消息 |
使用此方法发送短信 |
| 发送照片 |
使用此方法发送照片。 |
| 获取我 |
以 User 对象的形式返回有关机器人的基本信息。 用于测试机器人身份验证令牌的简单方法。 |
| 获取更新 |
使用此方法通过长时间轮询接收传入更新 |
| 获取聊天 |
使用此方法获取有关聊天的最新信息 |
发送消息
使用此方法发送短信
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
机器人令牌
|
token | True | string |
Telegram 机器人令牌。 例如123456：ABC-DEF1234ghIkl-zyx57W2v1u123ew11 |
|
聊天 ID
|
chat_id | string |
chat_id |
|
|
文本
|
text | string |
要发送的文本 |
|
|
分析模式
|
parse_mode | string |
消息文本中分析实体的模式。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
还行
|
ok | boolean |
还行 |
|
Message
|
result | Message |
此对象表示消息。 |
发送照片
使用此方法发送照片。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
机器人令牌
|
token | True | string |
Telegram 机器人令牌。 例如123456：ABC-DEF1234ghIkl-zyx57W2v1u123ew11 |
|
聊天 ID
|
chat_id | string |
chat_id |
|
|
照片
|
photo | string |
Phototo send |
返回
此对象表示消息。
- Message
- Message
获取我
以 User 对象的形式返回有关机器人的基本信息。 用于测试机器人身份验证令牌的简单方法。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
机器人令牌
|
token | True | string |
Telegram 机器人令牌。 例如123456：ABC-DEF1234ghIkl-zyx57W2v1u123ew11 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
好的
|
ok | boolean |
请求成功 |
|
用户
|
result | User |
此对象表示 Telegram 用户或机器人 |
获取更新
使用此方法通过长时间轮询接收传入更新
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
机器人令牌
|
token | True | string |
Telegram 机器人令牌。 例如123456：ABC-DEF1234ghIkl-zyx57W2v1u123ew11 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
好的
|
ok | boolean |
请求成功 |
|
结果
|
result | array of Update |
结果 |
获取聊天
使用此方法获取有关聊天的最新信息
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
机器人令牌
|
token | True | string |
Telegram 机器人令牌。 例如123456：ABC-DEF1234ghIkl-zyx57W2v1u123ew11 |
|
聊天 ID
|
chat_id | string |
chat_id |
返回
此对象表示消息。
- Message
- Message
定义
Chat
此对象表示聊天
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
聊天 ID
|
id | integer |
此聊天的唯一标识符 |
|
名字
|
first_name | string |
私人聊天中对方的名字 |
|
姓氏
|
last_name | string |
私人聊天中对方的姓氏 |
|
用户名
|
username | string |
用户名，用于私人聊天、超级组和频道（如果可用） |
|
Chat
|
type | string |
聊天类型，可以是“private”、“group”、“supergroup”或“channel” |
Update
此对象表示传入的更新。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
更新 ID
|
update_id | integer |
更新的唯一标识符。 |
|
Message
|
message | Message |
此对象表示消息。 |
Message
此对象表示消息。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
消息 ID
|
message_id | integer |
此聊天中的唯一消息标识符 |
|
用户
|
from | User |
此对象表示 Telegram 用户或机器人 |
|
Chat
|
chat | Chat |
此对象表示聊天 |
|
日期
|
date | integer |
在 Unix 时间发送消息的日期 |
|
文本
|
text | string |
对于短信，消息的实际 UTF-8 文本，0-4096 个字符 |
用户
此对象表示 Telegram 用户或机器人
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
id | integer |
此用户或机器人的唯一标识符 |
|
是机器人
|
is_bot | boolean |
如此，如果此用户是机器人 |
|
名字
|
first_name | string |
用户或机器人的名字 |
|
姓氏
|
last_name | string |
用户或机器人的姓氏 |
|
用户名
|
username | string |
用户的用户名或机器人的用户名 |
|
语言代码
|
language_code | string |
用户语言的 IETF 语言标记 |
|
可以加入组
|
can_join_groups | boolean |
如此，如果机器人可以邀请到组。 |
|
可以读取所有组消息
|
can_read_all_group_messages | boolean |
如此，如果为机器人禁用了隐私模式。 |
|
支持内联查询
|
supports_inline_queries | boolean |
如此，如果机器人支持内联查询。 |