回执消息简介与配置流程

当您使用隐私号码服务绑定一组隐私关系后,可以通过轻量消息队列(原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

SecretRingReport(呼叫响铃时报告)

呼叫响铃时获取呼叫过程中的响铃信息,包括呼叫号码、呼叫类型、响铃时间等。

SecretRingReport

SecretRingReport

SecretPickUpReport(呼叫接听时报告)

呼叫接听时获取呼叫过程中的摘机信息,包括号码信息、号码类型、接听时间等。

SecretPickUpReport

SecretPickUpReport

SecretReport(呼叫结束后话单报告)

呼叫结束后获取通话记录信息,包括通话开始时间、通话结束时间、主被叫号码等,便于平台进行管理。

SecretReport

SecretReport

SecretRecording(录音状态报告)

通话结束后获取通话的录音记录。

SecretRecording

SecretRecording

SecretAsrReport(录音ASR状态报告)

获取通话中的实时文本转换结果。

SecretAsrReport

SecretAsrReport

SecretExceptionPhoneReport(异常号码状态推送)

检测当前号码异常状态,对异常号码实行策略降级。

SecretExceptionPhoneReport

-

SmartLogisticsReport(电商物流详细报告)

获取电商物流节点详情。

说明

开通电商物流详细报告消息功能,详情请咨询您的商务经理。

SmartLogisticsReport

SmartLogisticsReport

NumberManagementReport(号码管理信息)

实现号码线上化管理。

NumberManagementReport

NumberManagementReport

配置回执消息接收模式

如果您需要接收回执消息,必须先在号码隐私保护控制台上开启消息接收。

  1. 登录号码隐私保护控制台

  2. 概览页面中找到云通信消息接收区域。

  3. 在云通信消息接收区域,找到需要订阅的消息类型,并选择所需的消息发送模式。

    • 轻量消息队列(原MNS)消费模式

      1. 开启轻量消息队列(原MNS)消费模式左侧的功能开关。

      2. 单击新建队列

      3. 设置队列名称并勾选关联的号码池。

        重要

        初始状态下,没有关联过队列的号码池统一使用默认队列接收消息。

      4. 单击确定

    • HTTP批量推送模式

      1. 开启HTTP批量推送模式的功能开关。

        说明

        部分消息类型没有HTTP批量推送模式,请以控制台显示的消息类型为准。如:异常号码状态推送无HTTP批量推送模式。

      2. 填写接收地址,地址示例:http://push.example.com/contextpath/receive.do。

      3. 单击保存