Einrichtungsanleitung

WhatsApp + Zapier / Make: heute schon verbinden, mit der REST API

Funktioniert heute über HTTP, keine native App nötigZuletzt geprüft: August 2026

Spun hat noch keine veröffentlichte Zapier- oder Make-App, die sich mit einem Klick installieren lässt. Was es hat, ist eine REST API, die genau dafür gebaut ist: WhatsApp-Nachrichten senden, Kontakte erstellen oder aktualisieren, Labels setzen und prüfen, ob eine Nummer WhatsApp hat, dazu ausgehende Webhooks für Echtzeit-Ereignisse. Beides lässt sich direkt in den Schritt „Webhooks by Zapier“ von Zapier oder das HTTP-Modul von Make einbinden, und genauso in den HTTP Request Node von n8n.

Diese Anleitung ist der ehrliche Weg, der heute funktioniert. Wenn du statt eines generischen HTTP-Schritts eine gelistete native App willst, findest du unten verlinkt die Machbarkeitsnotizen dazu, was für deren Veröffentlichung nötig wäre.

1. Erstelle einen API-Schlüssel

  1. 1

    Öffne die API-Schlüssel

    In deinem Spun-Posteingang: „Einstellungen“, dann „Webhooks“, dann „API-Schlüssel verwalten“, dann „Neuer Schlüssel“.

  2. 2

    Benennen und Berechtigungen wählen

    Gib ihm einen Namen wie „Zapier Production“. Aktiviere nur die Berechtigungen (Scopes), die du wirklich brauchst: Nachrichten senden, Kontakte verwalten, Kontakte lesen, Labels verwalten, Labels lesen oder Telefonnummern prüfen.

  3. 3

    Nur einmal kopieren

    Der Schlüssel (beginnt mit wap_) wird nur einmal angezeigt. Bewahre ihn im Zugangsdaten-Speicher deiner Automatisierungsplattform auf, nie in einem Workflow-Schritt oder einem geteilten Dokument.

2. Rufe Spun aus einem Zap, Szenario oder Workflow auf

Jede Aktion geht an dieselbe Basis-URL mit demselben Header. In Zapier nutzt du „Webhooks by Zapier“ > Custom Request, in Make ein HTTP-Modul mit der Einstellung „Make a request“, in n8n einen HTTP Request Node mit Header Auth.

  • check-phone: Prüfe vor dem Senden, ob eine Nummer WhatsApp hat (bis zu 20 Nummern pro Aufruf).
  • create-contact / update-contact: Halte den WhatsApp-Datensatz eines Leads aus jedem Formular oder CRM synchron.
  • apply-label / remove-label: Versieh einen Chat über einen externen Auslöser mit einem Label, zum Beispiel mit „Neuer Lead“, sobald ein Formular abgeschickt wird.
Eine WhatsApp-Nachricht senden (POST /api/integrations/send-message)
POST https://api.spun.com/api/integrations/send-message
Authorization: Bearer wap_YOUR_KEY
Content-Type: application/json

{
  "to": "15551234567",
  "text": "Hello! Thanks for contacting us."
}

Wenn der WhatsApp-Kanal kurz offline ist, meldet send-message trotzdem Erfolg, mit einem Warteschlangen-Flag, statt fehlzuschlagen: Die Nachricht geht automatisch raus, sobald der Kanal wieder verbunden ist.

3. Empfange WhatsApp-Ereignisse in Zapier oder Make

  1. 1

    Erstelle zuerst den Empfangsschritt

    Starte in Zapier einen Zap mit „Webhooks by Zapier“ > Catch Hook und kopiere die URL, die du bekommst. Füge in Make ein Trigger-Modul Custom Webhook hinzu und kopiere dessen URL.

  2. 2

    Füge sie in Spun ein

    „Einstellungen“, dann „Webhooks“, dann „Webhook hinzufügen“. Füge die URL ein und wähle, welche Ereignisse sie auslösen sollen.

  3. 3

    Löse ein Testereignis aus

    Schick dir selbst eine WhatsApp-Nachricht und klicke dann auf „Test trigger“ (Zapier) oder führe das Szenario einmal aus (Make), um die echte Beispiel-Payload zu übernehmen.

