Das eigene WhatsApp-Angebot von GoHighLevel läuft über die Business API (eine kostenpflichtige Zusatzoption pro Subaccount, darunter die Meta-Gebühren pro Nachricht). Wenn du oder die Kunden, die deine Agentur betreut, auf einer normalen WhatsApp-Nummer arbeiten, ist die Alternative Spun auf dieser Nummer plus die Workflow-Webhooks von GHL, und genau das macht diese Integration zur einfachsten auf dieser Website: GHL-Workflows können Webhooks empfangen und eigene HTTP-Anfragen mit Headern senden, also sitzt kein Zapier dazwischen.
Zwei Abläufe decken die meisten Agentur-Setups ab: von GHL ausgelöste WhatsApp-Nachrichten (Terminerinnerungen, Follow-up-Sequenzen) und WhatsApp-Ereignisse, die Kontakt-Timelines und Pipelines in GHL füttern.
1. WhatsApp aus GHL-Workflows senden
- 1
Spun-API-Schlüssel erstellen
In Spun: „Einstellungen“, dann „Webhooks“, dann „API-Schlüssel verwalten“, dann „Neuer Schlüssel“, beschränkt auf das Senden von Nachrichten (füge die Kontakt-Berechtigungen hinzu, wenn du auch Felder synchronisierst). Kopiere den wap_-Schlüssel, du siehst ihn nur einmal.
- 2
Aktion „Custom Webhook“ hinzufügen
Füge in deinem GHL-Workflow (Termin gebucht, Pipeline-Phase geändert, Formular abgeschickt) die Aktion „Custom Webhook“ hinzu: Methode POST, die send-message-URL von Spun, ein Authorization-Header mit dem Bearer-Schlüssel und ein JSON-Body mit GHL-Merge-Feldern.
- 3
Merge-Felder für Nummer und Text nutzen
Ordne die Telefonnummer des Kontakts dem Feld „to“ zu und schreib die Nachricht mit den Personalisierungs-Tags von GHL. Die Nachricht kommt von deiner echten WhatsApp-Nummer, nicht von einem Absender für Vorlagen.
POST https://api.spun.com/api/integrations/send-message
Authorization: Bearer wap_YOUR_KEY
Content-Type: application/json
{
"to": "{{contact.phone}}",
"text": "Hi {{contact.first_name}}, confirming your appointment on {{appointment.start_time}}. Reply here if you need to reschedule."
}Entferne das Pluszeichen und die Leerzeichen aus dem Telefonformat, falls deine GHL-Nummern welche enthalten; Spun erwartet Ziffern mit Ländervorwahl.
2. WhatsApp-Ereignisse in GHL-Workflows einspeisen
- 1
Eingehenden Webhook-Trigger in GHL anlegen
Starte einen Workflow mit dem Trigger „Inbound Webhook“ und kopiere seine URL.
- 2
Spun darauf ausrichten
In Spun: „Einstellungen“, dann „Webhooks“, dann „Webhook hinzufügen“, füge die GHL-URL ein und wähle Ereignisse: „Eingehende Nachricht“, „Kontakt erstellt“, „Label zugewiesen“ oder „Lead qualifiziert“.
- 3
In GHL zuordnen und handeln
Nutze den Payload des Webhooks (Telefonnummer, Nachrichtentext, Label), um den Kontakt zu finden oder anzulegen, eine Notiz zur Timeline hinzuzufügen, eine Pipeline-Phase weiterzuschieben oder eine Follow-up-Sequenz zu starten.
Setz einen Label-Filter vor die Abläufe, die Pipeline-Einträge erzeugen: Lass Agenten in Spun „Qualifiziert“ vergeben, und nur dieses Ereignis bringt die GHL-Opportunity weiter. Nicht jede Unterhaltung soll zum Deal werden.
Was du vor dem Aufbau wissen solltest (besonders Agenturen)
- Jeder Spun-Arbeitsbereich ist eine Organisation mit eigenen API-Schlüsseln. Eine Agentur, die WhatsApp für mehrere Kunden betreibt, gibt jedem Kunden einen eigenen Spun-Arbeitsbereich mit eigenen Schlüsseln; ein Plan zum Festpreis deckt das ganze Team dieses Kunden ab.
- Das ist keine gelistete App im GHL Marketplace: Der Schlüssel wird in Workflow-Aktionen eingefügt, und Webhook-Abos von Spun legst du in den Einstellungen von Spun an.
- Rate-Limit: 60 API-Anfragen pro Minute und Schlüssel. Für Sequenzen an viele Empfänger auf einmal nimm lieber die Broadcast-Werkzeuge von Spun mit ihrer eingebauten Dosierung, statt die API mit Anfragen zu überschütten.
- Die native WhatsApp-Zusatzoption von GHL bleibt die richtige Wahl, wenn der Kunde offiziell über die API in der Unterhaltungsansicht von GHL senden muss; diese Anleitung ist für Kunden auf ihren bisherigen Nummern.
Siehe auch: WhatsApp + Zapier & Make (Payload-Formate und die gesamte API) · WhatsApp für virtuelle Assistenz und Agenturen