You need to enable JavaScript to run this app.
导航
飞书客户端内企业直播子账号申请回调
最近更新时间:2024.11.27 10:47:15首次发布时间:2024.11.27 10:47:15

作用

当不具备企业直播子账号的飞书用户在飞书客户端的直播入口点击申请子账号时,企业直播会对所设置的接口地址进行回调通知。
Image

前提条件

您已在企业直播控制台账户中心 > 品牌定制 > 控制台页面,将飞书开播权限设置为指定成员
Image

使用流程

如需在飞书用户点击申请子账号后跳转到指定的飞书机器人,而非火山引擎企业直播飞书机器人,可使用该回调。具体流程如下:

  1. 登录飞书开放平台,单击您的飞书应用,获取应用的 App ID。
    Image
  2. 联系企业直播技术支持,并提供该 App ID。在飞书用户点击申请子账号后,即可跳转到该应用的飞书机器人,而非火山引擎企业直播飞书机器人。
  3. 触发回调后,您可以根据回调通知,调用 CreateSubAccount 接口创建企业直播子账号。

配置方式

将接收回调通知的接口地址提供给企业直播技术支持。

详情

设置回调的接口地址后,当不具备企业直播子账号的飞书用户在飞书客户端的直播入口点击申请子账号时,企业直播会将飞书用户在您飞书应用中的 union_id 以及子账号申请时间以 POST 方式提交给您自定义的回调接口地址。
请求示例如下所示:

POST /xxxxx HTTP/1.1
Header1: ...
Header2: ...
...
{
    "Sign": "acc2bbe38e67****5760411992f4167e",
    "ApplyTime": "1731400614",
    "CustomerLarkUserUnionId": "on_1111111111111111",
    "EventType": "ApplyCreateLarkSubAccountCallBack",
    "RequestUuid": "ApplyCreateLarkSubAccountCallBack-18136904****6208",
}

超时重试

回调服务器在发送消息通知后,5 秒内没有收到您的服务器的响应,即认为通知失败。后续会以 5 秒为间隔继续重试 2 次。

参数

说明

请联系技术支持获取鉴权 AccountSecret

参数

类型

说明

Sign

String

校验签名。
完成以下步骤,计算校验签名。

  1. 按照 AccountSecretApplyTimeCustomerLarkUserUnionIdEventType 的顺序,拼接对应的参数值。
  2. 将拼接后的内容进行 MD5 加密生成 32 位小写字符串。

ApplyTime

String

子账号申请时间。Unix 时间戳,单位为秒。

CustomerLarkUserUnionId

String

飞书用户在您飞书应用中的 union_id

说明

  • union_id 是用户在同一应用服务商所开发的多个应用下的身份标识。详见飞书官方文档
  • 您必须提供您的飞书租户信息以及应用信息,完成相关申请,才可以获取用户的 union_id

EventType

String

回调通知的事件类型,固定取值为 ApplyCreateLarkSubAccountCallBack

RequestUuid

String

请求回调的唯一标识。