Schlagwort: Interaktive Nachrichten

Buttons, Listen, Produktnachrichten und WhatsApp Flows: Nachrichten, mit denen Kunden direkt im Chat handeln.

  • Interaktive WhatsApp-Nachrichten: Buttons, Listen und Antwortoptionen

    Interaktive WhatsApp-Nachrichten: Buttons, Listen und Antwortoptionen

    Interaktive WhatsApp-Nachrichten helfen Kunden, deinem Unternehmen zu antworten, indem sie ihnen vorbereitete Antworten als Buttons, Listenzeilen oder Links anbieten. So antworten Kunden genau so, wie du es erwartest, auch dort, wo Freitext sie raten lassen oder zu Missverständnissen führen würde. Du kannst diese Nachrichten nur als Antworten senden, innerhalb von 24 Stunden nach der letzten Nachricht oder dem letzten Anruf eines Kunden. Meta berechnet Buttons und Listen als Servicenachrichten, und jede Business-Telefonnummer erhält die ersten 1.000 pro Monat kostenlos.

    Das Wichtigste in Kürze

    1. Buttons und Listen geben Kunden fertige Antworten, sodass jede Antwort eindeutig ist und dein System sie verarbeiten kann, ohne dass jemand Freitext liest.
    2. Interaktive Nachrichten kannst du nur innerhalb von 24 Stunden nach der Nachricht oder dem Anruf eines Kunden senden, und für alles Spätere brauchst du ein freigegebenes Template.
    3. Wähle das Format nach der Größe der Auswahl: Antwort-Buttons für bis zu 3 Optionen, eine Liste für bis zu 10 und einen Flow, wenn du mehrere Felder auf einmal brauchst.
    4. Buttons und Listen kosten so viel wie jede andere Servicenachricht, und die ersten 1.000 pro Business-Telefonnummer und Monat sind kostenlos.

    Was sind interaktive WhatsApp-Nachrichten?

    Interaktive WhatsApp-Nachrichten sind Antworten mit eingebauten Bedienelementen wie Buttons, einer Liste oder einem Link-Button. Du legst die Optionen fest, und der Kunde wählt die passende aus.

    Meta stuft Antwort-Buttons, Listen und die meisten anderen interaktiven Typen als Servicenachrichten ein: frei formulierte Nachrichten, die keine Template-Freigabe brauchen.[1] Du sendest sie über die WhatsApp Cloud API, solange ein Kundenservice-Fenster offen ist. Das Fenster öffnet sich, wenn ein Kunde deinem Unternehmen schreibt oder es anruft, und bleibt 24 Stunden offen. Jede neue Nachricht und jeder neue Anruf setzt es zurück. Außerdem muss der Kunde per Opt-in zugestimmt haben, Nachrichten von dir zu erhalten.

    Sobald das Fenster geschlossen ist, kommen nur noch freigegebene Templates durch. Formuliere jedes spätere Follow-up als Template und bring es durch die Template-Freigabe.

    Welche interaktiven Nachrichtentypen kannst du senden?

    In einem offenen Fenster kannst du sechs interaktive Typen senden, jeden für eine andere Art von Antwort. Ordne jeden Typ anhand der Tabelle seiner Aufgabe zu, bevor du JSON schreibst.

    Typinteractive.typeEinsatzWichtigstes LimitWas der Kunde tut
    Antwort-ButtonsbuttonBestätigen, verschieben oder absagenBis zu 3 Buttons.[2]Wählt einen Button
    ListelistThemen oder LieferfensterBis zu 10 Zeilen über alle Abschnitte.[3]Wählt eine Zeile
    CTA-URL-Buttoncta_urlLink zu einer WebseiteEin Button, der eine Beschriftung mit einer URL verknüpft.[4]Öffnet die Seite im Browser
    MedienkarussellcarouselVisuelle OptionenEin Bild- oder Video-Header auf jeder Karte.[5]Wählt einen Button auf einer Karte
    Standortanfragelocation_request_messageAbhol- oder LieferortEin Button zum Senden des Standorts unter dem Nachrichtentext.[6]Teilt einen Standort
    Adressnachrichtaddress_messageLieferadresseNur für Unternehmen und Kunden in Indien.[7]Gibt eine Adresse ein

    Unser Leitfaden zu Produkt- und Katalognachrichten behandelt die interaktiven Nachrichten, die Produkte aus einem Katalog zeigen.

    Wie funktionieren Antwort-Buttons?

    Antwort-Buttons setzen ein paar feste Antworten unter deinen Text, und die Wahl des Kunden kommt mit der ID, die du diesem Button gegeben hast, an deinen Webhook zurück. Nutze sie, wenn du jede gültige Antwort vorab kennst, etwa ob ein Termin bleibt, verschoben oder abgesagt wird.

    Plane den Text anhand dieser Feldlimits, hier am Beispiel einer Terminerinnerung:

    FeldLimitBeispiel
    NachrichtentextPflicht, bis zu 1.024 Zeichen; URLs werden automatisch zu Links„Dein Termin ist am Freitag um 10:00 Uhr. Behalten?“
    Button-TitelPflicht, bis zu 20 Zeichen, eindeutig innerhalb der Nachricht„Behalten“, „Verschieben“, „Absagen“
    Button-IDPflicht, bis zu 256 Zeichen, eindeutig pro Buttonmove_appt_8812, benennt Aktion und Datensatz
    HeaderOptional: Text, Bild, Video oder Dokument„Terminerinnerung“
    FooterOptional, bis zu 60 Zeichen„Antworte bis Donnerstagabend“

    Lade für einen Medien-Header zuerst die Datei hoch und übergib ihre Media-ID. Meta stuft einen Medienlink im Header als „nicht empfohlen“ ein.

    Wie funktionieren Listennachrichten?

    Eine Listennachricht zeigt einen Button unter deinem Text, und dieser Button öffnet ein Menü, in dem der Kunde eine einzelne Zeile auswählt. Nutze eine Liste, wenn die Antworten feststehen, aber für Buttons zu viele sind, etwa bei Support-Themen oder Lieferfenstern.

    Abschnitte gruppieren Zeilen unter Überschriften, und das Zeilenlimit gilt für alle Abschnitte zusammen. Das sind die Feldlimits, hier am Beispiel von Lieferfenstern:

    FeldLimitBeispiel
    Menü-ButtonPflicht, bis zu 20 Zeichen„Zeitfenster ansehen“
    NachrichtentextPflicht, bis zu 4.096 Zeichen„Wähle ein Lieferfenster für deine Bestellung.“
    HeaderOptional, nur Text, bis zu 60 Zeichen„Lieferfenster“
    FooterOptional, bis zu 60 Zeichen„Du kannst das Zeitfenster später ändern“
    AbschnittstitelPflicht, bis zu 24 Zeichen, mindestens ein Abschnitt„Dienstag“
    Zeilen-IDPflicht, bis zu 200 Zeichenslot_tue_morning
    ZeilentitelPflicht, bis zu 24 Zeichen„Vormittag, 9 bis 12 Uhr“
    ZeilenbeschreibungOptional, bis zu 72 Zeichen„Der Fahrer ruft vor der Ankunft an“

    Wie funktionieren CTA-URL-Buttons?

    Ein CTA-URL-Button legt einen Weblink hinter eine kurze Beschriftung, und der Kunde öffnet die Seite mit einem Klick. Nutze ihn, wenn der nächste Schritt auf einer Website stattfindet, etwa beim Verfolgen eines Pakets oder beim Bezahlen einer Rechnung.

    Das action-Objekt erhält "name": "cta_url" mit parameters.display_text, einer Beschriftung mit bis zu 20 Zeichen, und parameters.url. Halte den Nachrichtentext bei höchstens 1.024 Zeichen. Ein optionaler Header nimmt Text mit bis zu 60 Zeichen oder Medien von einer öffentlichen URL auf, ein optionaler Footer bis zu 60 Zeichen.

    Die Seite öffnet sich im Standardbrowser des Telefons, außerhalb von WhatsApp. Miss den Besuch auf deiner eigenen Website, zum Beispiel mit einem Kampagnenparameter in der URL.

    Wie funktionieren Medienkarussell-Nachrichten?

    Ein Medienkarussell sendet 2 bis 10 Karten, durch die der Kunde seitlich scrollt, jede mit eigenem Bild oder Video und eigenem Button. Nutze es, wenn die Auswahl visuell ist, etwa bei einer von drei Zimmerkategorien oder bei Reiseterminen.

    Für den Aufbau gelten feste Regeln:

    • Haupttext: Pflicht, bis zu 1.024 Zeichen. Das Karussell hat keinen Haupt-Header, keinen Footer und keine weiteren interaktiven Komponenten.
    • Karten-Header: ein Bild oder Video auf jeder Karte. Andere Header-Typen werden nicht unterstützt.
    • Kartentext: optional, bis zu 160 Zeichen mit höchstens 2 Zeilenumbrüchen.
    • Karten-Buttons: Gib jeder Karte einen URL-Button oder mindestens einen Quick-Reply-Button, und verwende auf jeder Karte dieselben Button-Typen in derselben Anzahl. Quick-Reply-IDs fassen bis zu 256 Zeichen, Button-Beschriftungen bis zu 20.

    Weil jede Karte dieselben Buttons wiederholt, formuliere eine Aktion, die zu allen passt, etwa „Zimmer buchen“. Um ein Karussell außerhalb des Kundenservice-Fensters zu senden, nutze ein Karussell-Template, das ein eigenes Format ist.

    Wie sendest du eine interaktive Nachricht über die 360Dialog API?

    Du sendest jeden interaktiven Typ über 360Dialog mit einem einzigen Anfrageformat, demselben Nachrichten-Body, den Meta für die Cloud API dokumentiert.[8] Eine einzige Funktion zum Erstellen der Anfrage deckt damit alle sechs Typen ab, und zwischen ihnen ändert sich nur der interaktive Teil. 360Dialog, ein Official Meta Solution Partner, gibt Entwicklern direkten Zugang zur WhatsApp Business API und bietet eine Test-Sandbox.

    1. Konto vorbereiten: Du brauchst ein freigegebenes Konto mit einer registrierten Telefonnummer und den API-Schlüssel für diese Nummer.
    2. Webhook einrichten: Richte ihn auf eine HTTPS-URL mit gültigem SSL-Zertifikat aus und sorge dafür, dass er innerhalb von 80 Millisekunden 200 OK zurückgibt. Die WhatsApp Business Platform wiederholt fehlgeschlagene Zustellungen in exponentiell wachsenden Abständen bis zu 7 Tage lang.
    3. Anfrage senden: Sende den JSON-Body per POST an https://waba-v2.360dialog.io/messages, mit deinem Schlüssel im Header D360-API-KEY und Content-Type: application/json. Anfragen ohne Schlüssel werden abgelehnt.
    4. Auf den Status warten: Die API-Antwort bestätigt die Annahme, die Zustellung meldet später ein Status-Webhook. Die Reihenfolge der Zustellung ist nicht garantiert. Wenn sie wichtig ist, warte auf delivered, bevor du die nächste Nachricht sendest.

    Diese Anfrage fragt einen Kunden, ob er einen Termin behalten, verschieben oder absagen möchte:

    curl -X POST "https://waba-v2.360dialog.io/messages" \
      -H "D360-API-KEY: $D360_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "messaging_product": "whatsapp",
        "to": "<CUSTOMER_PHONE_NUMBER>",
        "type": "interactive",
        "interactive": {
          "type": "button",
          "body": { "text": "Dein Termin ist am Freitag um 10:00 Uhr. Behalten?" },
          "action": {
            "buttons": [
              { "type": "reply", "reply": { "id": "keep_appt_8812", "title": "Behalten" } },
              { "type": "reply", "reply": { "id": "move_appt_8812", "title": "Verschieben" } },
              { "type": "reply", "reply": { "id": "cancel_appt_8812", "title": "Absagen" } }
            ]
          }
        }
      }'

    Eine Antwort-Button- oder Listennachricht, die du außerhalb des 24-Stunden-Fensters sendest, gibt einen Fehler zurück.[9] Prüfe das Fenster in deinem Code vor jedem Versand. Mit API starten: Verbinde deine Nummer über 360Dialog und sende diese Anfrage als ersten Test an dein eigenes Telefon.

    Wie liest du die Antwort des Kunden aus?

    Die Wahl des Kunden erreicht deinen Webhook als eingehende Nachricht mit der ID, die du für den Button oder die Zeile festgelegt hast. Steuere die weitere Verarbeitung über diese ID. Dein Bot muss dann bei einer geschlossenen Frage nie Freitext interpretieren.

    Antworten kommen im Webhook-Feld messages an, und context.id enthält die ID der beantworteten Nachricht.[10] Jede Aktion liefert ein eigenes Objekt:

    Aktion des KundenNachrichten-typeAntwortobjektFelder, die du erhältst
    Wählt einen Antwort-Buttoninteractivebutton_replyid, title
    Wählt eine Listenzeileinteractivelist_replyid, title, description
    Teilt einen StandortlocationStandortfelderBreitengrad, Längengrad sowie optional Name und Adresse
    Sendet eine Adresse oder einen Flow abinteractivenfm_replyresponse_json
    Wählt einen Quick-Reply-Button in einem Templatebuttonbuttonpayload, text.[11]

    Sendet eine Nummer sowohl Templates als auch interaktive Nachrichten, verarbeite auch das Antwortformat der Templates.

    Flow oder Buttons: Was solltest du nutzen?

    Nutze Antwort-Buttons oder eine Liste, wenn der Kunde eine Antwort aus einer kurzen, festen Auswahl wählt, und einen Flow, wenn du getippte Angaben oder mehrere Antworten auf einmal brauchst. Wählst du nach der Form der Antwort, bleibt jede Unterhaltung so kurz, wie die Aufgabe es zulässt.

    Eine Buchung, die Datum, Uhrzeit und Personenzahl braucht, kostet mit Buttons drei Nachrichten, und jede wird berechnet, sobald das Freikontingent aufgebraucht ist. Ein WhatsApp Flow ist ein Formular, das sich im Chat öffnet und alle drei Angaben in einer Antwort erfasst.

    Offene Fragen, etwa die Beschreibung eines Defekts, eignen sich später im Chat für Freitext. Für die erste Nachricht rät Metas Leitfaden zur Nachrichtenqualität: „Vermeide offene Begrüßungs- oder Einführungsnachrichten.“

    Antwort, die du brauchstPassendes Format
    Eine Wahl aus bis zu 3 OptionenAntwort-Buttons
    Eine Wahl aus 4 bis 10 OptionenListennachricht
    Eine Wahl, die von einem Bild abhängtMedienkarussell
    Ein Schritt, der auf einer Website stattfindetCTA-URL-Button
    Mehrere Felder, Datumsangaben oder geprüfte EingabenWhatsApp Flow
    Eine offene Beschreibung in den Worten des KundenFreitext

    Unser Leitfaden zeigt, wie du einen WhatsApp Flow erstellst.

    Kosten interaktive Nachrichten extra?

    Für Buttons oder Listen fällt kein Aufschlag an: Meta berechnet jede zugestellte interaktive Nachricht als Servicenachricht, dieselbe Kategorie wie eine einfache Textantwort.[12] Plane interaktive Antworten mit dem Servicetarif deines Markts ein.

    Seit dem 1. Oktober 2026 kostet jede zugestellte Servicenachricht so viel wie eine Utility- oder Authentifizierungsnachricht im jeweiligen Markt, ohne Mengenstaffeln. Jede Business-Telefonnummer sendet ihre ersten 1.000 Servicenachrichten pro Monat kostenlos, und das ungenutzte Kontingent verfällt am Monatsende. Hinterlege eine Zahlungsmethode im Konto, sonst stellt Meta keine Servicenachrichten mehr zu, sobald das Freikontingent aufgebraucht ist.

    Status-Webhooks zeigen unter "category": "service", welche Nachrichten du bezahlst: "type": "free_customer_service" innerhalb des Freikontingents und "type": "regular" mit "billable": true, sobald die Abrechnung beginnt.

    Kommt ein Kunde über eine Click-to-WhatsApp Ad auf Android oder iOS, antworte innerhalb des Kundenservice-Fensters. Das öffnet ein kostenloses Einstiegspunktfenster von bis zu 7 Tagen, in dem Servicenachrichten nichts kosten. Unser Beitrag zur Abrechnung von Servicenachrichten erklärt die Änderung im Detail.

    Beginne mit der Frage, die deine Kunden am häufigsten beantworten, etwa die Bestätigung eines Termins oder die Wahl eines Lieferfensters. Mit fertigen Optionen antworten Kunden in einem Schritt, und dein Team muss nicht mehr nachfragen, was eine Nachricht bedeuten sollte. Jede Antwort führt direkt zur richtigen nächsten Aktion. Mit API starten: Sende deine erste interaktive Antwort über 360Dialog und lies die Antwort auf deinem eigenen Webhook aus.

    Häufig gestellte Fragen

    Sind WhatsApp-Servicenachrichten 2026 noch kostenlos?

    WhatsApp-Servicenachrichten sind nur innerhalb eines monatlichen Freikontingents kostenlos. Seit dem 1. Oktober 2026 berechnet Meta jede zugestellte Servicenachricht nach den ersten 1.000 pro Business-Telefonnummer und Monat. Das Kontingent beginnt jeden Monat neu, und ungenutzte Nachrichten verfallen. Eine Click-to-WhatsApp Ad kann ein kostenloses Einstiegspunktfenster öffnen, in dem Servicenachrichten bis zu 7 Tage lang kostenlos bleiben.

    Kannst du eine interaktive Nachricht außerhalb des 24-Stunden-Fensters senden?

    Interaktive Nachrichten kannst du nur innerhalb von 24 Stunden nach der letzten Nachricht oder dem letzten Anruf eines Kunden bei deinem Unternehmen senden. Sobald dieses Kundenservice-Fenster schließt, erreicht nur noch ein freigegebenes Template den Kunden. Ein Template kann eigene Quick-Reply-Buttons enthalten, und die Antwort des Kunden darauf öffnet ein neues Fenster für interaktive Nachrichten.

    Wie fragst du einen Kunden auf WhatsApp nach seinem Standort?

    Eine Standortanfrage bittet den Kunden, über einen Button unter deinem Text seinen Standort zu teilen. Der Nachrichtentext fasst bis zu 1.024 Zeichen und kann URLs enthalten. Teilt der Kunde seinen Standort, empfängt dein Webhook eine Standortnachricht mit Breiten- und Längengrad. Name und Adresse kommen nur mit, wenn der Kunde sie selbst hinzufügt.

    Kannst du mit einer interaktiven Nachricht eine Lieferadresse erfassen?

    Adressnachrichten erfassen eine Lieferadresse direkt in WhatsApp und stehen nur Unternehmen mit Sitz in Indien zur Verfügung, die Kunden in Indien schreiben. Der Länderparameter ist Pflicht, und du kannst Werte vorausfüllen oder gespeicherte Adressen anbieten. Die übermittelte Adresse kommt als nfm_reply mit einem Feld response_json zurück. Ein Client, der die Nachricht nicht anzeigen kann, verwirft sie, und ein Status-Webhook meldet Fehler 1026, Receiver Incapable.

    Warum empfängt mein Webhook keine Button-Antworten?

    Button-Antworten kommen als eingehende Nachrichten über Metas messages-Webhook an, denselben Kanal wie Textantworten. Bei 360Dialog muss dein Endpunkt HTTPS mit einem gültigen SSL-Zertifikat nutzen, 200 OK zurückgeben und innerhalb von 80 Millisekunden antworten. Die WhatsApp Business Platform wiederholt fehlgeschlagene Zustellungen in exponentiell wachsenden Abständen bis zu 7 Tage lang, und ein Endpunkt, den du in dieser Zeit reparierst, erhält die verpassten Antworten noch.

    Quellen

    [1] Meta for Developers, „Service messages.“ Updated May 21, 2026. Accessed October 16, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/send-messages/

    [2] Meta for Developers, „Interactive reply buttons messages.“ Updated May 21, 2026. Accessed October 16, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/interactive-reply-buttons-messages/

    [3] Meta for Developers, „Interactive list messages.“ Updated July 2, 2026. Accessed October 16, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/interactive-list-messages/

    [4] Meta for Developers, „Interactive CTA URL button messages.“ Updated July 2, 2026. Accessed October 16, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/interactive-cta-url-messages/

    [5] Meta for Developers, „Interactive media carousel messages.“ Updated May 21, 2026. Accessed October 16, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/interactive-media-carousel-messages/

    [6] Meta for Developers, „Location request messages.“ Updated May 21, 2026. Accessed October 16, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/location-request-messages/

    [7] Meta for Developers, „Address messages.“ Updated July 2, 2026. Accessed October 16, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/address-messages/

    [8] 360Dialog Documentation, „Send and receive messages.“ Accessed October 16, 2026. https://docs.360dialog.com/docs/guides/send-and-receive-messages

    [9] 360Dialog Documentation, „Interactive messages.“ Accessed October 16, 2026. https://docs.360dialog.com/docs/messaging/message-types/interactive

    [10] Meta for Developers, „Interactive messages webhook reference.“ Updated August 3, 2026. Accessed October 16, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/messages/interactive/

    [11] Meta for Developers, „Button messages webhook reference.“ Updated June 17, 2026. Accessed October 16, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/messages/button/

    [12] Meta for Developers, „Pricing on the WhatsApp Business Platform.“ Updated September 30, 2026. Accessed October 16, 2026. https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing/