Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Réponses et changements d'état du flux de réception

Lorsqu'un utilisateur termine un flux ou que le statut d'un flux change, AWS End User Messaging Social envoie des notifications de webhook via votre destination d'événements configurée existante. Aucune configuration supplémentaire ni aucun nouveau type d'événement ne sont nécessaires : les événements Flow sont automatiquement envoyés à la même destination que celle que vous utilisez pour les messages et les reçus de livraison. Une destination d'événement doit être activée pour recevoir ces notifications. Pour plus d’informations, consultez Ajoutez un message et une destination d'événement à AWS Messagerie à l'utilisateur final : réseaux sociaux.

Messages de réponse au flux

Lorsqu'un utilisateur termine un flux, vous recevez un message entrant avec le type interactive et le nfm_reply sous-type. Le response_json champ contient les données soumises par l'utilisateur sous forme de chaîne JSON.

L'exemple suivant montre la charge utile d'un webhook de réponse 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_jsonIl contient des paires clé-valeur correspondant aux noms des champs de formulaire définis dans votre Flow JSON et aux valeurs saisies par l'utilisateur. Analysez cette chaîne JSON pour extraire les données soumises.

Notifications de changement d'état des flux

Lorsque Meta modifie le statut d'un flux (par exemple, de PUBLIÉ à BLOQUÉ), vous recevez une notification via la destination de votre événement. L'exemple suivant montre une charge utile de changement de statut :

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

Surveillez ces événements de changement d'état pour détecter quand Meta bloque ou limite vos flux afin de pouvoir prendre des mesures correctives.

Notifications de santé des terminaux (flux dynamiques)

Pour les flux dynamiques avec un point de terminaison, Meta surveille l'état de santé du terminal et envoie des notifications lorsque des problèmes sont détectés. Vous les recevez via la destination de l'événement que vous avez configurée.

Taux d'erreur des terminaux  : envoyé lorsque le taux d'erreur dépasse un seuil au cours des 30 dernières minutes :

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

Latence du point de terminaison — Envoyé lorsque la latence p90 dépasse le seuil :

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

Disponibilité des terminaux — Envoyé lorsque la disponibilité des terminaux tombe en dessous du seuil :

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

Surveillez ces événements pour détecter et résoudre les problèmes liés aux terminaux avant que Meta ne bloque ou ne limite votre flux. Pour plus d'informations sur la configuration des flux dynamiques, consultezConfiguration de flux dynamiques.

Avertissements d'expiration de la version Flow

Meta envoie un webhook d'avertissement lorsque la version JSON de Flow utilisée par votre Flow approche de sa date de fin de vie. Lorsqu'une version expire, vous ne pouvez pas envoyer le Flow tant que vous n'avez pas effectué la mise à jour vers une version plus récente.

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

Lorsque vous recevez cet avertissement, mettez à jour votre Flow JSON pour utiliser la version recommandée (actuellement 7.3) en appelant UpdateWhatsAppFlowAssets avec le JSON mis à jour, puis republiez le Flow.