Integrationen

Zapier-Integration

Die Wbiztool-App auf Zapier verbindet Ihre WhatsApp-Nummer mit den anderen Apps, die Sie nutzen. Starten Sie einen Zap, wenn eine WhatsApp-Nachricht eingeht, oder senden Sie eine WhatsApp-Nachricht, wenn in einer anderen App etwas passiert.

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.
Für den Trigger für neue Nachrichten: das Unibox-Add-on in Ihrem Plan. Siehe Voraussetzungen für den Trigger.

Konto verbinden#

Wbiztool zu einem Zap hinzufügen
Erstellen Sie in Zapier einen Zap und suchen Sie als Trigger- oder Action-App nach Wbiztool.
Anmelden
Wenn Zapier Sie auffordert, ein Konto zu verbinden, geben Sie die abgefragten Zugangsdaten ein – Ihren API-Schlüssel und Ihre Client-ID aus Einstellungen → API-Schlüssel.

Der API-Schlüssel bestimmt, welchen Arbeitsbereich Zapier verwendet. Wenn Sie mehreren Arbeitsbereichen angehören, verwenden Sie einen Schlüssel, der in dem Arbeitsbereich erstellt wurde, den Sie verbinden möchten.

Trigger für neue WhatsApp-Nachrichten#

Dieser Trigger startet Ihren Zap jedes Mal, wenn auf Ihrer WhatsApp-Nummer eine Nachricht eingeht. Nutzen Sie ihn, um neue Chats in ein CRM aufzunehmen, Nachrichten in einem Team-Kanal zu posten oder Unterhaltungen in einer Tabelle zu protokollieren.

Voraussetzungen für den Trigger#

Unibox-Add-on. Ohne das Add-on schlägt das Einschalten des Zaps mit Unibox add-on subscription required fehl. Kaufen Sie es unter Abrechnung & Pläne: 20 $/Monat oder 200 $/Jahr pro WhatsApp-Nummer, die in Unibox verwendet wird.
Eine verbundene WhatsApp-Nummer. Der Trigger ist an eine Ihrer verbundenen Nummern gebunden.

Trigger-Daten#

Echte Nachrichten sehen so aus:

{
  "event": "message_received",
  "timestamp": "2026-09-16T10:31:12.482913+00:00",
  "webhook_id": 42,
  "whatsapp_client_id": "678",
  "whatsapp_phone": "919812345678",
  "message": {
    "id": "[email protected]_3EB0C1A2B3D4E5F60718",
    "type": "chat",
    "content": "Hi, is my order #4821 out for delivery?",
    "from": "919876543210",
    "from_name": "Aman",
    "to": "919812345678",
    "timestamp": "2026-09-16T10:29:58+00:00",
    "whatsapp_timestamp": 1789554598,
    "direction": "incoming",
    "status": "pending",
    "is_forwarded": false,
    "forwarding_score": 0
  },
  "contact": {
    "whatsapp_id": "[email protected]",
    "phone": "919876543210",
    "name": "Aman",
    "is_group": false,
    "is_business": false
  },
  "organisation": {
    "id": "5021",
    "name": "Acme Stores"
  }
}

Das Beispiel, das Zapier beim Einrichten des Triggers lädt, hat dieselben Felder message und contact (außer message.forwarding_score), aber kein webhook_id, whatsapp_client_id, whatsapp_phone oder organisation. Diese Felder stehen erst zum Zuordnen zur Verfügung, nachdem eine echte Nachricht eingetroffen ist. Das Beispiel verwendet außerdem Platzhalterwerte: Telefonnummern mit +, whatsapp_timestamp in Millisekunden und status gleich delivered.

