Der MaviBot-Builder unterstützt auch die offizielle WhatsApp Business API.

So verbinden Sie WhatsApp Business

Um die WhatsApp Business API (WABA) mit Ihrem Projekt zu verbinden, gehen Sie zum Bereich Messengers und wählen Sie WhatsApp Business API.

Verbinden der WhatsApp Business API

Melden Sie sich im sich öffnenden Fenster mit Ihrem Facebook-Konto an. Klicken Sie dann auf die Schaltfläche „Über Facebook verbinden“.

Geben Sie bei Bedarf Ihr Facebook-Passwort ein, um fortzufahren.

Die Einrichtung ist nun abgeschlossen. Sie müssen Ihr Telefon nicht ständig online halten; der Bot arbeitet stabil und autonom.

Nachrichtenvorlagen für WhatsApp Business API

Bei Verwendung der WhatsApp Business API können Benutzer nicht zu jeder Tageszeit Nachrichten an Kunden senden und unbegrenzt viele Nachrichten beim Erstellen eines Bots versenden, ähnlich wie beim grauen WhatsApp, außerhalb des 24-Stunden-Kundendienstfensters.

Außerhalb des 24-Stunden-Fensters können nur WhatsApp-Nachrichtenvorlagen (oder WhatsApp-Vorlagennachrichten) verwendet werden, während derer die Kommunikation innerhalb der ausgewählten Kategorie kostenlos erfolgt.

Diese Funktionalität wird in WhatsApp verwendet, um Spam-Mailings zu verhindern, indem die Anzahl der zulässigen Nachrichten in einem bestimmten Zeitintervall begrenzt wird und Vorlagen eine Kategorie zugewiesen wird.

Es gibt die folgenden Nachrichtenkategorien, die von Meta für WhatsApp Business API installiert wurden:

1. Nützliche Vorlagen (enthalten spezifische Informationen zu Transaktionen, Rechnungen, Zahlungen usw.);

2. Vorlagen für Marketing (Informationen über das Unternehmen, die Organisation, Strategien, Werbung und Verkaufsförderung);

3. Vorlagen für Verifizierung und Authentifizierung.

Die für WABA erstellten Vorlagen werden moderiert.

Die Hauptgründe für die Ablehnung von Vorlagen

Eine beträchtliche Anzahl von Vorlagen besteht die WhatsApp-Moderation aus mehreren Gründen nicht:

  1. Übermäßige Werbung: WhatsApp Business lehnt Vorlagen ab, die mit Anzeigen und Werbeinhalten überladen sind. Wenn Moderatoren oder die KI der Plattform feststellen, dass Werbung die Kernbotschaft überschattet, wird die Vorlage blockiert.
  2. Verstoß gegen die Produktrichtlinie: Vorlagen, die verbotene Artikel wie Betäubungsmittel, psychotrope Substanzen, Alkohol, Tabak, intime Dienstleistungen oder Inhalte, die die Menschenwürde verletzen, bewerben, werden abgelehnt.
  3. Mehrdeutigkeit, Auslassung oder Falschheit: Wenn WhatsApp-Moderatoren versteckten Subtext, irreführende Informationen oder fehlende klare Details über Ihr Unternehmen oder Ihre Dienstleistung erkennen, wird die Vorlage nicht genehmigt.
  4. Erfassung vertraulicher Informationen: Vorlagen, die darauf ausgelegt sind, sensible Benutzerdaten zu sammeln (z. B. Passnummern, Bankkartendaten, persönliche ID-Nummern, Wohnadressen), bestehen die Moderation nicht.
  5. Anstößiger Inhalt: Jede Nachricht, die Informationen enthält, die Benutzer aufgrund von Rasse, Nationalität, Geschlecht, Identität oder anderen Kriterien beleidigen könnten, wird abgelehnt.
  6. Ermessensablehnung: WhatsApp-Moderatoren behalten sich das Recht vor, Vorlagen ohne Angabe eines bestimmten Grundes abzulehnen.

So installieren Sie Nachrichtenvorlagen

