· 5 min · TextMeFlow Team

WhatsApp-Benachrichtigungen aus Zoho-CRM-Webhooks senden

Die Workflow-Automatisierung von Zoho CRM kann bei jeder Änderung eines Datensatzes einen ausgehenden Webhook auslösen – ein Lead wechselt zu „Qualified“, ein Deal erreicht „Closed Won“, eine Aufgabe wird überfällig. Die meisten Teams hängen daran eine E-Mail-Benachrichtigung, die ungelesen im Posteingang liegt. Leitest du dasselbe Ereignis stattdessen an WhatsApp, landet es bei dem Vertriebsmitarbeiter, der handeln muss, denn eine WhatsApp-Nachricht wird in Minuten statt in Stunden geöffnet.

Es ist dasselbe Webhook-zu-API-Muster wie bei anderen CRMs: eine Zoho-Workflow-Regel, ein kleiner Empfänger, den du selbst hostest, und die Nachrichten-API von TextMeFlow. Keine Zoho-Marketplace-Erweiterung, die du installieren oder pflegen musst.

Schritt 1: Einen ausgehenden Webhook in Zoho CRM anlegen

Gehe in Zoho CRM zu Setup → Automation → Workflow Rules und lege eine Regel für das gewünschte Modul an (Leads, Deals, Tasks). Lege den Auslöser fest – „When a record is edited“ oder „When a field is updated“ – und füge der Regel dann eine Instant Action → Webhook hinzu. Zoho lässt dich auswählen, welche Felder des Datensatzes im Webhook-Body mitgeschickt werden; wähle die aus, die du später brauchst: Datensatz-ID, E-Mail oder Telefonnummer des Besitzers, das geänderte Feld und seinen neuen Wert.

Zoho-Webhooks unterstützen HTTP Basic Auth standardmäßig nicht. Hänge deshalb ein gemeinsames Geheimnis als Query-Parameter oder Header-Wert an die konfigurierte URL an (https://yourapp.com/zoho-hook?key=...) und prüfe es in deinem Empfänger, bevor du irgendetwas anderes tust – sonst akzeptiert der Endpoint nicht authentifizierte POSTs von jedem, der die URL findet.

Schritt 2: Einen Empfänger bauen, der den Besitzer einer Telefonnummer zuordnet

Zoho sendet die zugeordneten Felder je nach Konfiguration der Webhook-Aktion form-encoded oder als JSON. Ein Node-Empfänger für eine Regel „Lead-Status geändert“ sieht so aus:

import express from 'express';
const app = express();
app.use(express.urlencoded({ extended: true }));

app.post('/zoho-hook', async (req, res) => {
  if (req.query.key !== process.env.ZOHO_WEBHOOK_KEY) {
    return res.sendStatus(401);
  }

  const { lead_status, owner_phone, lead_name } = req.body;
  if (lead_status !== 'Qualified' || !owner_phone) {
    return res.sendStatus(200);
  }

  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: `Der Lead "${lead_name}" wurde gerade auf Qualified gesetzt. Melde dich heute noch bei ihm.`,
    }),
  });

  res.sendStatus(200);
});

Die Workflow-Regel von Zoho feuert bei jedem Speichern, das zum Auslöser passt, deshalb ist die Prüfung lead_status !== 'Qualified' wichtig – ohne sie würdest du bei jeder Bearbeitung eines bereits qualifizierten Leads eine Nachricht senden, nicht nur beim Übergang in diesen Status.

Schritt 3: Telefonnummern vor dem Senden normalisieren

Zoho speichert Telefonfelder als Freitext, so wie der Vertriebsmitarbeiter sie eingetippt hat. Normalisiere auf E.164 und überspringe den Versand lieber, statt zu raten, wenn eine Nummer nicht sauber geparst werden kann:

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}`;
}

Dieselbe Logik gilt, egal ob du den Empfänger in PHP, Python oder Node baust – dem REST-Endpoint von TextMeFlow ist es gleich, welche Sprache ihn aufruft, und Integrationsbeispiele für alle drei findest du in der Dokumentation.

Schritt 4: Blueprint-Übergänge für Phasen mit Freigabe nutzen

Läuft der Phasenwechsel, auf den du achtest, über einen Zoho Blueprint (ein formaler Freigabeprozess statt einer einfachen Feldänderung), lautet der Auslöser der Workflow-Regel „When a Blueprint transition occurs“ statt einer Feldbearbeitung. Das ist wichtig für Fälle wie „Deal nach Freigabe durch den Manager auf Contract Sent gesetzt“ – ein einfacher Feldänderungs-Auslöser würde schon bei der reinen Feldänderung feuern, bevor der Freigabeschritt abgeschlossen ist, und du würdest den Vertriebsmitarbeiter zu früh benachrichtigen.

Den Empfänger idempotent halten

Zoho kann einen Webhook erneut zustellen, wenn dein Endpoint nicht schnell genug antwortet oder einen Nicht-2xx-Status zurückgibt. Dedupliziere über die Datensatz-ID plus den Feldwert, auf den du reagierst (Lead-ID + „Qualified“, Deal-ID + „Closed Won“), damit ein erneuter Versuch nicht dieselbe WhatsApp-Nachricht zweimal an denselben Mitarbeiter schickt. Ein Unique-Constraint auf diesem Paar in der Tabelle, in der du gesendete Benachrichtigungen protokollierst, genügt – eine eigene Deduplizierungslogik ist nicht nötig.

Wofür das gut ist

Gute Einsatzfälle: einen Vertriebsmitarbeiter benachrichtigen, sobald sein Lead qualifiziert wird oder sein Deal abschließt, einen Manager anpingen, wenn ein hochwertiger Deal zu lange in einer Phase hängt, einen Teamleiter informieren, wenn eine Aufgabe als überfällig markiert wird. Schlechter Einsatzfall: den Lead oder Kontakt selbst über dieses Muster ohne vorherige Einwilligung anschreiben – das ist Kundenkommunikation und erfordert eine saubere Einwilligungsverwaltung, keine interne Vertriebsbenachrichtigung. Beschränke dieses Muster auf interne Eins-zu-eins-Benachrichtigungen an dein eigenes Team; so bleibt auch das Volumen niedrig und fern vom Risikowert der Anti-Spam-Pipeline.

Kostenlos mit TextMeFlow starten – 50 Nachrichten im Monat, ohne Zeitlimit, genug, um einen Zoho-CRM-Webhook einzurichten 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