Feld	Beschreibung
`event`	`message_received` für eingehende Nachrichten, `message_sent` für Nachrichten, die von Ihrer Nummer gesendet wurden.
`message.type`	`chat` für Text. Mediennachrichten verwenden Typen wie `image`, `video`, `audio`, `ptt` (Sprachnachricht), `document` und `sticker`.
`message.content`	Der Text. Bei Medien eine kurze Bezeichnung wie „📸 Image“.
`message.direction`	`incoming` oder `outgoing`.
`message.from` / `message.to`	`from` ist immer der Kontakt und `to` Ihre Nummer, auch bei ausgehenden Nachrichten. Unterscheiden Sie sie anhand von `message.direction`.
`contact.is_group`	`true`, wenn die Nachricht aus einer Gruppe stammt. Gruppennachrichten enthalten außerdem `group.name`.

In echten Nachrichten haben Telefonnummern kein +, message.whatsapp_timestamp ist in Sekunden angegeben, und message.status ist in der Regel pending. Manche Nachrichten enthalten zusätzliche Felder: message.media (Dateiname, Typ und Größe) bei Medien, message.quoted_message_id bei Antworten und group bei Gruppennachrichten. Weitere Beispiele finden Sie unter Webhook-Listener.

Beispiel: eingehende Nachrichten in Google Sheets protokollieren#

Trigger: Wbiztool, New WhatsApp Message.
Filter by Zapier: nur fortfahren, wenn message.direction exakt incoming entspricht (exactly matches).
Action: Google Sheets, Create Spreadsheet Row. Ordnen Sie contact.phone einer Spalte Phone, contact.name einer Spalte Name und message.content einer Spalte Message zu.

WhatsApp-Nachrichten aus einem Zap senden#

Um eine Nachricht zu senden, fügen Sie Wbiztool als Action hinzu und wählen Sie eine der Actions, die auf der Wbiztool-Seite bei Zapier aufgeführt sind. Ordnen Sie die Telefonnummer des Empfängers und den Nachrichtentext aus vorherigen Schritten zu.

Sie können die API auch direkt mit Webhooks by Zapier aufrufen:

Einstellung	Wert
Action event (Action-Ereignis)	POST
URL	`https://wbiztool.com/api/v1/send_msg/`
Payload type (Payload-Typ)	`json` oder `form`
Data (Daten)	`client_id`, `api_key`, `whatsapp_client`, `country_code`, `phone`, `msg`

Was die einzelnen Felder bedeuten, erfahren Sie unter WhatsApp-Nachrichten aus jedem Automatisierungstool senden; alle Optionen finden Sie unter Nachricht senden.

Fehlerbehebung#

Problem	Was zu prüfen ist
`Invalid API key`	Der Schlüssel wurde gelöscht oder falsch eingegeben. Erstellen Sie unter Einstellungen → API-Schlüssel einen neuen und verbinden Sie das Konto erneut.
`Unibox add-on subscription required`	Kaufen Sie das Unibox-Add-on unter Abrechnung & Pläne und schalten Sie den Zap dann erneut ein.
`No available WhatsApp clients`	Am Trigger wurde keine Nummer eingestellt, und jede verbundene Nummer hat bereits einen Unibox-Listener, oder es ist keine Nummer verbunden. Dazu zählt auch der Listener, den Wbiztool beim ersten Einschalten dieses Zaps erstellt hat: Das Ausschalten eines Zaps löscht ihn nicht, daher kann erneutes Einschalten (zum Beispiel nach dem Bearbeiten des Zaps) fehlschlagen. Löschen Sie unter Unibox-Listener einen Listener, den Sie nicht mehr benötigen, etwa diesen, oder verbinden Sie eine weitere Nummer in den WhatsApp-Einstellungen.
`Invalid WhatsApp client`	Die am Trigger eingestellte Nummer ist gerade nicht verbunden. Verbinden Sie sie in den WhatsApp-Einstellungen erneut.
Der Zap ist eingeschaltet, wird aber nicht ausgelöst	Ihre WhatsApp-Nummer muss verbunden bleiben, damit neue Nachrichten erfasst werden. Prüfen Sie den Listener unter Unibox-Listener.
Zapier zeigt beim Ausschalten des Zaps einen Fehler, etwa `Listener not found` oder einen Serverfehler	Das ist ein bekanntes Problem. Prüfen Sie den Listener unter Unibox-Listener, um zu sehen, ob seine Webhook-URL entfernt wurde.