Da Vorlagen aus Blöcken erstellt werden, müssen Sie zuerst einen Block in Ihrem Flow erstellen, bevor Sie ihn für eine WhatsApp Business API-Vorlage verwenden.

  • Kosten und erste Nachricht: Das Senden von Vorlagennachrichten ist innerhalb des 24-Stunden-Konversationsfensters kostenlos. Die erste Nachricht an einen Kunden kann nur eine Vorlage sein, die von Meta (Facebook) genehmigt wurde.
  • Nach 24 Stunden: Sobald 24 Stunden seit dem Öffnen des Chats vergangen sind, können Sie nur eine weitere genehmigte Vorlage senden, um den Benutzer erneut zu erreichen.
  • Hinweis zur Moderation: Vorlagen können die Moderation nicht bestehen, wenn sie Variablen enthalten (in kyrillischer oder lateinischer Schrift).

Erstellen von Vorlagen in MaviBot

  1. Gehen Sie zum Bereich Channels, wählen Sie WhatsApp Business API und dann Nachrichtenvorlagen.

  1. Klicken Sie auf die Schaltfläche „Vorlage erstellen“. Dadurch wird die Seite zur Vorlagenerstellung geöffnet.
  2. Vorlagen sind mit Blöcken in Ihrem Flow verknüpft. Standardmäßig wird der Vorlageninhalt aus dem Block übernommen, aber Sie können benutzerdefinierten Text und Schaltflächen angeben.

  1. Die Nachrichtenvorlage wird bei der Erstellung zur Moderation eingereicht. Sie können nur genehmigte Vorlagen verwenden. Die Moderation dauert in der Regel etwa 8 Stunden, maximal 48 Stunden.

Vorlagentypen

Es stehen 3 Arten von Vorlagen zur Auswahl.

Sie können ein Bild an die MARKETING-Vorlage in den folgenden Formaten anhängen: SVG, PNG, JPG und GIF.

So übergeben Sie Variablen in Vorlagen

Variablen in Vorlagen werden auf die gleiche Weise behandelt wie in ganz MaviBot, nicht gemäß dem nativen Format von WhatsApp.

Unser System ist für MaviBot-Variablen angepasst und unterstützt keine Variablen im Format {{1}}

Verwenden von Variablen in WhatsApp-Vorlagennachrichten

Wenn Sie Variablen in Nachrichtenvorlagen verwenden müssen, befolgen Sie diese Regel: schreiben Sie Variablennamen immer nur mit lateinischen Buchstaben, z. B. #{example}. Überprüfen Sie nach dem Senden, ob die Variablen korrekt verarbeitet werden, indem Sie die Nachricht über den bereitgestellten Link prüfen.

Wenn eine Vorlage eine Variable enthält, der Bot ihr jedoch keinen Wert zuweist oder der Wert fehlt, wird die Nachricht nicht gesendet!

So funktionieren Schaltflächen in Vorlagen

Nachrichtenvorlagen unterstützen Schaltflächen. In MaviBot werden Schaltflächen ähnlich wie in der Syntax der

Facebook-API festgelegt. Sie können sich unter folgendem Link damit vertraut machen:

Die Schaltflächen werden im JSON-Array-Format festgelegt.

Parameter zur Schaltflächenerstellung:

Parameter Erforderlich Beschreibung
type Ja Werte: PHONE_NUMBER, URL und QUICK_REPLY
text Ja Schaltflächentext
url Nein

Die URL, die geöffnet wird,

wenn die Schaltfläche geklickt wird. Sie können Variablen verwenden, um

dynamische Links zu erstellen.
phone_number Nein

Die Telefonnummer, unter der

der Anruf getätigt wird, wenn die Schaltfläche gedrückt wird
example Nein

Bietet ein Beispiel für mögliche Daten für Ihre Vorlage. Dies hilft beim Überprüfungs- und Genehmigungsprozess, damit Sie

verstehen, welche Nachricht Sie senden möchten. Stellen Sie sicher,

dass dies Beispiele sind und keine vertraulichen oder persönlichen Informationen enthalten.

Zum Beispiel: Nachricht mit zwei Schaltflächen: [{"type":"QUICK_REPLY", "text": "Ja, bequem"}, {"type":"QUICK_REPLY", "text": "Unbequem"}]

Schaltflächenfunktionen in Vorlagen

