API 參考
渠道方對比

統一動作能力矩陣

目前轉接器原始碼已映射的訊息、會話、標籤、聯絡人與群組管理動作。未實作組合回傳 501 unsupported_by_provider;真實可用性仍可能受帳號與上游渠道影響。

能力

能力TelegramWhatsAppXLINEZaloTikTok
messages/pin 置頂訊息不支援完整支援不支援不支援不支援不支援
messages/revoke 撤回完整支援完整支援不支援完整支援不支援不支援
messages/reaction 表情回應完整支援完整支援不支援不支援不支援不支援
messages/edit 編輯不支援完整支援不支援不支援不支援不支援
conversations 會話清單完整支援完整支援完整支援完整支援不支援完整支援
conversations/info 會話詳情完整支援完整支援完整支援完整支援不支援不支援
conversations/members 成員完整支援完整支援不支援完整支援不支援不支援
conversations/read 標記已讀不支援完整支援不支援不支援不支援不支援
conversations/unread 標記未讀不支援完整支援不支援不支援不支援不支援
conversations/mute 靜音不支援完整支援不支援部分支援不支援不支援
conversations/unmute 取消靜音不支援完整支援不支援完整支援不支援不支援
conversations/pin 置頂會話不支援完整支援不支援完整支援不支援不支援
conversations/unpin 取消置頂不支援完整支援不支援完整支援不支援不支援
conversations/labels 標籤列表不支援完整支援不支援不支援不支援不支援
conversations/labels 新增或更新標籤不支援完整支援不支援不支援不支援不支援
conversations/labels 刪除標籤不支援完整支援不支援不支援不支援不支援
conversations/labels/members 標籤成員不支援完整支援不支援不支援不支援不支援
contacts 聯絡人清單不支援完整支援不支援完整支援不支援不支援
contacts/info 聯絡人詳情不支援完整支援不支援完整支援不支援不支援
contacts/add 新增聯絡人不支援完整支援不支援不支援不支援不支援
contacts/membership 聯絡人狀態不支援完整支援不支援不支援不支援不支援
contacts/block 封鎖不支援完整支援不支援不支援不支援不支援
contacts/unblock 解除封鎖不支援完整支援不支援不支援不支援不支援
contacts/blocklist 黑名單不支援完整支援不支援不支援不支援不支援
contacts/note 備註不支援完整支援不支援不支援不支援不支援
groups 群組清單不支援完整支援不支援完整支援不支援不支援
groups/info 群組詳情不支援完整支援不支援完整支援不支援不支援
groups/create 建立群組不支援完整支援不支援不支援不支援不支援
groups/leave 退出群組不支援完整支援不支援不支援不支援不支援
groups/members 成員管理不支援完整支援不支援不支援不支援不支援
groups/update-info 改群組資訊不支援完整支援不支援不支援不支援不支援
groups/join-requests 入群審核不支援完整支援不支援不支援不支援不支援
groups/join-approval-mode 審核開關不支援完整支援不支援不支援不支援不支援
groups/invite-code 邀請碼不支援完整支援不支援不支援不支援不支援

備註

  • 未實作的「渠道 × 動作」組合固定回傳 501 unsupported_by_provider 且無副作用,可放心用真實呼叫做能力偵測。
  • 動作類介面的識別碼與 webhook 事件閉環:conversation_id = data.conversation.id,message_id = data.message.id,sender_id = data.sender.id。sender_id 可選,預設為帳號自身。
  • conversations/pin 置頂整個會話(無時長參數);messages/pin 置頂會話內單則訊息(pinned 布林 + 可選 duration_seconds)。
  • 目前 X 轉接器不提供會話成員清單;呼叫 conversations/members 會回傳 501 unsupported_by_provider。
  • 目前原始碼僅將私聊映射為 message.received;群聊、ACK、notice 與 comment 不屬於公開標準事件。原始碼支援不等於真實帳號 E2E 已驗證。