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 Messenger 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 die WhatsApp Business API

Bei Verwendung der WhatsApp Business API können Benutzer Clients nicht zu jeder Tageszeit schreiben und beim Erstellen eines Bots unbegrenzt viele Nachrichten senden, ä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 und Vorlagen eine Kategorie zugewiesen wird.

Für die WhatsApp Business API sind von Meta die folgenden Nachrichtenkategorien eingerichtet:

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 (z. B. Passnummern, Bankkartendaten, persönliche ID-Nummern, Wohnadressen) zu sammeln, bestehen die Moderation nicht.
  5. Anstößige Inhalte: 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 & 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 der Öffnung des Chats vergangen sind, können Sie nur eine andere 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 Kanäle, 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, Sie können jedoch 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 Vorlagentypen 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 zu senden planen. 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 ihrem 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 vom Desktop aus keine Anrufe 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 zeichnen sich in der Regel aus durch:

  • Verwendung einer klaren, professionellen Sprache.
  • Erfüllung eines spezifischen, legitimen Anwendungsfalls (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 bestimmen, 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 Monatspreis 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 Zustellfehler:

  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 hohe Benutzererfahrung aufrechtzuerhalten (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. Standardmäßig 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 aus 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 die Schaltfläche 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 die Anzeigenschaltfläche 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 neuesten Anzeige zugeordnet, von der der Kunde stammt.

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.