文档首页/ 云客服/ API参考/ Adapter类接口参考/ 接口说明/ 数据访问接口/ WhatsApp渠道/ 接收并处理twilio发送的报告消息接口
更新时间:2025-11-13 GMT+08:00

接收并处理twilio发送的报告消息接口

接口功能

接收处理twilio发送的报告信息。

使用说明

  • 前提条件

    正确创建whatsApp渠道配置,选择服务提供商为twilio。

接口鉴权

通过twilio集成商接入WhatsApp使用该鉴权方式。

使用说明:

在AICC侧,渠道配置页面,配置webhook用户及密码。

调用whatsappadapter侧接口,请求头根据webhook用户及密码生成签名放到Authorization属性中。

Headers请求参数

表1 请求Headers参数说明

参数名称

选取原则

参数类型

默认值

说明

Content-Type

必选

String

固定填application/x-www-form-urlencoded。

Authorization

必选

String

twilio基于webhook用户和密码生成Authorization,请求AICC侧时携带。

接口原型

表2 接口原型说明

请求方法

POST

请求URL

https://ip:port/social/on/whatsapp/{whatsAppBsp}/report/{channelConfigId}

其中,ip:port为对外暴露的nslb的ip和port;whatsAppBsp为集成方,twilio提供商场景固定填写twilio;channelConfigId为渠道id。

BODY请求参数

表3 请求Body中参数说明

参数名称

选取原则

参数类型

说明

MessageSid

必选

String

消息id标识

MessageStatus

必选

String

状态信息:delivered已送达、read已读

To

必选

String

接收方

From

必选

String

发送方

响应参数

调用本接口无响应内容。

接口示例

  • 请求示例
    POST /social/on/whatsapp/twilio/report/****'
    --header 'Authorization: basic ****'
    --header 'Content-Type: application/x-www-form-urlencoded'
    --data-urlencode 'From=whatsapp:+****'
    --data-urlencode 'To=whatsapp:+****'
    --data-urlencode 'MessageStatus=delivered'
    --data-urlencode 'MessageSid=****'