IVR 基础通知消息

1. 启动业务

• 用户呼叫到达云通讯平台后，云平台向应用服务器发送此请求消息。消息关键字为startservice(URL中的消息关键字“startservice”内容为固定内容，不可变)。

POST /startservice?appid={appid}&callid={callid}&from={from}&to={to}&direction={direction}&userdata={userdata} HTTP/1.1

2. 结束业务

• 用户业务session结束后，由云平台向应用侧发起的请求,url中录音信息为咨询呼叫的录音内容。消息关键字为stopservice。

POST /stopservice?appid={appid}&callid={callid}&starttime={starttime}&endtime={endtime}&callduration={callduration}&sstime={sstime}&setime={setime}&seccallduration={seccallduration}&recordurl={recordurl}&recordid={recordid}&errorcode={errorcode} HTTP/1.1

3. 按键信息上报

• 当使用获取按键命令用户有按键时，云平台会向应用侧发起此请求上报按键内容，URL中的“dtmfreport”内容可由<Get>命令的action属性自定义。消息关键字为dtmfreport。

POST /dtmfreport?appid={appid}&callid={callid}&digits={digits} HTTP/1.1

4. 录音完成通知

• 录音时完成录音(打断录音、录音时间到、录音中挂机)后，由云平台向应用侧发起的请求消息，URL中“recordover”可通过<Record>命令中的action属性和<Record>命令中的recordurl属性自定义。消息关键字为recordover。

POST /recordover?appid={appid}&callid={callid}&recordduration={recordduration}&recordurl={recordurl} HTTP/1.1

5. 被咨询侧应答通知

• 当咨询呼叫命令中订阅此通知(<ConsultationCall>命令中有action属性)时，被咨询侧应答时云平台会向应用侧发起此请求，URL中<answerurl>内容可通过<ConsultationCall>命令中的action属性自定义，若为空则不发送此请求。消息关键字为answerurl。

POST /answerurl?appid={appid}&callid={callid}&mcallid={mcallid}&answertime={answertime} HTTP/1.1

6. 咨询通话设置时间结束咨询侧通知

• 当咨询呼叫设置通话时间到后，云平台会向应用侧发起此请求，以通知应用侧咨询侧通话时间到处理咨询侧后续逻辑。URL中<calltimeover>内容可通过<ConsultationCall>命令中的calltimeoverurl属性自定义，若为空则不发送此请求。消息关键字为calltimeover。

POST /calltimeover?appid={appid}&callid={callid} HTTP/1.1

7. 被咨询侧挂机通知

• 咨询呼叫或呼叫转接在通话中咨询侧挂机时云平台会向应用侧发起此请求，URL中的<hangup>内容可通过<ConsultationCall>或<TransferCall>命令中的hangupurl属性自定义相对url，若为空则不发送此请求。消息关键字为hangup。

POST /hangup?appid={appid}&callid={callid}&reason={reason}&callduration={callduration} HTTP/1.1

8. 咨询侧主动结束咨询呼叫

• 在咨询呼叫中被咨询侧未接通前咨询侧可主动结束咨询呼叫。在<ConsultationCall>命令中“finishkey”参数设置结束键，“cancelurl”参数设置自定义回调URL。

POST /<custom>?appid={appid}&callid={callid} HTTP 1.1

9. 呼转请求

• 由应用侧控制由云平台向应用侧发起的业务跳转请求。消息关键字为redirect。

POST /redirect?appid={appid}&callid={callid}&tag={tag} HTTP/1.1

10. 指定呼转

• 咨询呼叫或呼叫转接接通后，被咨询者按“*号键+分机号+＃号键”后，云平台会向AS侧发送此通知。AS侧可根据此分机号查询新号码后为主叫再次发起咨询呼叫。URL中的<custom>内容可通过<ConsultationCall>和<TransferCall>命令中的transferurl属性自定义相对url，若为空则不发送此请求。消息关键字为transferurl。

POST /<custom>?appid={appid}&callid={callid}&extension={extension} HTTP 1.1

11. 通话结束后发给被咨询侧的通知

• 咨询呼叫或呼叫转接时咨询侧与被咨询侧通话结束或咨询侧挂断电话后，若命令中“consulurlafterhangup”参数不为空，则向AS侧发送此通知。AS侧回复其它IVR命令可对被咨询侧通话进行业务逻辑控制。URL中的<custom>内容可通过<ConsultationCall>命令中的consulurlafterhangup属性自定义相对url，若为空则不发送此请求。消息关键字为consulurlafterhangup。

POST /<custom>?appid={appid}&callid={callid} HTTP 1.1

12. 默认通知接口

• 云平台向AS侧发送的通知请求无其它参数的，都使用此接口进行通知。

POST /<custom>?appid={appid}&callid={callid} HTTP 1.1

13. DTMF发送结果通知

• 发送dtmf完成后，由云平台向应用侧发起的请求消息，URL中“<custom>”可通过<SendDTMF>命令中的action属性自定义。

POST /<custom>?appid={appid}&callid={callid}&result={result}&dtmf={dtmf} HTTP/1.1

14. 咨询通话设置时间结束被咨询侧通知

• 在咨询呼叫设置通话时间到后，云平台会向应用侧发起此请求，以通知应用侧被咨询侧通话时间到处理被咨询侧后续逻辑。URL中<custom>内容可通过<ConsultationCall>命令中的calltimeoverconsulurl属性自定义，若为空则不发送此请求。消息关键字为calltimeoverconsul。

POST /<custom>?appid={appid}&callid={callid} HTTP 1.1

15. 被咨询侧未接听挂机通知

• 在咨询呼叫中被咨询侧未接通超时、拒接或者关机等造成的被咨询侧挂机的通知请求。URL中<custom>内容可通过<ConsultationCall>命令中的noanswerurl属性自定义，若为空则不发送此请求。

POST /<custom>?appid={appid}&callid={callid} HTTP 1.1