As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Recebendo respostas e mudanças de status do Flow

Quando um usuário conclui um fluxo ou quando o status de um fluxo muda, o AWS End User Messaging Social fornece notificações de webhook por meio do destino de evento configurado existente. Nenhuma configuração adicional ou novos tipos de eventos são necessários — os eventos de fluxo são entregues automaticamente no mesmo destino de eventos que você usa para mensagens e recibos de entrega. Você deve ter um destino de evento habilitado para receber essas notificações. Para obter mais informações, consulte Adicione uma mensagem e um destino de evento ao AWS Mensagens sociais para o usuário final.

Mensagens de resposta de fluxo

Quando um usuário conclui um Flow, você recebe uma mensagem de entrada com o tipo interactive e o subtipo. nfm_reply O response_json campo contém os dados enviados pelo usuário como uma string JSON.

O exemplo a seguir mostra uma carga útil do webhook de resposta do Flow:

{
    "messages": [
        {
            "from": "14085551234",
            "id": "wamid.XXX",
            "timestamp": "1234567890",
            "type": "interactive",
            "interactive": {
                "type": "nfm_reply",
                "nfm_reply": {
                    "response_json": "{\"name\":\"John Doe\",\"email\":\"john@example.com\",\"phone\":\"+14085551234\"}",
                    "body": "Sent",
                    "name": "flow"
                }
            }
        }
    ]
}

response_jsonEle contém pares de valores-chave correspondentes aos nomes dos campos do formulário definidos em seu Flow JSON e aos valores inseridos pelo usuário. Analise essa string JSON para extrair os dados enviados.

Notificações de alteração do status do fluxo

Quando o Meta altera o status de um Flow (por exemplo, de PUBLICADO para BLOQUEADO), você recebe uma notificação por meio do destino do evento. O exemplo a seguir mostra uma carga de alteração de status:

{
    "entry": [
        {
            "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
            "changes": [
                {
                    "value": {
                        "event": "FLOW_STATUS_CHANGE",
                        "flow_id": "{FLOW_ID}",
                        "old_status": "PUBLISHED",
                        "new_status": "BLOCKED",
                        "reason": "Policy violation detected"
                    },
                    "field": "flows"
                }
            ]
        }
    ]
}

Monitore esses eventos de mudança de status para detectar quando o Meta bloqueia ou restringe seus fluxos para que você possa tomar medidas corretivas.

Notificações de integridade do endpoint (fluxos dinâmicos)

Para fluxos dinâmicos com um endpoint, o Meta monitora a integridade do endpoint e envia notificações quando problemas são detectados. Você os recebe por meio do destino de evento configurado.

Taxa de erro do endpoint — Enviada quando a taxa de erro excede um limite nos últimos 30 minutos:

{
    "entry": [
        {
            "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
            "changes": [
                {
                    "value": {
                        "event": "ENDPOINT_ERROR_RATE",
                        "flow_id": "{FLOW_ID}",
                        "error_rate": 14.28,
                        "threshold": 10,
                        "alert_state": "ACTIVATED",
                        "errors": [
                            { "error_type": "CAPABILITY_ERROR", "error_rate": 66.66, "error_count": 2 },
                            { "error_type": "TIMEOUT", "error_rate": 33.33, "error_count": 1 }
                        ]
                    },
                    "field": "flows"
                }
            ]
        }
    ]
}

Latência do endpoint — Enviada quando a latência p90 excede o limite:

{
    "entry": [
        {
            "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
            "changes": [
                {
                    "value": {
                        "event": "ENDPOINT_LATENCY",
                        "flow_id": "{FLOW_ID}",
                        "p90_latency": 8000,
                        "p50_latency": 500,
                        "requests_count": 34,
                        "threshold": 7000,
                        "alert_state": "ACTIVATED"
                    },
                    "field": "flows"
                }
            ]
        }
    ]
}

Disponibilidade do endpoint — Enviado quando a disponibilidade do endpoint cai abaixo do limite:

{
    "entry": [
        {
            "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
            "changes": [
                {
                    "value": {
                        "event": "ENDPOINT_AVAILABILITY",
                        "flow_id": "{FLOW_ID}",
                        "availability": 75,
                        "threshold": 90,
                        "alert_state": "ACTIVATED"
                    },
                    "field": "flows"
                }
            ]
        }
    ]
}

Monitore esses eventos para detectar e resolver problemas de endpoint antes que o Meta bloqueie ou restrinja seu Flow. Para obter mais informações sobre como configurar fluxos dinâmicos, consulteConfigurando fluxos dinâmicos.

Avisos de expiração da versão do Flow

O Meta envia um webhook de aviso quando a versão JSON do Flow usada pelo seu Flow está se aproximando da data de fim de vida útil. Quando uma versão expira, você não pode enviar o Flow até atualizar para uma versão mais recente.

{
    "entry": [
        {
            "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
            "changes": [
                {
                    "value": {
                        "event": "FLOW_VERSION_EXPIRY_WARNING",
                        "flow_id": "{FLOW_ID}",
                        "warning": "Your current Flow version will freeze in 21 days. You won't be able to send the Flow after it expires. Please migrate to the recommended version as soon as possible."
                    },
                    "field": "flows"
                }
            ]
        }
    ]
}

Ao receber esse aviso, atualize seu Flow JSON para usar a versão recomendada (atualmente 7.3) chamando UpdateWhatsAppFlowAssets com o JSON atualizado e, em seguida, publique novamente o Flow.