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

Bei Verwendung der WhatsApp Business API können Benutzer nicht zu jeder Tageszeit Nachrichten an Kunden senden und unbegrenzt viele Nachrichten versenden, 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, bei denen die Kommunikation innerhalb der ausgewählten Kategorie kostenlos ist.

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 die WhatsApp Business API eingerichtet 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 Promotion);

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 Werbung 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 als entwürdigend für die Menschenwürde angesehen werden, bewerben, werden abgelehnt.
  3. Mehrdeutigkeit, Auslassung oder Falschheit: Wenn WhatsApp-Moderatoren versteckte Untertöne, irreführende Informationen oder fehlende klare Details zu Ihrem Unternehmen oder Ihrer Dienstleistung feststellen, wird die Vorlage nicht genehmigt.
  4. Erfassung vertraulicher Informationen: Vorlagen, die darauf ausgelegt sind, sensible Benutzerdaten zu sammeln (z. B. Passnummern, Bankkartendaten, persönliche Identifikationsnummern, Privatadressen), 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-Gesprächsfensters 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 weitere genehmigte Vorlage senden, um den Benutzer erneut zu kontaktieren.
  • 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, 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 Vorlagentypen zur Auswahl.

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

So übergeben Sie Variablen in Vorlagen

Variablen in Vorlagen werden wie im gesamten MaviBot behandelt, nicht im nativen Format von WhatsApp.

Unser System ist an 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: Verwenden Sie für Variablennamen immer nur lateinische 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 aber keinen Wert zuweist oder der Wert fehlt, wird die Nachricht nicht gesendet!

Wie Schaltflächen in Vorlagen funktionieren

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

Facebook-API festgelegt. Sie können sich damit über den Link 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 auf die Schaltfläche geklickt wird. Sie können Variablen verwenden, umdynamische Links zu erstellen.
phone_number Nein Die Telefonnummer, unter derder 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 Sieverstehen, welche Nachricht Sie zu senden planen. Stellen Sie sicher,dass es sich um Beispiele handelt und diese 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 (wird mit einem Link- oder Hörersymbol neben dem Text angezeigt).
  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 gleichzeitig zwei Links oder zwei Telefonnummern verwenden.
  • Schaltflächen können keine Variablen, Zeilenumbrüche, Emojis oder Formatierungssymbole enthalten.

Verhalten:

  • Das Klicken auf eine Quick-Reply-Schaltfläche sendet deren Text als Antwortnachricht vom Benutzer.
  • Eine Call-to-Action-Schaltfläche kann einen Link zu einer Datei öffnen.
  • Das Klicken auf eine Call-to-Action-Schaltfläche für einen Telefonanruf öffnet das Standard-Wählprogramm. Auf WhatsApp Web wird eine Benachrichtigung angezeigt, dass von der Desktop-Version aus keine Anrufe getätigt werden können.

Wie funktioniert die Vorlagenmoderation

Jede Vorlage wird unmittelbar nach der Erstellung zur Moderation eingereicht. Der Vorgang 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 typischerweise aus durch:

  • Verwendung einer klaren, professionellen Sprache.
  • Erfüllung eines spezifischen, legitimen Anwendungsfalls (z. B. Terminerinnerungen, Bestellaktualisierungen).

Wichtig: Text in Kursivschrift kann variabel und anpassbar 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 kürzlich 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 ermitteln, wie viele Tage seit der letzten Nachricht des Kunden vergangen sind, indem Sie die Funktion days_from_last_message() in Ihrer Triggerbedingung 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 durchlaufen, 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 Datenschutzrichtlinien nicht akzeptiert.
  4. Die Nachricht wurde nicht zugestellt, um eine hohe Benutzererfahrung zu gewährleisten (dies ist eine allgemeine Richtlinienblockade).