消息状态

状态报告

消息状态事件

whatsapp_message_status_updated

字段	数据类型	是否必填	描述
id	String	是	Message Id
accountName	String	是	API账号
wabaId	String	是	Waba Id
status	String	是	发送状态：delivered、read、failed、SMECL:FAILED
wamid	String	是	WhatsApp消息Id
sendPhone	String	是	WhatsAppp用户号码
uid	String	否	客户批次号，客户发送的批次号（uid）
conversation	JOSN	否	会话信息，status是delivered时有值
billable	Boolean	是	是否计费：true： 计费 ，false：不计费
category	String	是	消息类型： authentication 验证码 utility 通知 marketing 营销 marketing_lite MMLite营销 service 服务消息
price	String	是	单价，保留5位小数。
currency	String	是	货币

conversation 对象

字段	数据类型	是否必填	描述
initiateType	String	是	会话发起类型 business_initiated：商家发起会话referral_conversion：免费入口发起会话，这类会话由用户发起customer_initiated：用户发起会话
expireAt	String	是	会话过期时间，eg: 2023-02-22 12:00:00

errorData 对象

字段	数据类型	是否必填	描述
errorCode	String	是	Meta错误码
errorMessage	String	是	Meta错误描述

响应报文示例

delivered:响应示例

{
    "id": "e5cb1bc6-ad90-419d-8f83-aa394c0b7cc7",
    "type": "whatsapp_message_status_updated",
    "eventTime": "2023-02-22T12:00:00.000Z",
    "body": {
        "id": "356139161272397824",
        "accountName": "IW123456",
        "wabaId": "11231231212331",
        "wamid": "wamid.BgNODYxN...", 
        "status": "delivered",
        "uid":"2002302023002010121",
        "sendPhone":"65123101212312",
        "conversation": {
            "id": "00e5a7e14a588d96bd2343d105d03ec5",
            "initiateType": "business_initiated",
            "expireAt": "2023-02-23T12:00:00.000Z"
        },
        "currency": "USD"
    }
}

read:响应示例

{
    "id": "cd0a316c-a781-4589-9f5f-5502ccf1f60f",
    "type": "whatsapp_message_status_updated",
    "eventTime": "2023-05-26T02:18:44.115Z",
    "body": {
        "accountName": "15902677617",
        "id": "356139161272397824",
        "status": "read",
        "uid":"2002302023002010121",
        "sendPhone":"65123101212312",
        "wabaId": "WHATSAPP_BUSINESS_ACCOUNT_ID",
        "wamid": "wamid.HBgNODYxNjY4NTE3NzYxMhUCABEYEjQ0RTYyQTM5QzAyMkU0QkNERgA="
    }
}

failed:响应示例

{
    "id": "e5cb1bc6-ad90-419d-8f83-aa394c0b7cc7",
    "type": "whatsapp_message_status_updated",
    "eventTime": "2023-05-25T10:31:08.167Z",
    "body": {
        "accountName": "15902677617",
        "errorData": {
            "errorCode": "131014",
            "errorMessage": "Request for url https://URL.jpg failed with error: 404 (Not Found)"
        },
        "id": "356139161272397824",
        "status": "failed",
         "uid":"2002302023002010121",
        "sendPhone":"65123101212312",
        "wabaId": "WHATSAPP_BUSINESS_ACCOUNT_ID",
        "wamid": "wamid.HBgNODYxNjY4NTE3NzYxMhUCABEYEjQ0RTYyQTM5QzAyMkU0QkNERgA="
    }
}