View a markdown version of this page

WhatsApp Flows an Benutzer senden - AWS Nachrichten für Endbenutzer in sozialen Netzwerken
Beispiel: Senden eines Flows per VorlagennachrichtEine Vorlage für Flows einrichten

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.

WhatsApp Flows an Benutzer senden

Sie senden Flows mithilfe der vorhandenen API über Vorlagennachrichten an Benutzer. SendWhatsAppMessage Es sind keine Änderungen an der API zum Senden von Nachrichten erforderlich. Der Flow ist als Schaltflächenkomponente mit einem flow Untertyp in die Vorlagennachricht eingebettet.

Bevor Sie einen Flow senden können, muss Folgendes zutreffen:

  • Der Flow muss den Status VERÖFFENTLICHT haben.

  • Sie benötigen eine Nachrichtenvorlage, die auf den Flow verweist (mit einer Flow-Schaltfläche).

  • Der Benutzer muss sich für den Empfang von Nachrichten von Ihnen angemeldet haben.

Beispiel: Senden eines Flows per Vorlagennachricht

Im folgenden Beispiel wird eine Vorlagennachricht gesendet, die eine Flow-Schaltfläche enthält. Dabei flow_token handelt es sich um eine eindeutige Kennung, die Sie angeben, um die Sitzung zu verfolgen. Sie flow_action_data gibt den Startbildschirm und alle Anfangsdaten an.

aws socialmessaging send-whatsapp-message \
    --origination-phone-number-id {PHONE_NUMBER_ID} \
    --meta-api-version v20.0 \
    --message '{
        "messaging_product": "whatsapp",
        "to": "+14085551234",
        "type": "template",
        "template": {
            "name": "flow_template_name",
            "language": {"code": "en_US"},
            "components": [
                {
                    "type": "button",
                    "sub_type": "flow",
                    "index": "0",
                    "parameters": [
                        {
                            "type": "action",
                            "action": {
                                "flow_token": "unique-session-token-123",
                                "flow_action_data": {
                                    "screen": "WELCOME_SCREEN",
                                    "data": {}
                                }
                            }
                        }
                    ]
                }
            ]
        }
    }'

Ersetzen Sie im vorherigen Befehl Folgendes:

  • {PHONE_NUMBER_ID}— Die ID Ihrer ursprünglichen Telefonnummer.

  • +14085551234— Die Telefonnummer des Empfängers im internationalen Format.

  • flow_template_name— Der Name Ihrer genehmigten Nachrichtenvorlage, die eine Flow-Schaltfläche enthält.

  • unique-session-token-123— Ein eindeutiges Token, das Sie generieren, um diese Flow-Sitzung zu identifizieren. Dieses Token wird im Webhook zurückgegeben, wenn der Benutzer den Flow abschließt.

  • WELCOME_SCREEN— Die ID des ersten Bildschirms in Ihrer Flow JSON-Definition.

Anmerkung

Sie flow_token sollte pro Sitzung einzigartig sein, damit Sie Flow-Antworten mit bestimmten Sendeereignissen korrelieren können. Sie können eine UUID oder eine andere eindeutige Kennung verwenden.

Eine Vorlage für Flows einrichten

Um einen Flow zu senden, benötigen Sie eine Nachrichtenvorlage mit einer konfigurierten Flow-Schaltfläche. Fügen Sie bei der Erstellung der Vorlage eine Call-to-Action-Schaltfläche hinzuFLOW, die auf Ihre veröffentlichte Flow-ID verweist.

Weitere Informationen zum Erstellen von Nachrichtenvorlagen finden Sie unter. Nachrichtenvorlagen in AWS End User Messaging Social verwenden Informationen zur Konfiguration von Flow-Vorlagen finden Sie unter Senden eines Flows in der Dokumentation zur Meta WhatsApp Business Platform.