完成回调配置后,企业直播将在触发回调时,向您设置的回调地址发送回调消息,实现业务流程自动化。例如,当观众在观看页领取卡券时,企业直播会发送回调消息,您可根据回调消息中的卡券领取结果,在自己的商城系统向指定观众发放卡券。本文介绍如何完成回调配置,以确保您接收到所需的回调消息。
前提条件
- 确保您拥有火山引擎主账号或具备开发集成 > 可编辑权限的子账号。有关如何添加子账号,详见子账号管理。
- 确保您已开通尊享版套餐。详见计费说明。
步骤一:设置回调消息配置
登录企业直播控制台。
在顶部导航栏,单击账户中心。
在左侧导航栏,选择开发集成 > 回调配置。
在需要接收的回调消息右侧,单击新增配置。

在弹出的新增回调配置对话框中,完成以下配置并单击确定。

- 回调地址:填写需要接收回调消息的接口地址,必须以 HTTPS 或 HTTP 开头。您也可以单击新增地址,配置至多 10 个回调地址。
- 回调生效账号:选择回调生效的账号。默认选择主账号。如选择指定子账号,则仅当该子账号的资源触发回调时,才会向设置的回调地址发送回调消息。例如,您为卡券领取批量聚合回调选择子账号 A 作为回调生效账号,则只有当观众在子账号 A 创建的直播间领取卡券时,企业直播才会发送回调消息到对应的回调地址。
您可以为同一个回调消息配置多个回调生效账号,并为每个回调生效账号设置一个或多个回调地址。不同回调生效账号的鉴权密钥(AccountSecret 取值)不同,该密钥用于计算回调的校验签名。
步骤二:获取鉴权密钥
设置回调消息配置后,您可以完成以下步骤,获取指定回调生效账号的鉴权密钥(AccountSecret 取值)。
- 登录企业直播控制台。
- 在顶部导航栏,单击账户中心。
- 在左侧导航栏,选择开发集成 > 回调配置。
- 在需要接收的回调消息右侧,单击详情。

- 在弹出的配置详情对话框中,单击指定回调生效账号右侧的复制鉴权密钥,即可获取该账号的鉴权密钥。

您也可以根据回调地址或回调生效账号进行筛选。其中,回调地址支持模糊搜索,回调生效账号支持多选。

相关操作
管理回调消息配置
设置回调消息配置后,您可以完成以下步骤,编辑或删除已添加的回调消息配置。
- 登录企业直播控制台。
- 在顶部导航栏,单击账户中心。
- 在左侧导航栏,选择开发集成 > 回调配置。
- 在需要编辑或删除的回调消息配置右侧,单击详情。

- 在弹出的配置详情对话框中,单击指定回调生效账号右侧的编辑或删除。

- 单击编辑后,可在弹出的更新回调配置对话框中,修改回调地址或回调生效账号。
- 单击删除后,相关回调地址将无法接收回调消息,请谨慎操作。
您也可以根据回调地址或回调生效账号进行筛选。其中,回调地址支持模糊搜索,回调生效账号支持多选。
