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 do Flow e mudanças de status

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

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 de 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"
                }
            }
        }
    ]
}

O response_json 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 útil 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.

Avisos de expiração da versão 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é que você atualize 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.