Was Spun bei message.inbound sendet
{
  "event_id": "550e8400-e29b-41d4-a716-446655440000",
  "event": "message.inbound",
  "timestamp": "2026-08-18T10:30:00.000Z",
  "org_id": "123",
  "data": {
    "message_id": "[email protected]_ABC123",
    "chat_id": "[email protected]",
    "from": "15551234567",
    "type": "text",
    "text": "Hello!"
  }
}

Verfügbare Ereignisse: eingehende/ausgehende Nachricht, Kontakt erstellt/aktualisiert/gelöscht, Label zugewiesen, Chat-Flow abgeschlossen, Nachricht aus der Warteschlange verarbeitet, Lead qualifiziert, Chat archiviert und Anruf beendet.

Was du wissen solltest, bevor du darauf aufbaust

  • Das ist keine gelistete, durchsuchbare Zapier/Make-App. In Zapier oder Make gibt es heute keinen OAuth-Bildschirm „Connect your Spun account“: Die Authentifizierung ist ein statischer API-Schlüssel, den du selbst in die Header des HTTP-Schritts einfügst.
  • Webhook-Abonnements (die Seite „Ereignisse empfangen“) lassen sich derzeit nur in der Einstellungsoberfläche von Spun selbst anlegen, nicht von Zapier aus, daher ist ein Trigger im REST-Hook-Stil, der sich selbst abonniert, noch nicht verfügbar.
  • Das Ratenlimit liegt bei 60 Anfragen pro Minute pro API-Schlüssel. Bündle Nummernprüfungen (bis zu 20 pro Aufruf), statt sie einzeln in einer Schleife abzuarbeiten, wo immer das geht.

Siehe auch: WhatsApp + Google Sheets (vollständig nativ, kein API-Schlüssel nötig) · WhatsApp + HubSpot CRM

Häufige Fragen

Gibt es eine offizielle Spun-App im Zapier- oder Make-Verzeichnis?

Noch nicht. Die REST API und die ausgehenden Webhooks, die sie nutzen würde, sind bereits live, daher funktionieren dieselben Aktionen und Trigger heute über den generischen HTTP/Webhooks-Schritt in Zapier, Make und n8n.

Was kann ich heute mit der API machen?

Eine WhatsApp-Textnachricht senden, prüfen, ob eine Nummer WhatsApp hat, einen Kontakt erstellen oder aktualisieren und ein Label an einem Chat setzen oder entfernen, dazu Echtzeit-Ereignisse (neue Nachricht, neuer Kontakt, Label gesetzt, Chat-Flow abgeschlossen, Lead qualifiziert, Chat archiviert, Anruf beendet) als ausgehende Webhooks empfangen.

Wie authentifiziere ich mich?

Erstelle einen API-Schlüssel unter „Einstellungen“ > „Webhooks“ > „API-Schlüssel verwalten“, wähle nur die Berechtigungen, die du brauchst, und sende ihn als Bearer-Token im Authorization-Header. Einen OAuth-Ablauf gibt es für diese API heute nicht.

Kann Zapier meine Spun-Ereignisse automatisch abonnieren, wie bei einer nativen REST-Hook-App?

Noch nicht. Du fügst die Catch-Hook-URL von Zapier oder Make im Spun-Bildschirm „Einstellungen“ > „Webhooks“ ein und wählst dort die Ereignisse; Zapier kann dieses Abonnement nicht für dich anlegen.

Wie hoch sind die Ratenlimits?

60 Anfragen pro Minute pro API-Schlüssel. Der Endpoint check-phone nimmt bis zu 20 Nummern in einem Aufruf an, so bleibst du bei Massenprüfungen am einfachsten deutlich unter dem Limit.

Was passiert, wenn ich eine Nachricht sende, während der WhatsApp-Kanal getrennt ist?

Die API meldet trotzdem Erfolg, mit einem Warteschlangen-Flag, statt fehlzuschlagen. Die Nachricht wird automatisch gesendet, sobald der Kanal wieder verbunden ist, du musst für diesen Fall also keine eigene Wiederholungslogik bauen.

Hol dir einen API-Schlüssel und leg los

API-Zugriff gibt es in den WhatsApp-Plänen von Spun, neben dem gemeinsamen Team-Posteingang, KI-Antworten und den nativen Integrationen für Google Sheets und HubSpot. Festpreis ab €45 pro Monat, kostenlose Testversion.

Kostenlos starten

Alle Integrationen ansehen