HiConf 电话会议二次开发文档

一、电话会议业务流程与接口地址 二、可用的接口功能 2.1 召集会议 2.2 添加参会人 2.3 结束会议 2.4 全体静音 2.5 除主持人外全体静音 2.6 全体发言 2.7 单个静音 2.8 单个发言 2.9 挂断单个参会人 2.10 重呼单个参会人 2.11 开始录音 2.12 停止录音 2.13 锁定会议 2.14 解锁会议 2.15 转移主持人 2.16 申请发言权限 2.17 更新一场会议的名称 2.18 更新一场会议的CustomData标记内容 2.19 更新一个会议参与者的姓名 2.20 查询一场正在召开的会议的状态 2.21 查询一个会议成员的状态 2.22 查询一场历史会议 2.23 创建一个新的呼入会议室 2.24 删除一个呼入会议室 2.25 修改一个呼入式会议室配置 2.26 为会议室生成新的密码组 2.27 查询所有呼入式会议室 2.28 查询单个呼入式会议室 2.29 开始对会议室放音 2.30 停止对会议室放音 三、回调消息的推送地址和接收响应 四、可用的回调消息 4.1 外呼式会议起始 4.2 开始呼叫主持人 4.3 主持人接通 4.4 主持人挂断 4.5 开始呼叫参会人 4.6 参会人接通 4.7 参会人挂断 4.8 外呼式会议结束 4.9 呼入式会议起始 4.10 参与者以参会人身份加入会议室 4.11 呼入式会议结束 4.12 某个会议参与者被设置为主持人 4.13 某个会议参与者被静音 4.14 某个会议参与者被取消静音 4.15 某个会议参与者申请发言权限 4.16 推送本次会议日志

4.9、呼入式会议起始

消息说明:

当来电使用呼入式会议室的主持密码进入会议室时,一场呼入式会议被创建,此时触发该消息。


接收的XML数据包:

<xml>
  <PushSN></PushSN>
  <UserName></UserName>
  <Business>TeleConferencing</Business>
  <Event>InBoundConferenceStart</Event>
  <ConferenceRoomSN></ConferenceRoomSN>
  <TaskSN></TaskSN>
  <PhoneSN></PhoneSN>
  <Phone></Phone>
  <IVR></IVR>
  <Record></Record>
  <Mute></Mute>
  <EndPolicy></EndPolicy>
  <InBoundCallee></InBoundCallee>
  <InBoundPWD></InBoundPWD>
  <CustomData></CustomData>
  <Time></Time>
</xml>
			

接收的XML数据包参数说明:

参数含义
PushSN该消息的序列号,如果由于意外原因导致服务器需要重发该消息,该序列号不变
UserName归属的账户名
Business固定值TeleConferencing,表明这是一个电话会议的回调消息
Event固定值InBoundConferenceStart,表明这是电话会议消息中呼入式会议起始的事件
ConferenceRoomSN本次呼入式会议所使用的会议室的序列号,该序列号对应于创建呼入式会议室时返回的会议室序列号。该消息的触发表明该会议室已经处于使用状态
TaskSN本场会议的序列号,由系统自动生成,用户系统需要保存该序列号以区分后续回调消息的归属、进行会控和查询历史记录
PhoneSN主持人的呼叫序列号,由系统自动生成,用户系统需要保存该序列号以区分和主持人有关的回调消息,对主持人进行会控操作亦需要用到此序列号
Phone主持人的电话号码
IVR主持人进入会议时所选择的提示音的语种,可能的值有:
101:中文
102:英语
Recordtrue或false,该会议室的录音功能是否开启
Mutetrue或false,参会人入会时是否可以发言
EndPolicy会议的结束策略,可能的值有:
201:主持人挂断时会议结束
202:主持人挂断时会议不结束,直到会议中只剩下最后一个人才结束
InBoundCallee本场会议可用于呼入的电话号码
InBoundPWD本场会议的参会人呼入密码
CustomData客户自定义字段,在本事件中值为空,用户可以通过“更新一场会议的CustomData标记内容(UpdateCustomData)”功能更改该值,更改后在后续事件中将携带更改过的值
Time该事件触发的时间

用户系统响应:

用户系统成功接收消息后,返回字符串0。HiConf电话会议系统如果未收到字符串0,则认为推送失败,会再次推送该消息(最多三次)。

该文档对问题描述清晰吗?