WebHook 说明
极客通讯支持通过 WebHook 将通话事件、消息事件等实时推送到您的服务器。
配置 WebHook
在用户控制台 > 应用设置中配置您的 WebHook 接收地址。
推送事件类型
| 事件类型 | 说明 | 推送时机 |
|---|---|---|
room.created | 房间创建 | 通话房间创建时 |
room.joined | 用户加入 | 有用户加入房间时 |
room.left | 用户离开 | 用户离开或房间关闭时 |
message.sent | 消息发送 | 消息发送成功时 |
package.expiring | 套餐即将过期 | 套餐到期前3天 |
WebHook 推送示例
{
"event": "room.created",
"timestamp": 1715164800,
"data": {
"room_id": "room_abc123",
"type": "video",
"creator_id": 1,
"created_at": "2024-05-08T14:30:00+08:00"
}
}
安全验证： 每个 WebHook 请求都包含 X-GeekIM-Signature 头部，使用您的 AppSecret 进行 HMAC-SHA256 签名验证。
极客通讯 GeekIM — 极客工作室出品 · 文档版本 v1.0