← API 参考
渠道方对比

统一消息发送能力

当前 POST /v1/messages 适配器已映射的消息载荷。实际开放范围与上游可用性仍可能因账号和区域而异。

能力

能力TelegramWhatsAppXLINEZaloTikTok
text 文本完整支持完整支持完整支持完整支持完整支持完整支持
image 图片完整支持完整支持完整支持完整支持完整支持完整支持
video 视频完整支持完整支持完整支持完整支持完整支持完整支持
audio 音频完整支持完整支持部分支持完整支持完整支持不支持
document 文件完整支持完整支持完整支持完整支持完整支持不支持
file 文件完整支持完整支持完整支持完整支持完整支持不支持
contact 联系人名片不支持完整支持不支持不支持不支持不支持
reply_to.reply_token 引用回复不支持完整支持不支持不支持不支持不支持
mentions @ 成员不支持完整支持不支持部分支持不支持不支持
provider_data.parse_mode 富文本完整支持不支持不支持不支持不支持不支持

备注

  • WhatsApp 音频消息的 content 必须是 JSON 字符串 {"url":"...","seconds":N,"waveform":"..."}，其中只有 url 是必填。
  • parse_mode（Markdown / HTML）目前只在 Telegram 上完整生效，其他渠道会忽略该字段。
  • X 仅接受作为媒体附件的音频，不支持独立的语音消息。
  • X 会把 document 载荷作为媒体附件发送；仍需遵守上游的文件类型和大小限制。
  • reply_to.reply_token 用于引用回复：把入站事件里的 data.message.reply_token 原样回传。当前仅 WhatsApp 支持——其他渠道返回 501 unsupported_by_provider；token 被篡改返回 400 invalid_reply_token。
  • mentions 用于群消息 @ 成员：在 mentions 数组里声明 id，并在 text / caption 中放置 {{@<id>}} 锚点。WhatsApp 支持文本与媒体 caption；LINE 当前只支持文本 mention。其他渠道忽略该字段。provider_data.mentions 已废弃。
  • TikTok 的 image / video 仅支持 url 或 file_url，不支持 caption 与 mentions。