当您使用隐私号码服务绑定一组隐私关系后,可以通过轻量消息队列(原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(呼叫发起时话单报告) | 呼叫发起时立即获取到通话记录信息,包括通话开始时间、主被叫号码等,便于平台进行预判处理。 | ||
SecretRingReport(呼叫响铃时报告) | 呼叫响铃时获取呼叫过程中的响铃信息,包括呼叫号码、呼叫类型、响铃时间等。 | ||
SecretPickUpReport(呼叫接听时报告) | 呼叫接听时获取呼叫过程中的摘机信息,包括号码信息、号码类型、接听时间等。 | ||
SecretReport(呼叫结束后话单报告) | 呼叫结束后获取通话记录信息,包括通话开始时间、通话结束时间、主被叫号码等,便于平台进行管理。 | ||
SecretRecording(录音状态报告) | 通话结束后获取通话的录音记录。 | ||
SecretAsrReport(录音ASR状态报告) | 获取通话中的实时文本转换结果。 | ||
SecretExceptionPhoneReport(异常号码状态推送) | 检测当前号码异常状态,对异常号码实行策略降级。 | - | |
SmartLogisticsReport(电商物流详细报告) | 获取电商物流节点详情。 说明 开通电商物流详细报告消息功能,详情请咨询您的商务经理。 | ||
NumberManagementReport(号码管理信息) | 实现号码线上化管理。 |
配置回执消息接收模式
如果您需要接收回执消息,必须先在号码隐私保护控制台上开启消息接收。
登录号码隐私保护控制台。
在概览页面中找到云通信消息接收区域。
在云通信消息接收区域,找到需要订阅的消息类型,并选择所需的消息发送模式。
轻量消息队列(原MNS)消费模式。
开启轻量消息队列(原MNS)消费模式左侧的功能开关。
单击新建队列。
设置队列名称并勾选关联的号码池。
重要初始状态下,没有关联过队列的号码池统一使用默认队列接收消息。
单击确定。
HTTP批量推送模式。
开启HTTP批量推送模式的功能开关。
说明部分消息类型没有HTTP批量推送模式,请以控制台显示的消息类型为准。如:异常号码状态推送无HTTP批量推送模式。
填写接收地址,地址示例:http://push.example.com/contextpath/receive.do。
单击保存。