API 消息推送与 Webhook 事件回调
这里是 Ant Messenger 的功能说明页。我们把客户端可以直接使用的聊天能力,与可以通过接口调用的消息能力放在一起说明,方便团队判断哪一部分适合直接上手、哪一部分需要技术同学接一下。
文中数值均为官方公布的规格,实际可用范围以你所安装的版本为准。
官方公布的规格
- 部署:私有化部署与云托管,可任选其一。
- 加密:端到端加密,消息内容在两端处理。
- 设备:同一账号最多 5 台设备同时在线。
- 群组:单群上限 10 万人,群消息经 TLS 传输。
- 消息:文字、语音、视频、图片、文件、位置、表情、名片、通话。
- 存储:云盘文件高强度加密,不限容量、不限时间。
可以直接用的部分
一对一与群聊
建群、拉人、发公告与置顶,最大支持 10 万人的群。
语音与通话
语音消息、视频通话与多方通话在同一会话内完成。
文件与云盘
大文件直接发送,常用文件存入云盘长期保留。
身份控制
隐藏手机号与用户 ID,为应用开启应用锁。
需要通过接口调用的部分
如果你希望把系统里的信息推到聊天里,我们提供三条路径,官方文档均有对应说明。
服务端 API 推送
由服务端调用接口,把消息推送到指定会话或指定成员。适合审批结果、工单进度、告警通知这类由系统主动发起的消息,支持卡片形式,按钮可回传操作结果。
Webhook 事件回调
当会话中发生指定事件时,我们向你的回调地址推送事件数据,包括消息、群成员变更等。接收方按回调签名校验来源,再决定后续处理。
机器人入群
机器人以成员身份加入群聊,既能接收群内消息,也能主动发言。它和普通成员共享同一套群权限,管理员可随时移除。
官方说明:接口能力属于可选项。不使用任何接口时,客户端本身即为完整的聊天工具。
平台与版本
我们提供安卓、iPhone 或 iPad、Mac(M1)与 Windows 四个平台的版本。桌面端首次登录由手机端扫码完成,不单独设置密码入口。每个账号最多 5 台设备同时在线,会话状态在设备之间保持一致。
常见疑问
不用接口,功能会不会少?
不会。接口是给系统对接用的附加能力,客户端本身的聊天、群组、文件与通话功能不受影响。
接口能推送到哪些会话?
可以推送到指定成员的一对一会话,也可以推送到机器人所在的群,具体以官方文档的接口说明为准。
机器人算不算群成员?
算。机器人以成员身份存在,占用成员名额,受同样的群管理规则约束。