当您使用隐私号码服务绑定一组隐私关系后,可以通过MNS消息队列消费模式或HTTP批量推送模式来接收话单回执消息。话单回执消息记录了所有的通话记录行为。
注意事项
- 如果出现网络异常、响应超时等情况,可能导致回执消息推送重复。
- HTTP批量推送模式的响应超时时间为700 ms。
- 使用SDK拉取MNS回执消息,详情请参见消息回执API Demo。
回执消息模式
接收回执消息的模式有MNS消息队列消费模式和HTTP批量推送模式两种,您可根据实际情况选择合适的模式接收回执消息。
- MNS消息队列消费模式
MNS消息队列消费模式表示通过MNS的Queue模型来接收回执消息。云通信的所有业务消息都用过MNS消息服务向外发送。用户在号码隐私保护控制台启用MNS消息服务订阅指定的消息类型时,系统会自动生成该类型的独立消息队列及名称(QueueName)。您可以使用此消息队列名称和消息类型,通过阿里云AccessKey信息换取的临时Token来获取队列中的详细内容。
- HTTP批量推送模式
HTTP批量推送模式表示通过HTTP和POST方式发送消息到指定的Web URL。在号码隐私保护控制台设置HTTP回调URL(callback_url)后,当业务消息产生时,系统会使用HTTP请求以POST方式将业务消息发送到指定的回调URL上,用户可直接接收此消息。
回执消息类型
号码隐私保护提供的回执消息类型(MessageType)如下,您可根据业务需要进行选择。
名称 | 描述 | MNS消息队列消费模式 | HTTP批量推送模式 |
---|---|---|---|
SecretStartReport(呼叫发起时话单报告) | 呼叫发起时立即获取到通话记录信息,包括通话开始时间、主被叫号码等,便于平台进行预判处理。 | SecretStartReport | SecretStartReport |
SecretReport(呼叫结束后话单报告) | 呼叫结束后获取通话记录信息,包括通话开始时间、通话结束时间、主被叫号码等,便于平台进行管理。 | SecretReport | SecretReport |
SecretRecording(录音状态报告) | 通话结束后获取通话的录音记录。 | SecretRecording | SecretRecording |
SecretAsrReport(录音ASR状态报告) | 获取通话中的实时文本转换结果。 | SecretAsrReport | SecretAsrReport |
SecretExceptionPhoneReport(异常号码状态推送) | 检测当前号码异常状态,对异常号码实行策略降级。 | SecretExceptionPhoneReport | - |
SmartLogisticsReport(电商物流详细报告) | 获取电商物流节点详情。
说明
开通电商物流详细报告消息功能,详情请咨询您的商务经理。 |
SmartLogisticsReport | SmartLogisticsReport |
配置回执消息接收模式
如果您需要接收回执消息,必须先在号码隐私保护控制台上开启消息接收。
- 登录号码隐私保护控制台。
- 在概览页面中找到云通信消息接收区域。
- 在云通信消息接收区域,找到需要订阅的消息类型,并选择所需的消息发送模式。
- MNS消息队列消费模式。
- 开启MNS消息队列消费模式左侧的功能开关。
- 单击新建队列。
- 设置队列名称并勾选关联的号码池。重要 初始状态下,没有关联过队列的号码池统一使用默认队列接收消息。
- 单击确定。
- 开启MNS消息队列消费模式左侧的功能开关。
- HTTP批量推送模式。
- 开启HTTP批量推送模式左侧的功能开关。
说明 部分消息类型没有HTTP批量推送模式,如:计费通话报告、计费短信报告和异常号码状态推送。
- 填写接收地址,地址示例:http://push.example.com/contextpath/receive.do。
- 单击保存。
- 开启HTTP批量推送模式左侧的功能开关。
- MNS消息队列消费模式。