WordPress-Integration

Business Messaging for WbizTool ist das offizielle WordPress-Plugin. Es sendet WhatsApp-Nachrichten von Ihrer verbundenen Nummer, wenn auf Ihrer Website etwas passiert: Eine WooCommerce-Bestellung ändert sich, eine WP-Amelia-Buchung wird verschoben oder storniert, oder ein Contact-Form-7-Formular wird abgeschickt.

Bevor Sie beginnen#

• Ein Wbiztool-Konto mit einer verbundenen WhatsApp-Nummer in den WhatsApp-Einstellungen.
• Ihre Client-ID und Ihr API-Schlüssel aus Einstellungen → API-Schlüssel.
• Die WhatsApp-Client-ID der Absendernummer, angezeigt in den WhatsApp-Einstellungen.

Plugin installieren#

1. Aus WordPress installieren

   Gehen Sie in Ihrem WordPress-Admin zu Plugins → Add New (in der deutschen Oberfläche: Plugins → Plugin hinzufügen), suchen Sie nach Business Messaging for WbizTool, klicken Sie auf Install Now (Jetzt installieren) und dann auf Activate (Aktivieren). Sie können das Plugin auch aus dem WordPress-Plugin-Verzeichnis herunterladen und die ZIP-Datei unter Plugins → Add New → Upload Plugin (Plugin hochladen) hochladen. Schlägt der Upload fehl (zum Beispiel wegen einer Dateigrößenbeschränkung), entpacken Sie die ZIP-Datei und kopieren Sie den Ordner business-messaging-for-wbiztool per FTP nach /wp-content/plugins/. Aktivieren Sie das Plugin anschließend unter Plugins.

2. Plugin-Einstellungen öffnen

   In der Admin-Seitenleiste erscheint ein neues Menü WbizTool mit vier Seiten: Settings (Einstellungen), Templates (Vorlagen), Test Messages (Testnachrichten) und Logs (Protokolle).

Plugin einrichten#

1. API-Zugangsdaten eingeben

   Füllen Sie unter WbizTool → Settings im Bereich API Configuration (API-Konfiguration) die Felder Client ID, API Key und WhatsApp Client ID aus und klicken Sie dann auf Test Connection (Verbindung testen).

   Mit korrekten Zugangsdaten stellt Test Connection eine echte Testnachricht an die Platzhalternummer 10000000000 in die Warteschlange, sodass sie in Ihrem Wbiztool-Nachrichtenverlauf erscheint. Sie kann nicht zugestellt werden und wird dort als fehlgeschlagen angezeigt; Sie können sie ignorieren. Wenn Sie Unable to connect to WbizTool API. Please check your internet connection. sehen, sind höchstwahrscheinlich Ihre Client-ID, Ihr API-Schlüssel oder Ihre WhatsApp-Client-ID falsch, oder Ihr Plan hat keine Nachrichten mehr übrig. Ein Problem mit Ihrer Internetverbindung ist selten die Ursache.

2. Allgemeine Optionen festlegen

   Unter General Settings (Allgemeine Einstellungen):

   • Default Country Code (Standard-Ländervorwahl): wird verwendet, wenn dem Rechnungsland einer WooCommerce-Bestellung keine Vorwahl zugeordnet werden kann. Der Standardwert ist 1; ändern Sie ihn in Ihr Hauptland, zum Beispiel 91.
   • Test Mode (Testmodus): Wenn eingeschaltet, werden Nachrichten ins Protokoll geschrieben, aber nicht gesendet.
   • Admin Notifications (Admin-Benachrichtigungen): Dieses Kontrollkästchen hat in Version 1.0.3 keine sichtbare Wirkung, weil die Einstellungsseite kein Feld für die Admin-Telefonnummer hat, die es verwendet. Für Admin-Benachrichtigungen bei Formulareinsendungen verwenden Sie die Contact-Form-7-Einstellungen weiter unten.

