一场完整的直播,会经历 预约直播/开始直播/结束直播 等一系列状态变更。为了让企业实时获取直播的动态,当直播状态变更后,企业微信会将该变更推送到开发者配置的回调URL
。只有通过接口创建的预约/立即直播才会回调。接收并解析事件的方法见:接收事件
请注意,只有用企业微信api创建的直播
才能收到回调,且调用创建直播接口的应用,要配置好回调url
。
示例
xml请求示例:
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1348831860</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[living_status_change]]></Event>
<LivingId><![CDATA[LivingId]]></LivingId>
<Status>1</Status>
<AgentID>1</AgentID>
</xml>
说明
参数 | 说明 |
---|---|
ToUserName | 企业微信CorpID |
FromUserName | 成员UserID |
CreateTime | 消息创建时间,unix时间戳 |
MsgType | 消息类型,此时固定为:event |
Event | 事件类型,此时固定为:living_status_change |
LivingId | 直播ID |
Status | 直播状态 ,0:预约中,1:直播中,2:已结束,4:已取消 (已过期状态目前没有回调) |
AgentID | 企业应用的id,整型。可在应用的设置页面查看 |