flows webhook

流flow相关回执

应用上配置的webhook值【需要订阅 如下事件】

• flows 流事件

对提供的webhook地址，进行推送信息

• URL：webhook_url
• Method：POST
• Content-Type：application/json

验签说明

对于客户应用配置了回执加签算法，所有的回执请求服务端都会进行加签处理，客户端可自行对回执请求进行验签处理，验签算法请参照签名算法

流状态更新

• 草稿

{
    "field": "flows",
    "value": {
        "business_phone": "85235757576",
        "event": "FLOW_STATUS_CHANGE",
        "flow_id": "825627596622321",
        "message": "Flow Vin1 has been created with DRAFT status",
        "new_status": "DRAFT",
        "time": 1761291092,
        "wabaId": "806151905325094"
    }
}

• 发布

{
    "field": "flows",
    "value": {
        "business_phone": "8615273907424",
        "event": "FLOW_STATUS_CHANGE",
        "flow_id": "1168300431915404",
        "message": "Flow test changed status from DRAFT to PUBLISHED",
        "new_status": "PUBLISHED",
        "old_status": "DRAFT",
        "time": 1761290547,
        "wabaId": "196938173492252"
    }
}

flows ACTIVATED

{
    "field": "flows",
    "value": {
        "alert_state": "ACTIVATED",
        "business_phone": "447880015181",
        "event": "ENDPOINT_AVAILABILITY",
        "flow_id": "1395630651087875",
        "message": "Flow endpoint availability has breached the 90% threshold in the last 10 minutes. Users will be unable to open or use the flow.",
        "threshold": 90,
        "time": 1761291964,
        "wabaId": "215280371679375"
    }
}

flows DEACTIVATED

{
    "field": "flows",
    "value": {
        "alert_state": "DEACTIVATED",
        "business_phone": "xxx",
        "event": "ENDPOINT_AVAILABILITY",
        "flow_id": "xxx",
        "message": "Flow endpoint availability successfully recovered. Users will now be able to open and use the flow.",
        "threshold": 90,
        "time": 1754306033,
        "wabaId": "xxx"
    }
}

flow表单提交消息webhook示例

{
    "app_id": "391",
    "business_phone": "xxx",
    "channel": 2,
    "contacts": [
        {
            "profile": {
                "name": "xxx"
            },
            "wa_id": "xxx"
        }
    ],
    "merchant_phone": "xxx",
    "messages": [
        {
            "context": {
                "from": "xxx",
                "id": "wamid.c4825f4807d04f5480cbd3f52834e96f",
                "meta_message_id": "wamid.HBgNNjI4MTkwNjYzNTQ1MxUCABEYEkY0OTMzQ0E0MjU1NjM0NkU1NAA="
            },
            "cost": {
                "cdr_type": 1,
                "currency": "USD",
                "direction": 2,
                "foreign_price": 0,
                "message_id": "wamid.HBgNNjI4MTkwNjYzNTQ1MxUCABIYIEFDMjhFMDhBOEMwMURENzYxQUVDQjUzODNGQ0Q5OTdCAA==",
                "price": 0
            },
            "from": "xxx",
            "id": "wamid.HBgNNjI4MTkwNjYzNTQ1MxUCABIYIEFDMjhFMDhBOEMwMURENzYxQUVDQjUzODNGQ0Q5OTdCAA==",
            "interactive": {
                "nfm_reply": {
                    "response_json": "{\"email\":\"xxx.com\",\"action_name\":\"add_email\",\"first_request\":\"1761xxx034\",\"last_reply\":\"xxx.\\nreferenceid:#xxx#\",\"ctwa_clid\":\"\",\"flow_token\":\"xxx-6f0a-7ab4208b2f9b\"}",
                    "body": "Sent",
                    "name": "flow"
                },
                "type": "nfm_reply"
            },
            "timestamp": "1761277258",
            "type": "interactive"
        }
    ],
    "messaging_product": "whatsapp",
    "metadata": {
        "display_phone_number": "xxx",
        "phone_number_id": "xxx"
    },
    "wabaId": "xxx"
}