WhatsApp Flows erstellen und bearbeiten

Sie können einen WhatsApp Flow mithilfe der AWS End User Messaging Social Console oder der AWS End User Messaging Social API erstellen. Wenn Sie einen Flow erstellen, erhält er den Status ENTWURF. Sie können optional bei der Erstellung eine Flow-JSON-Definition angeben oder sie später mithilfe des Vorgangs „Assets aktualisieren“ hinzufügen.

Einen Flow erstellen (Konsole)

1. Öffnen Sie die AWS End User Messaging Social-Konsole unter https://console.aws.amazon.com/social-messaging/.

2. Wählen Sie Geschäftskonto und anschließend eine WABA aus.

3. Wählen Sie die Registerkarte „Flows“.

4. Wählen Sie Create Flow (Flow erstellen) aus.

5. Geben Sie unter Flow-Name einen eindeutigen Namen für Ihren Flow ein. Flow-Namen müssen innerhalb der WABA eindeutig sein (maximal 200 Zeichen).

6. Wählen Sie unter Kategorie eine oder mehrere Kategorien aus, die den Geschäftszweck Ihres Flows beschreiben. Es ist mindestens eine Kategorie erforderlich. Verfügbare Kategorien sind:

   • Registrieren

   • Loggen Sie sich ein

   • Buchung eines Termins

   • Generierung von Leads

   • Kontakt

   • Kundensupport

   • Umfrage

   • Einkaufen

   • Sonstige

7. Wählen Sie unter Vorlage eine vorgefertigte Vorlage aus, mit der Sie beginnen möchten, oder wählen Sie Standard, um mit einem leeren Flow zu beginnen. Die folgenden Vorlagen sind ohne Endpunkt verfügbar:

   • Standard — Eine leere Startvorlage

   • Kaufinteresse einholen — Sammeln Sie Informationen von potenziellen Käufern

   • Feedback einholen — Kundenfeedback einholen

   • Umfrage senden — Erstellen Sie eine Umfrage mit mehreren Fragen

   • Kundensupport — Sammeln Sie Details zur Support-Anfrage

8. Wählen Sie Erstellen aus.

Nachdem Sie den Flow erstellt haben, können Sie den Flow-JSON bearbeiten, um die Bildschirme und Komponenten anzupassen. Die Flow-Vorschau auf der rechten Seite der Seite zeigt eine Live-Vorschau, wie Ihr Flow den Benutzern in angezeigt wird WhatsApp.

Einen Flow (API) erstellen

Verwenden Sie die CreateWhatsAppFlow API, um einen neuen Flow zu erstellen. Im folgenden Beispiel wird der verwendet AWS CLI, um einen Flow mit einem Namen und einer Kategorie zu erstellen:

aws socialmessaging create-whatsapp-flow \
    --id {WABA_ID} \
    --flow-name "my_lead_generation_form" \
    --categories '["LEAD_GENERATION"]'

Die Antwort enthält die von Meta zugewiesene Flow-ID:

{
    "flowId": "{FLOW_ID}",
    "validationErrors": []
}

Sie können bei der Erstellung auch eine Flow-JSON-Definition angeben und sofort veröffentlichen:

aws socialmessaging create-whatsapp-flow \
    --id {WABA_ID} \
    --flow-name "appointment_booking" \
    --categories '["APPOINTMENT_BOOKING"]' \
    --flow-json fileb://flow.json \
    --publish

Anmerkung

Wenn Sie angeben--publish, muss die Flow-JSON-Datei gültig sein und die Meta-Validierung bestehen. Wenn es Validierungsfehler gibt, wird der Flow im Status DRAFT erstellt und die Fehler werden im validationErrors Feld zurückgegeben.

So klonen Sie einen vorhandenen Flow innerhalb derselben WABA:

aws socialmessaging create-whatsapp-flow \
    --id {WABA_ID} \
    --flow-name "lead_form_v2" \
    --categories '["LEAD_GENERATION"]' \
    --clone-flow-id {FLOW_ID}

Einen Flow aktualisieren

Es gibt zwei Arten von Aktualisierungen, die Sie an einem Flow vornehmen können:

• Metadaten aktualisieren — Ändern Sie den Namen oder die Kategorien des Flows mithilfe vonUpdateWhatsAppFlow.

• Assets aktualisieren — Ändern Sie die Flow-JSON-Definition mithilfe vonUpdateWhatsAppFlowAssets.

Wichtig

Durch das Aktualisieren der Assets eines veröffentlichten Flows wird der Status auf ENTWURF zurückgesetzt. Sie müssen den Flow erneut veröffentlichen, damit er in Nachrichten verwendet werden kann.

Im folgenden Beispiel wird der Name eines Flows aktualisiert:

aws socialmessaging update-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id {FLOW_ID} \
    --flow-name "updated_lead_form"

Das folgende Beispiel aktualisiert die JSON-Definition eines Flows:

aws socialmessaging update-whatsapp-flow-assets \
    --id {WABA_ID} \
    --flow-id {FLOW_ID} \
    --flow-json fileb://updated_flow.json

Wenn der Flow-JSON Validierungsfehler enthält, werden diese in der Antwort zurückgegeben. Sie müssen diese Fehler beheben, bevor Sie den Flow veröffentlichen können.

Flows auflisten und anzeigen

ListWhatsAppFlowsDient zum Anzeigen aller Flows für eine WABA und GetWhatsAppFlow zum Abrufen von Details zu einem bestimmten Flow.

Alle Flows auflisten:

aws socialmessaging list-whatsapp-flows \
    --id {WABA_ID}

Rufen Sie Details für einen bestimmten Flow ab:

aws socialmessaging get-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id {FLOW_ID}

Die GetWhatsAppFlow Antwort umfasst den Flow-Status, die Kategorien, die Validierungsfehler, die JSON-Version, Vorschauinformationen und den Gesundheitsstatus.

Um die Flow JSON-Definition (Assets) abzurufen, verwenden SieListWhatsAppFlowAssets:

aws socialmessaging list-whatsapp-flow-assets \
    --id {WABA_ID} \
    --flow-id {FLOW_ID}

Die Antwort enthält eine vorsignierte Download-URL für die Flow-JSON-Datei. Die URL läuft nach kurzer Zeit ab. Es ist keine zusätzliche Authentifizierung erforderlich, um die Datei von der URL herunterzuladen.

Einen Flow löschen

Sie können nur Flows löschen, die sich im Status ENTWURF befinden. Veröffentlichte oder veraltete Flows können nicht gelöscht werden.

Um einen Flow mithilfe der Konsole zu löschen, wählen Sie den Flow auf der Registerkarte Flows aus und klicken Sie dann auf Löschen.

Um einen Flow mithilfe der API zu löschen:

aws socialmessaging delete-whatsapp-flow \
    --id {WABA_ID} \
    --flow-id {FLOW_ID}

Warnung

Das Löschen eines Flows ist dauerhaft und kann nicht rückgängig gemacht werden.