Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Ricezione delle risposte di Flow e delle modifiche allo stato

Quando un utente completa un flusso o quando lo stato di un flusso cambia, AWS End User Messaging Social invia notifiche webhook tramite la destinazione dell'evento configurata esistente. Non è richiesta alcuna configurazione aggiuntiva o nuovi tipi di eventi: gli eventi di Flow vengono recapitati automaticamente alla stessa destinazione dell'evento utilizzata per i messaggi e le ricevute di consegna. È necessario che una destinazione dell'evento sia abilitata per ricevere queste notifiche. Per ulteriori informazioni, consulta Aggiungi un messaggio e la destinazione dell'evento a AWS Messaggistica social per gli utenti finali.

Messaggi di risposta al flusso

Quando un utente completa un flusso, ricevi un messaggio in entrata con il tipo interactive e il sottotipo. nfm_reply Il response_json campo contiene i dati inviati dall'utente come stringa JSON.

L'esempio seguente mostra un payload webhook di risposta 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_jsonContiene coppie chiave-valore corrispondenti ai nomi dei campi del modulo definiti nel JSON di Flow e ai valori immessi dall'utente. Analizza questa stringa JSON per estrarre i dati inviati.

Notifiche di modifica dello stato del flusso

Quando Meta modifica lo stato di un flusso (ad esempio, da PUBBLICATO a BLOCCATO), ricevi una notifica tramite la destinazione dell'evento. L'esempio seguente mostra un payload per la modifica dello stato:

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

Monitora questi eventi di modifica dello stato per rilevare quando Meta blocca o limita i tuoi flussi in modo da poter intraprendere azioni correttive.

Notifiche sullo stato degli endpoint (flussi dinamici)

Per i flussi dinamici con un endpoint, Meta monitora lo stato degli endpoint e invia notifiche quando vengono rilevati problemi. Li ricevi tramite la destinazione dell'evento configurata.

Tasso di errore degli endpoint: inviato quando il tasso di errore supera una soglia negli ultimi 30 minuti:

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

Latenza dell'endpoint: inviato quando la latenza p90 supera la soglia:

{
    "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à degli endpoint: inviato quando la disponibilità degli endpoint scende al di sotto della soglia:

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

Monitora questi eventi per rilevare e risolvere i problemi degli endpoint prima che Meta blocchi o limiti il flusso. Per ulteriori informazioni sulla configurazione dei flussi dinamici, consulta. Impostazione dei flussi dinamici

Avvisi di scadenza della versione di Flow

Meta invia un webhook di avviso quando la versione JSON di Flow utilizzata da Flow si avvicina alla data di fine vita. Quando una versione scade, non puoi inviare il Flow finché non esegui l'aggiornamento a una versione più 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"
                }
            ]
        }
    ]
}

Quando ricevi questo avviso, aggiorna il tuo Flow JSON per utilizzare la versione consigliata (attualmente 7.3) chiamando UpdateWhatsAppFlowAssets con il JSON aggiornato, quindi pubblica nuovamente il Flow.