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 推送本次会议日志

2.22、查询一场历史会议

功能说明:

该接口用于查询一场已经结束的会议的会议详情和参会人详情。


发送的XML数据包:

<xml>
  <ActionType>QueryConferenceHistory</ActionType>
  <UserName></UserName>
  <Token></Token>
  <TaskSN></TaskSN>
</xml>
			

发送的XML数据包参数说明:

参数必要性含义
ActionType必填固定值QueryConferenceHistory
UserName必填账号名
Token必填使用32位MD5对原始密码进行加密,并将加密结果转换为大写得出Token值
TaskSN必填所要查询的会议的序列号

返回值:

<xml>
  <errcode></errcode>
  <errmsg></errmsg>
  <TaskSN></TaskSN>
  <ConferenceDescription></ConferenceDescription>
  <Type></Type>
  <Emcee></Emcee>
  <Record></Record>
  <RecordFiles></RecordFiles>
  <EndPolicy></EndPolicy>
  <ReceiveEventURL></ReceiveEventURL>
  <Time></Time>
  <StartTime></StartTime>
  <EndTime></EndTime>
  <CustomData></CustomData>
  <MemberCount></MemberCount>
  <Member(x)>
    <Role></Role>
    <Name></Name>
    <PhoneSN></PhoneSN>
    <Phone></Phone>
    <PhoneEXT></PhoneEXT>
    <Type></Type>
    <Terminal></Terminal>
    <IVR></IVR>
    <Time></Time>
    <CallTime></CallTime>
    <ConnectTime></ConnectTime>
    <EndTime></EndTime>
  </Member(x)>
</xml>
			

返回值参数说明:

参数含义
errorcode调用成功时返回“0”,调用失败时返回大于0的失败代码并在errmsg中描述具体的失败原因
errmsg调用成功时返回“成功”,调用失败时返回具体的失败原因的中文描述
TaskSN所查询的会议的序列号
ConferenceDescription会议名称
Type会议的类型,会议的类型取决于主持人的进入方式,可以是外呼式会议(OutBound)或呼入式会议(InBound)
Emcee本场会议当前主持人的电话号码
Record是否对会议进行录音
RecordFiles录音文件的URL,如果用户在会话过程中反复调用了开始录音和结束录音,则可能存在多个录音文件的URL,多个文件使用半角逗号隔开
EndPolicy会议的结束策略,可以是主持人挂断时会议结束(201)和主持人挂断时会议不结束,直到会议中只剩下最后一个人才结束(202)
ReceiveEventURL接收回调消息的URL,如果留空消息则推送到后台设置的默认地址
Time会议任务提交的时间
StartTime会议开始的时间(即主持人接通的时间)
EndTime会议结束的时间
CustomData在提交任务时所携带的客户自定义字段的值
MemberCount会议参与成员的数量
Member(x)根据MemberCount的数量,通过<Member(x)></Member(x)>的形式返回多个会议参与成员的详情
Member(x)/Role该成员在会议中的角色
Member(x)/Name该成员的姓名
Member(x)/PhoneSN该成员的呼叫序列号
Member(x)/Phone该成员的电话号码
Member(x)/PhoneEXT该成员的分机号(如果有)
Member(x)/Type该成员的呼叫类型,可以是呼出(OutBound)或呼入(InBound)
Member(x)/Terminal该成员参与会议的方式,目前只支持PSTN
Member(x)/IVR对该成员播报提示音的语种,可以是中文(101)或英语(102)
Member(x)/Time添加该成员到会议的时间
Member(x)/CallTime开始呼叫该成员的时间
Member(x)/ConnectTime该成员接通的时间
Member(x)/EndTime该成员挂断的时间(如果已经挂断)

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