In Vorlagennachrichten sind zwei Arten von Schaltflächen verfügbar:

  1. Call-To-Action (CTA): Eine Schaltfläche für einen Link oder eine Telefonnummer (angezeigt mit einem Link- oder Hörersymbol neben dem Text).
  2. Quick Reply: Standard-Textschaltflächen mit einem Limit von 20 Zeichen.

Einschränkungen:

  • Eine einzelne Vorlage kann bis zu 3 Quick-Reply-Schaltflächen und bis zu 2 Call-to-Action-Schaltflächen enthalten. Sie können jedoch nicht zwei Links oder zwei Telefonnummern gleichzeitig verwenden.
  • Schaltflächen dürfen keine Variablen, Zeilenumbrüche, Emojis oder Formatierungssymbole enthalten.

Verhalten:

  • Durch Klicken auf eine Quick-Reply-Schaltfläche wird deren Text als Antwortnachricht vom Benutzer gesendet.
  • Eine Call-to-Action-Schaltfläche kann einen Link zu einer Datei öffnen.
  • Durch Klicken auf eine Call-to-Action-Schaltfläche für einen Telefonanruf wird der Standard-Wählbildschirm geöffnet. Im WhatsApp Web erscheint eine Benachrichtigung, dass Anrufe nicht über die Desktop-Version getätigt werden können.

Wie funktioniert die Vorlagenmoderation

Jede Vorlage wird unmittelbar nach der Erstellung zur Moderation eingereicht. Der Prozess dauert in der Regel etwa 8 Stunden, mit einer maximalen Überprüfungszeit von 48 Stunden.

Sie können den Moderationsstatus in Ihrer Vorlagenliste verfolgen.

Wenn eine Vorlage abgelehnt wird, wird der Ablehnungsgrund angegeben.

Vorlagen mit hoher Genehmigungswahrscheinlichkeit haben typischerweise:

  • Verwenden Sie eine klare, professionelle Sprache.
  • Dienen Sie einem spezifischen, legitimen Anwendungsfall (z. B. Terminerinnerungen, Bestellupdates).

Wichtig: Text in Kursivschrift kann variabel und angepasst sein.

Hallo, wir konnten Sie nicht erreichen. Wäre es für Sie bequem, hier weiter zu kommunizieren?

Hallo, Sie haben eine Nachricht auf der Website hinterlassen und mich gebeten, Sie zu kontaktieren. (änderbar)

Hallo, ich bin John Smith von MaviBot. Sie haben sich zuvor für die Erstellung eines Chatbots beworben. Wir freuen uns, Ihnen mitteilen zu können, dass wir Neuigkeiten für Sie haben.

Vorlagen, die die Moderation nicht bestehen:

jeglicher Werbetext

So überprüfen Sie, ob Sie sich innerhalb des 24-Stunden-Fensters befinden

Sie können feststellen, wie viele Tage seit der letzten Nachricht des Kunden vergangen sind, indem Sie die Funktion days_from_last_message() in Ihrer Trigger-Bedingung verwenden.

Beispiel für die Überprüfung des 24-Stunden-Fensters:

days_from_last_message() == 0

Einschränkungen für nicht verifizierte Konten

Nicht verifizierte Facebook-Business-Konten unterliegen den folgenden Einschränkungen:

  • 50 Vorlagennachrichten pro Tag (im monatlichen Preis enthalten).
  • Keine Einschränkungen für eingehende Nachrichten.

Um diese Einschränkungen aufzuheben, muss Ihr Unternehmen den Business-Verifizierungsprozess abschließen, der in der Regel 2–3 Wochen dauert.

Zahlungssysteme

Erkundigen Sie sich bei Ihrem Wiederverkäufer nach den Preisen für eingehende und ausgehende Nachrichten für nicht verifizierte Konten.

Die Zahlung erfolgt direkt an 360dialog.

Fehler beim Senden von Nachrichten

