# 接收并处理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=****'
  ```