Telegram Bot（獨立出版商）
Telegram Bot API 是一個基於 HTTP 的介面，專為熱衷於為 Telegram 建立機器人的開發人員而創建。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 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 物件的形式傳回 Bot 的基本資訊。 測試機器人驗證權杖的簡單方法。 |
| 獲取更新 |
使用此方法，使用長輪詢來接收傳入更新 |
| 獲取聊天室 |
使用此方法獲取有關聊天的最新信息 |
| 發送照片 |
使用此方法發送照片。 |
傳送訊息
使用此方法發送簡訊
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
機器人代幣
|
token | True | string |
Telegram 機器人代幣。 例如123456：ABC-DEF1234ghIkl-zyx57W2v1u123ew11 |
|
聊天 ID
|
chat_id | string |
chat_id |
|
|
文字
|
text | string |
要傳送的文字 |
|
|
解析模式
|
parse_mode | string |
剖解析訊息文字中實體的模式。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
好
|
ok | boolean |
好 |
|
Message
|
result | Message |
此物件代表訊息。 |
找我
以 User 物件的形式傳回 Bot 的基本資訊。 測試機器人驗證權杖的簡單方法。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
機器人代幣
|
token | True | string |
Telegram 機器人代幣。 例如123456：ABC-DEF1234ghIkl-zyx57W2v1u123ew11 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
OK
|
ok | boolean |
請求成功 |
|
User
|
result | User |
此物件代表 Telegram 使用者或機器人 |
獲取更新
使用此方法，使用長輪詢來接收傳入更新
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
機器人代幣
|
token | True | string |
Telegram 機器人代幣。 例如123456：ABC-DEF1234ghIkl-zyx57W2v1u123ew11 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
OK
|
ok | boolean |
請求成功 |
|
結果
|
result | array of Update |
結果 |
獲取聊天室
使用此方法獲取有關聊天的最新信息
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
機器人代幣
|
token | True | string |
Telegram 機器人代幣。 例如123456：ABC-DEF1234ghIkl-zyx57W2v1u123ew11 |
|
聊天 ID
|
chat_id | string |
chat_id |
傳回
此物件代表訊息。
- Message
- Message
發送照片
使用此方法發送照片。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
機器人代幣
|
token | True | string |
Telegram 機器人代幣。 例如123456：ABC-DEF1234ghIkl-zyx57W2v1u123ew11 |
|
聊天 ID
|
chat_id | string |
chat_id |
|
|
相片
|
photo | string |
相片傳送 |
傳回
此物件代表訊息。
- Message
- Message
定義
Chat
此物件代表聊天
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
聊天 ID
|
id | integer |
此聊天的唯一識別碼 |
|
名字
|
first_name | string |
私聊中對方的名字 |
|
姓氏
|
last_name | string |
私聊中對方的姓氏 |
|
使用者名
|
username | string |
用戶名，用於私人聊天、超級群組和頻道（如果有） |
|
Chat
|
type | string |
聊天類型，可以是“私人”、“群組”、“超級群組”或“頻道” |
Update
此物件代表傳入更新。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
更新標識碼
|
update_id | integer |
更新的唯一識別碼。 |
|
Message
|
message | Message |
此物件代表訊息。 |
Message
此物件代表訊息。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
訊息 ID
|
message_id | integer |
此聊天中的唯一訊息識別碼 |
|
User
|
from | User |
此物件代表 Telegram 使用者或機器人 |
|
Chat
|
chat | Chat |
此物件代表聊天 |
|
Date
|
date | integer |
郵件以 Unix 時間傳送的日期 |
|
文字
|
text | string |
對於簡訊，訊息的實際 UTF-8 文字，0-4096 個字元 |
User
此物件代表 Telegram 使用者或機器人
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
ID
|
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，如果機器人支援內嵌查詢。 |