当您使用隐私号码服务绑定一组隐私关系后,可以通过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

配置回执消息接收模式

如果您需要接收回执消息,必须先在号码隐私保护控制台上开启消息接收。
  1. 登录号码隐私保护控制台
  2. 概览页面中找到云通信消息接收区域。
  3. 在云通信消息接收区域,找到需要订阅的消息类型,并选择所需的消息发送模式。
    • MNS消息队列消费模式
      1. 开启MNS消息队列消费模式左侧的功能开关。2
      2. 单击新建队列
      3. 设置队列名称并勾选关联的号码池。
        重要 初始状态下,没有关联过队列的号码池统一使用默认队列接收消息。
      4. 单击确定
    • HTTP批量推送模式
      1. 开启HTTP批量推送模式左侧的功能开关。
        说明 部分消息类型没有HTTP批量推送模式,如:计费通话报告、计费短信报告和异常号码状态推送。
      2. 填写接收地址,地址示例:http://push.example.com/contextpath/receive.do。2
      3. 单击保存