渠道说明
各渠道支持的功能
调用前确认渠道是否支持目标操作。不支持的组合返回 501 unsupported_by_provider;实际可用性还取决于账号状态和渠道服务。
能力
| 能力 | Telegram | X | LINE | Zalo | TikTok | WhatsApp Protocol | |
|---|---|---|---|---|---|---|---|
| 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 邀请码 | 不支持 | 完整支持 | 不支持 | 不支持 | 不支持 | 不支持 | 不支持 |
备注
- 支持 text、image 和联系人详情;不支持引用回复、mentions、联系人列表及写动作、会话或群组操作。事件映射包括文本/图片 message.received、account.started、account.status.updated、account.auth.failed;实际投递仍取决于上游账号。
- 调用前先查渠道能力表。收到 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 已验证。