Mögliche Gründe für Zustellungsfehler:

  1. Die Telefonnummer des Empfängers ist nicht bei WhatsApp registriert.
  2. Versuch, eine Vorlage aus der Kategorie „Authentifizierung“ an einen WhatsApp-Benutzer mit der Ländervorwahl +91 (Indien) zu senden. Derzeit können Vorlagen der Kategorie Authentifizierung nicht an Benutzer in Indien zugestellt werden.
  3. Der Empfänger hat die aktualisierten Nutzungsbedingungen und Datenschutzrichtlinie nicht akzeptiert.
  4. Die Nachricht wurde nicht zugestellt, um eine qualitativ hochwertige Benutzererfahrung zu gewährleisten (dies ist eine allgemeine Richtlinienblockade).

Click-to-WhatsApp-Anzeigenkonversionen

Eine Ergänzung zur Dokumentation für die Funktion fb_pixel_event().

Meta* markiert jeden Klick von einer Click-to-WhatsApp-Anzeige mit einer ctwa_clid-Klickkennung. Sie wird zusammen mit der ersten WhatsApp-Nachricht des Kunden empfangen und verwendet, um eine Konversion aus der Konversation einer bestimmten Anzeige zuzuordnen – ähnlich wie Pixel-Ereignisse einem Website-Klick zugeordnet werden.

Signatur

fb_pixel_event(
    event_name,
    pixel_id,
    access_token,
    event_source_url,
    action_source,
    fbc,
    test_event_code,
    data,
    ctwa_clid,
    messaging_channel
)

Neue Parameter

Parameter Beschreibung
ctwa_clid Klick-Identifikator für eine Click-to-WhatsApp-Anzeige. Wenn dieser Parameter nicht angegeben wird, wird die Client-Variable ctwa_clid verwendet, die automatisch vom Bot gespeichert wird. Optional.
messaging_channel Der Messaging-Kanal, auf dem die Konversion stattgefunden hat. Standardwert: whatsapp. Optional.

Neuer action_source-Wert

Die folgende Zeile wird zur Tabelle der action_source-Werte hinzugefügt:

Wert Beschreibung
business_messaging Die Konversion erfolgte in einer Konversation, nachdem der Kunde auf eine Click-to-WhatsApp-Anzeige geklickt hat.

Ein Ereignis wird als Messaging-Konversion gesendet, wenn mindestens eine der folgenden Bedingungen erfüllt ist:

  • action_source="business_messaging" wird angegeben;
  • ctwa_clid wird angegeben;
  • messaging_channel wird angegeben.

In diesem Fall erhält Meta* die Kombination action_source + messaging_channel + ctwa_clid. Ohne diese Kombination wird der Anzeigenklick nicht der Konversion zugeordnet.

Der Wert website darf nicht für Messaging-Konversionen verwendet werden: Das Ereignis erreicht zwar den Pixel, wird aber nicht der Anzeige zugeordnet.

Client-Variablen

Wenn ein Kunde nach dem Klick auf eine Anzeige eine WhatsApp-Nachricht sendet, speichert der Bot die Klickdaten in den Client-Variablen des Kunden. Sie müssen diese Variablen nicht manuell ausfüllen.

Variable Beschreibung
ctwa_clid Klick-Identifikator. Wird automatisch zum Ereignis hinzugefügt.
ctwa_clid_time Zeitpunkt, zu dem der Identifikator empfangen wurde, im Unix-Zeitformat. Kann verwendet werden, um zu bestimmen, wie viel Zeit seit dem Klick vergangen ist.
wa_ads_data Anzeigendaten im JSON-Format: Anzeigen-URL, Anzeigen-ID (source_id), Titel, Beschreibung, Kreativtyp und Kreativ-URL.

Der Klick-Identifikator wird automatisch aus der Client-Variable übernommen, sodass Sie ihn nicht explizit an die Funktion übergeben müssen.

Die Telefonnummer des Kunden wird automatisch zum Ereignis hinzugefügt, wenn sie nicht in data angegeben ist.

Der Parameter event_source_url wird nicht für Messaging-Konversionen verwendet.

Einschränkungen

Der Klick-Identifikator wird nur mit der ersten Nachricht des Kunden empfangen, nachdem er auf den Button in der Anzeige geklickt hat. Er ist in nachfolgenden Nachrichten nicht enthalten. Daher kann das Ereignis zu jedem Zeitpunkt während der Konversation gesendet werden, jedoch nur, wenn die erste Nachricht von der Anzeige stammt.

