Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Recepción de respuestas y cambios de estado de Flow

Cuando un usuario completa un flujo o cuando el estado de un flujo cambia, AWS End User Messaging Social envía notificaciones de webhooks a través del destino de eventos que tengas configurado. No es necesario realizar ninguna configuración adicional ni crear nuevos tipos de eventos: los eventos de Flow se envían automáticamente al mismo destino del evento que utilizas para los mensajes y las confirmaciones de entrega. Debes tener activado el destino del evento para recibir estas notificaciones. Para obtener más información, consulte Añade un mensaje y un destino de evento a AWS Mensajería para usuarios finales en redes sociales.

Mensajes de respuesta de flujo

Cuando un usuario completa un flujo, recibes un mensaje entrante con el tipo interactive y el nfm_reply subtipo. El response_json campo contiene los datos enviados por el usuario como una cadena JSON.

El siguiente ejemplo muestra una carga útil de webhook de Flow response:

{
    "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_jsonContiene los pares clave-valor correspondientes a los nombres de los campos del formulario definidos en tu JSON de Flow y a los valores introducidos por el usuario. Analiza esta cadena JSON para extraer los datos enviados.

Notificaciones de cambios en el estado del flujo

Cuando Meta cambia el estado de un flujo (por ejemplo, de PUBLICADO a BLOQUEADO), recibes una notificación en el destino de tu evento. En el siguiente ejemplo, se muestra la carga útil de un cambio de estado:

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

Supervisa estos eventos de cambio de estado para detectar cuándo Meta bloquea o limita tus flujos, de modo que puedas tomar medidas correctivas.

Notificaciones sobre el estado de los terminales (flujos dinámicos)

En el caso de los flujos dinámicos con un punto final, Meta supervisa el estado del punto final y envía notificaciones cuando se detectan problemas. Las recibes a través del destino de tu evento configurado.

Porcentaje de errores de punto final: se envía cuando el porcentaje de errores supera un umbral en los ú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"
                }
            ]
        }
    ]
}

Latencia de punto final: se envía cuando la latencia p90 supera el umbral:

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

Disponibilidad de los terminales: se envía cuando la disponibilidad de los terminales cae por debajo del umbral:

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

Supervise estos eventos para detectar y resolver los problemas de los terminales antes de que Meta bloquee o limite su flujo. Para obtener más información sobre la configuración de flujos dinámicos, consulte. Configuración de flujos dinámicos

Advertencias de caducidad de la versión de

Meta envía un webhook de advertencia cuando la versión JSON de Flow utilizada por tu Flow se acerca a su fecha de finalización de vida útil. Cuando una versión caduca, no puedes enviar el Flow hasta que actualices a una versión más reciente.

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

Cuando recibas esta advertencia, actualiza tu JSON de Flow para que use la versión recomendada (actualmente la 7.3) llamando UpdateWhatsAppFlowAssets con el JSON actualizado y, a continuación, vuelve a publicar el Flow.