消息回调 API

              
              {
    "total": 1,
    "rows": [
        {
            "message_id": "1666165485030094861", // EngageLab 的消息 id
            "from": "", // 发送方
            "to": "", // 接收方
            "server": "whatsapp",
            "channel": "whatsapp",
            "itime": 1640707579, // 消息状态产生的时间戳，如消息已送达的时间
            "custom_args": {}, // 这条消息创建时提交的参数，将于此回调时原样返回
            "status": {
                // 成功时响应这些字段
                "message_status": "delivered" // 消息状态    
      "status_data": { // 自定义
                    "msg_time": 1663432355, // 消息下发时间，历史记录上的消息发送时间，即用户调用 API 发送消息-调用 API 成功的那个时间
                    "channel_message_id": "wamid.123321abcdefed==", // 可选，Meta 返回的 msgid
                    "whatsapp_business_account_id": "", //发送号 from 对应的 Whatsapp 商业账户编码
                    "timezone": "", //组织时区
                    "plan_user_total": 2007, //计划目标总数，只有当 message_status=plan 时这个才会有值
                    "country_code": "CN", //接收方手机号码归属的国家/地区代码
                    "from_phone_id": "111111" // 发送号码（from）的 ID 标识
       "conversation": { // 可选，会话信息
                        "id": "ebe2398cdaa37a0899ca5268b987b0c8",
                        "origin": {
                            "type": "business_initiated"
                        }
                    },
                    "pricing": { // 可选，价格信息
                        "pricing_model": "CBP",
                        "category": "business_initiated"
                    }
                },
                // 失败状态下（无效目标、发送失败、送达失败、未读）返回这些字段
                "error_code": 0, //错误码
                "error_detail": {
                    "message": "" //错误原因
                },
                "loss": {
                    "loss_step": 1,
                    "loss_source": "aa"
                }
            }
        }
    ]
}

            

              
              {
    "total": 1,
    "rows": [
        {
            "message_id": "1666165485030094861", // 极光侧的消息 id
            "from": "", // 发送方，即客户的手机号码
            "to": "", // 接收方，即开发者的发送号
            "server": "whatsapp",
            "channel": "whatsapp",
            "itime": 1640707579, // 时间戳
            "response": {
                "event": "", // 响应事件
                "response_data": { // 具体消息内容
                    "channel_message_id": "wamid.123321abcdefed==", // 可选，Meta 返回的 msgid
                    "whatsapp_business_account_id": "123321", //开发者的发送号 to 对应的 Whatsapp 商业账户编码
                    "contact": { // 可选，发送方信息
                        "profile": {
                            "name": "bob" // 发送方的昵称
                        },
                        "wa_id": "8613800138000" // 发送方的号码
                    },
                    "message": { // 具体消息内容
                        "type": "text", // 消息的类型，可以根据这个值来识别具体消息字段，如 text 则内容为 text 字段
                        "text": { // 消息内容
                            "body": "here is the message content text"
                        }
                    }
                }
            }
        }
    ]
}

            

              
              {"total":1, 
  "rows":[{
  "server": "whatsapp", 
  "itime":1640707579,
  "notification":{
      "event":"insufficient_balance",
    "notification_data":{
      "whatsapp_business_account_id":"",
      "remain_balance": 5.1234,					
      "balance_threshold": 10
    }
  }
}]
}

            

              
              {
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "time": <WEBHOOK_TRIGGER_TIMESTAMP>,
      "changes": [
        {
          "value": {
            "event": "<EVENT>",
            "message_template_id": <TEMPLATE_ID>,
            "message_template_name": "<TEMPLATE_NAME>",
            "message_template_language": "<TEMPLATE_LANGUAGE_AND_LOCALE_CODE>",
            "reason": "<REASON>",
            "message_template_category": <TEMPLATE_CATEGORY>,

            // 仅当模板被禁用时包含
            "disable_info": {
              "disable_date": "<DISABLE_TIMESTAMP>"
            },

            // 仅当模板被锁定或解锁时包含
            "other_info": {
              "title": "<TITLE>",
              "description": "<DESCRIPTION>"
            }
          },

          // 仅当模板因 INVALID_FORMAT 被拒时包含
          "rejection_info": {
            "reason": "<REASON_INFO>",
            "recommendation": "<RECOMMENDATION_INFO>"
          }
          "field": "message_template_status_update"
        }
      ]
    }
  ],
  "object": "whatsapp_business_account"
}

            

              
              {
  "entry": [
    {
      "id": "102290129340398",
      "time": 1751247548,
      "changes": [
        {
          "value": {
            "event": "APPROVED",
            "message_template_id": 1689556908129832,
            "message_template_name": "order_confirmation",
            "message_template_language": "en-US",
            "reason": "NONE",
            "message_template_category": "UTILITY"
          },
          "field": "message_template_status_update"
        }
      ]
    }
  ],
  "object": "whatsapp_business_account"
}

            

              
              {
  "entry": [
    {
      "id": "102290129340398",
      "time": 1751247548,
      "changes": [
        {
          "value": {
            "event": "REJECTED",
            "message_template_id": 1689556908129835,
            "message_template_name": "abandoned_cart",
            "message_template_language": "en",
            "reason": "INVALID_FORMAT",
            "message_template_category": "MARKETING",
            "rejection_info": {
              "reason": "Your template has parameters placed next to each other (like ) without text or punctuation between them.",
              "recommendation": "Separate parameters with descriptive text and ensure each parameter is clearly contextualized."
            }
          },
          "field": "message_template_status_update"
        }
      ]
    }
  ],
  "object": "whatsapp_business_account"
}