· 5 min · TextMeFlow Team

WhatsApp-Benachrichtigungen aus HubSpot-Deals und -Formularen

HubSpot-Workflows können einen externen Webhook aufrufen, sobald ein Deal die Phase wechselt, ein Formular abgeschickt oder ein Lead einem Vertriebsmitarbeiter zugewiesen wird. Die meisten Teams richten diesen Webhook auf Slack oder E-Mail. Richtest du ihn stattdessen auf WhatsApp, landet die Nachricht bei der einen Person, um die es wirklich geht (dem Vertriebsmitarbeiter, dem Lead oder dem Kunden), in einem Kanal, den sie innerhalb von Minuten ansieht, und nicht erst, wenn sie das nächste Mal ihr Postfach öffnet.

Das ist ein schlichtes Muster von Webhook zu API: keine HubSpot-Marketplace-App, kein zusätzliches Abo, nur eine Workflow-Aktion und ein kleiner Empfänger.

Warum nicht direkt der WhatsApp-Kanal von HubSpot

Die eigene WhatsApp-Integration von HubSpot (über die Inbox) ist für Zwei-Wege-Konversationen mit Kontakten gebaut und an die offizielle WhatsApp Business Platform von Meta mit eigenem Freigabe- und Template-Prozess gebunden. Das ist ein anderes Werkzeug für eine andere Aufgabe. Hier geht es um einseitige, transaktionale Benachrichtigungen wie „Deal in Phase Angebot gesendet verschoben“, „neuer Lead dir zugewiesen“ oder „Formular von X abgeschickt“, gesendet über die Messages-API von TextMeFlow, die überhaupt keine Template-Freigabe durch Meta verlangt. Nutze den nativen Kanal von HubSpot für WhatsApp-Konversationen deiner Mitarbeiter mit Kunden; nutze dieses Muster für interne Alarme und einfache Bestätigungen.

Schritt 1: Webhook-Aktion zu einem HubSpot-Workflow hinzufügen

Öffne in HubSpot Automation → Workflows und bearbeite (oder erstelle) einen Workflow, der auf den gewünschten Auslöser registriert ist: ein Deal, der in eine bestimmte Phase eintritt, eine Formularübermittlung oder eine Änderung einer Kontakteigenschaft. Füge eine Webhook-Aktion hinzu:

  • Methode: POST
  • URL: der Endpunkt deines Empfängers (siehe unten)
  • Request Body: wähle „Custom“ und ordne die benötigten HubSpot-Eigenschaften zu: Dealname, Betrag, Telefonnummer des Eigentümers, Telefonnummer des Kontakts

HubSpot-Workflow-Webhooks feuern nur in den Tarifen Professional und Enterprise; nutze in Starter stattdessen eine Zapier- oder Make-Verbindung zu HubSpot und springe direkt zur TextMeFlow-Aktion in dieser Automatisierung, mit derselben Feldzuordnung.

Schritt 2: Einen kleinen Empfänger bauen

Dein Empfänger nimmt den POST-Body von HubSpot, entscheidet, was die Nachricht sagen soll, und ruft TextMeFlow auf. Eine minimale Node/Express-Version:

import express from 'express';
const app = express();
app.use(express.json());

app.post('/hubspot-deal-hook', async (req, res) => {
  const { dealname, amount, owner_phone } = req.body;

  await fetch('https://api.textmeflow.eu/v1/messages', {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${process.env.TEXTMEFLOW_TOKEN}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      to: owner_phone,
      text: `Deal "${dealname}" (${amount} €) wurde gerade in Angebot gesendet verschoben. Heute nachfassen.`,
    }),
  });

  res.sendStatus(200);
});

Dieselbe Form funktioniert für einen PHP- oder Python-Empfänger: SDKs von TextMeFlow gibt es für beide, und jeder normale HTTP-Client genügt, da es eine Standard-REST-API ist.

Schritt 3: Format der Telefonnummern behandeln

Hier scheitern die meisten Einrichtungen von HubSpot zu WhatsApp unbemerkt. Telefon-Eigenschaften in HubSpot sind Freitext: +32 470 12 34 56, 0470123456 und 32470123456 können je nach Eingebendem alle im selben Feld stehen. Normalisiere vor dem API-Aufruf auf E.164 (nur + und Ziffern, inklusive Ländervorwahl) und weise alles, was sich nicht parsen lässt, ab oder markiere es, statt die Benachrichtigung stillschweigend zu verwerfen:

function toE164(raw, defaultCountry = '32') {
  const digits = raw.replace(/[^\d]/g, '');
  if (raw.startsWith('+')) return '+' + digits;
  if (digits.startsWith('00')) return '+' + digits.slice(2);
  if (digits.startsWith('0')) return `+${defaultCountry}${digits.slice(1)}`;
  return `+${digits}`;
}

Für den Fall des Deal-Eigentümers holst du die Nummer wenn möglich aus dem Profil des HubSpot-Nutzers statt aus einer Freitext-Deal-Eigenschaft: Sie ist deutlich seltener fehlerhaft oder leer.

Schritt 4: Nicht bei jeder Eigenschaftsänderung benachrichtigen

HubSpot-Workflows registrieren sich bei Eigenschaftsänderungen häufiger neu oder feuern erneut, als man erwartet: ein gerundeter Dealbetrag, eine Neuzuweisung des Eigentümers oder ein von einer HubSpot-Integration automatisch befülltes Formularfeld können denselben Webhook auslösen. Füge im Workflow einen Filterzweig hinzu, damit der Webhook nur bei den konkreten Phasenübergängen oder Formularnamen feuert, für die du wirklich eine WhatsApp-Nachricht willst, und mache den Empfänger selbst idempotent (Deduplizierung über hs_object_id + neue Phase), damit ein erneuter Versuch von HubSpot nicht doppelt sendet.

Wofür das gut ist

Gute Einsatzfälle: ein Vertriebsmitarbeiter, der sofort einen Ping bekommt, wenn ein hochwertiger Deal eine späte Phase erreicht, ein Lead, der direkt nach dem Ausfüllen eines Kontaktformulars eine WhatsApp-Bestätigung erhält, ein Account Manager, der benachrichtigt wird, wenn eine Eigenschaft für Verlängerungsrisiko umspringt. Schlecht geeignet: Massenansprache einer HubSpot-Liste. Das ist Marketing-Kommunikation und braucht Einwilligung und Template-Handling, die dieses Muster nicht bietet; führe das über ein richtiges Kampagnen-Tool und nutze dieses Muster für Eins-zu-eins-Benachrichtigungen, die durch Events ausgelöst werden. Das hält dich außerdem vom Anti-Spam-Risiko-Score von TextMeFlow fern.

Kostenlos mit TextMeFlow starten: 50 Nachrichten pro Monat, ohne Zeitlimit, mehr als genug, um einen HubSpot-Workflow anzubinden und zu testen, bevor du dich für einen kostenpflichtigen Tarif entscheidest.

Selbst WhatsApp-Nachrichten per API senden?

Für immer gratis bis 50 Nachrichten/Monat. QR scannen und in 5 Minuten die erste Nachricht senden.

Für immer gratis