Meta* stellt ctwa_clid für Klicks aus den Facebook*- und Instagram*-Apps auf Android und iOS bereit.

Der Identifikator wird nicht bereitgestellt, wenn der Kunde aus einem Browser klickt oder auf einen regulären Beitrag statt auf den Anzeigen-Button klickt. Konversionen aus solchen Interaktionen können nicht der Anzeige zugeordnet werden.

Wenn der Kunde später auf eine andere Anzeige klickt, werden die Variablen überschrieben. Die Konversion wird der letzten Anzeige zugeordnet, von der der Kunde kam.

whatsapp_send_list()

whatsapp_send_list(text, rows, button, header, footer)

Sendet eine interaktive WhatsApp-Business-API-Listen-Nachricht an den aktuellen Kunden.

Die Nachricht zeigt einen einzelnen Button unter dem Text. Wenn der Kunde auf den Button tippt, öffnet sich eine Liste mit Optionen. Nachdem der Kunde eine Option ausgewählt hat, wird deren Titel (title) als normale Textnachricht an den Bot gesendet.

Die Funktion funktioniert nur für WhatsApp-Business-API-Bots und nur innerhalb des 24-Stunden-Messaging-Fensters.

Parameter

  • text — Nachrichtentext. Erforderlich.
  • rows — Listenoptionen als JSON-String. Es können maximal 10 Optionen enthalten sein. Erforderlich.
  • button — Text des Buttons, der die Liste öffnet. Maximal 20 Zeichen. Standard: Menü.
  • header — Überschrift, die über dem Nachrichtentext angezeigt wird. Maximal 60 Zeichen. Optional.
  • footer — Text, der unter der Nachricht angezeigt wird. Maximal 60 Zeichen. Optional.

rows-Format

Nur Titel:

'["Ja", "Nein"]'

Titel mit Beschreibungen:

'[{"title": "Bestehender Kunde", "description": "Meinen Vertrag besprechen"}, {"title": "Neuer Kunde"}]'

Für jede Option:

  • title — Optionstitel, maximal 24 Zeichen;
  • description — Optionsbeschreibung, maximal 72 Zeichen.

Optionen können auch in mehrere Abschnitte unterteilt werden:

'[{"title": "Support", "rows": [...]}, {"title": "Pläne", "rows": [...]}]'

Jeder Abschnitt muss einen title haben.

Beispiel

ergebnis = whatsapp_send_list(
    "Hallo! Bitte wählen Sie eine Option:",
    '[{"title": "Bestehender Kunde", "description": "Meinen Vertrag besprechen"}, {"title": "Neuer Kunde", "description": "Unsere Dienstleistungen kennenlernen"}]',
    "Optionen"
)

Nach dem Tippen auf den Button „Optionen“ sieht der Kunde die Liste. Wenn er „Bestehender Kunde“ auswählt, wird der Text Bestehender Kunde als Kundennachricht an den Bot gesendet und kann verwendet werden, um den nächsten Schritt im Trichter auszulösen.

Rückgabewert

Wenn die Nachricht erfolgreich gesendet wird, gibt die Funktion die ID der gesendeten Nachricht zurück.

Wenn die Nachricht nicht gesendet werden kann, gibt die Funktion den Fehlertext zurück.

Einschränkungen

  • Die Funktion funktioniert nur für WhatsApp-Business-API-Bots.
  • Die Nachricht kann nur innerhalb des 24-Stunden-Messaging-Fensters gesendet werden.
  • Eine Liste kann nicht mehr als 10 Optionen enthalten.
  • Ein Optionstitel (title) kann nicht mehr als 24 Zeichen enthalten.
  • Eine Optionsbeschreibung (description) kann nicht mehr als 72 Zeichen enthalten.
  • Der button-Text kann nicht mehr als 20 Zeichen enthalten.
  • header und footer können jeweils nicht mehr als 60 Zeichen enthalten.

Wenn der Klick-Identifikator sowohl in den Funktionsparametern als auch in den Client-Variablen fehlt, gibt die Funktion den Fehler No ctwa_clid variable in client variables zurück und das Ereignis wird nicht gesendet.