Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Empfangen von Flow-Antworten und Statusänderungen

Wenn ein Benutzer einen Flow abschließt oder wenn sich der Status eines Flows ändert, sendet AWS End User Messaging Social Webhook-Benachrichtigungen über Ihr bereits konfiguriertes Event-Ziel. Es sind keine zusätzlichen Einstellungen oder neue Ereignistypen erforderlich — Flow-Ereignisse werden automatisch an dasselbe Eventziel gesendet, das Sie für Nachrichten und Empfangsbestätigungen verwenden. Sie müssen ein Event-Ziel aktiviert haben, um diese Benachrichtigungen zu erhalten. Weitere Informationen finden Sie unter Fügen Sie eine Nachricht und ein Eventziel hinzu AWS Nachrichten für Endbenutzer in sozialen Netzwerken.

Flow-Antwortnachrichten

Wenn ein Benutzer einen Flow abschließt, erhalten Sie eine eingehende Nachricht mit dem Typ interactive und dem nfm_reply Subtyp. Das response_json Feld enthält die vom Benutzer als JSON-Zeichenfolge übermittelten Daten.

Das folgende Beispiel zeigt eine Flow-Antwort-Webhook-Nutzlast:

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

Das response_json enthält Schlüssel-Wert-Paare, die den in Ihrem Flow-JSON definierten Formularfeldnamen und den vom Benutzer eingegebenen Werten entsprechen. Analysieren Sie diese JSON-Zeichenfolge, um die übermittelten Daten zu extrahieren.

Benachrichtigungen über Änderungen des Flow-Status

Wenn Meta den Status eines Flows ändert (z. B. von PUBLISHED zu BLOCKED), erhältst du eine Benachrichtigung über dein Event-Ziel. Das folgende Beispiel zeigt eine Payload für eine Statusänderung:

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

Überwachen Sie diese Statusänderungsereignisse, um zu erkennen, wann Meta Ihre Flows blockiert oder drosselt, sodass Sie Abhilfemaßnahmen ergreifen können.

Benachrichtigungen zum Status von Endpunkten (dynamische Flows)

Bei dynamischen Flows mit einem Endpunkt überwacht Meta den Zustand der Endpunkte und sendet Benachrichtigungen, wenn Probleme erkannt werden. Sie erhalten diese über Ihr konfiguriertes Event-Ziel.

Endpunkt-Fehlerrate — Wird gesendet, wenn die Fehlerrate in den letzten 30 Minuten einen Schwellenwert überschreitet:

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

Endpunktlatenz — Wird gesendet, wenn die p90-Latenz den Schwellenwert überschreitet:

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

Endpunktverfügbarkeit — Wird gesendet, wenn die Endpunktverfügbarkeit unter den Schwellenwert fällt:

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

Überwache diese Ereignisse, um Endpunktprobleme zu erkennen und zu lösen, bevor Meta deinen Flow blockiert oder drosselt. Weitere Informationen zum Einrichten dynamischer Flows finden Sie unter. Dynamische Flows einrichten

Warnungen vor Ablauf der Flow-Version

Meta sendet einen warnenden Webhook, wenn sich die von deinem Flow verwendete Flow JSON-Version dem Enddatum nähert. Wenn eine Version abläuft, kannst du den Flow erst senden, wenn du auf eine neuere Version aktualisiert hast.

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

Wenn du diese Warnung erhältst, aktualisiere dein Flow-JSON, um die empfohlene Version (derzeit 7.3) zu verwenden, indem du UpdateWhatsAppFlowAssets mit dem aktualisierten JSON aufrufst und den Flow dann erneut veröffentlichst.