3. Integrationen und Ereignisse aktivieren

   Aktivieren Sie unter Integration Settings (Integrationseinstellungen) jedes Plugin, das Sie nutzen, und haken Sie die Ereignisse an, die eine Nachricht senden sollen. Eine Integration zeigt ihre Optionen nur an, wenn das entsprechende Plugin auf Ihrer Website aktiv ist. Klicken Sie auf Save Settings (Einstellungen speichern).

4. Nachrichtenvorlagen bearbeiten

   Wählen Sie unter WbizTool → Templates den Tab WooCommerce, Amelia oder Contact Form 7, wählen Sie ein Ereignis und bearbeiten Sie dessen Text. Die Seite listet die verfügbaren Variablen auf und zeigt eine Live-Vorschau. Reset (Zurücksetzen) stellt den Standardtext wieder her.

5. Test senden

   Senden Sie unter WbizTool → Test Messages eine Nachricht an Ihre eigene Nummer, um zu prüfen, ob alles funktioniert, und sehen Sie dann unter WbizTool → Logs nach.

WooCommerce#

Nachrichten gehen an die Rechnungs-Telefonnummer (billing phone) der Bestellung. Die Ländervorwahl ergibt sich aus dem Rechnungsland; wird dieses Land nicht erkannt, wird der Default Country Code verwendet.

Vorlagenvariablen:

Beispielvorlage:

Hi {customer_first_name},

Thank you for your order #{order_number}.
Total: {order_total}

Track your order: {order_url}

{store_name}

WP Amelia#

Nachrichten gehen an die Kunden-Telefonnummer der Buchung. Die Einstellungsseite listet sechs Ereignisse auf:

• Booking Added (Frontend bookings) – Buchung hinzugefügt (Frontend-Buchungen)
• Booking Rescheduled – Buchung verschoben
• Booking Cancelled – Buchung storniert
• Appointment Added (Backend) – Termin hinzugefügt (Backend)
• Event Booking Saved – Event-Buchung gespeichert
• Event Booking Updated – Event-Buchung aktualisiert

In Amelia-Vorlagen verfügbare Variablen:

Contact Form 7#

Wenn ein Formular abgeschickt wird, kann das Plugin Ihnen (dem Admin), der Person, die das Formular ausgefüllt hat, oder beiden eine Nachricht senden.

Das Plugin findet Name, E-Mail, Telefonnummer und Nachricht in Ihrem Formular anhand des Feldnamens. Verwenden Sie gängige Namen wie your-name, your-email, your-phone (oder phone, mobile, whatsapp), your-subject und your-message. Die automatische Antwort an Kunden wird nur gesendet, wenn ein Telefonfeld gefunden wird. Fragen Sie die Nummer mit Ländervorwahl ab: Das Plugin erkennt nur einige Ländervorwahlen und verwendet andernfalls den Default Country Code.

Vorlagenvariablen:

Jedes Formularfeld ist außerdem unter seinem eigenen Namen verfügbar, wobei Bindestriche durch Unterstriche ersetzt werden. Ein Feld namens your-city ist zum Beispiel {your_city}.

Beispiel für eine Admin-Benachrichtigung:

New enquiry from {contact_name} ({contact_phone}) on {form_title}:
{message}

Zeilenumbrüche in der Nachricht des Besuchers werden entfernt, daher kommt {message} als eine Zeile an.

Protokolle#

WbizTool → Logs listet die Nachrichten auf, die das Plugin zu senden versucht hat, mit Datum, Ereignistyp, Integration, Telefonnummer, Nachricht und Status. Prüfen Sie dort, ob ein Ereignis ausgelöst wurde und ob die Nachricht gesendet wurde. Warum eine Nachricht fehlgeschlagen ist, zeigt es nicht.

Fehlerbehebung#

Um PHP-Fehler des Plugins zu sehen, aktivieren Sie das Debug-Logging von WordPress in wp-config.php. Fehler werden in wp-content/debug.log geschrieben. Schalten Sie es wieder aus, wenn Sie fertig sind.

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);