WhatsApp-Benachrichtigungen aus Pipedrive-Webhooks
Pipedrive kann in dem Moment einen Webhook auslösen, in dem ein Deal die Phase wechselt, ein neuer Deal angelegt wird oder eine Aktivität als erledigt markiert wird. Die meisten Vertriebsteams leiten das in einen Slack-Kanal, den zwischen zwei Meetings niemand ansieht. Dasselbe Ereignis an WhatsApp zu schicken, bringt es zu dem Vertriebsmitarbeiter, der handeln muss – eine Nachricht wie „Deal gewonnen, Vertrag senden" oder „Demo-Call in 30 Minuten", die innerhalb weniger Minuten tatsächlich gelesen wird.
Das ist ein Webhook-zu-API-Muster: die eingebauten Webhooks von Pipedrive, ein kleiner Empfänger, den du selbst hostest, und die Nachrichten-API von TextMeFlow. Keine Marketplace-App, kein OAuth-Ablauf, den du pflegen musst.
Schritt 1: Den Webhook in Pipedrive erstellen
Pipedrive-Webhooks richtest du unter Settings → Tools and apps → Webhooks ein (bei manchen Tarifen findet sich das stattdessen in einer Marketplace-App „Webhooks"). Erstelle einen neuen Webhook mit:
- Ereignis: Wähle das Objekt und die Aktion, die du willst –
deal.updated,deal.addedoderactivity.updatedsind die üblichen für Benachrichtigungen - Endpunkt-URL: dein Empfänger (siehe unten)
- HTTP Auth: Setze einen Benutzernamen und ein Passwort, wenn sich Pipedrive bei deinem Empfänger authentifizieren soll – tu das unbedingt, denn sonst akzeptiert der Endpunkt unauthentifizierte POSTs von jedem, der die URL findet
Pipedrive sendet das vollständige Objekt plus einen previous-Snapshot des Objekts vor der Änderung, wodurch sich Phasenwechsel ohne zweiten API-Aufruf erkennen lassen.
Schritt 2: Einen Empfänger bauen, der prüft, was sich wirklich geändert hat
Ein deal.updated-Webhook wird bei jeder Feldänderung ausgelöst, nicht nur bei Phasenwechseln – eine hinzugefügte Notiz, eine geänderte Summe oder eine neu zugewiesene Eigentümerschaft lösen alle dasselbe Ereignis aus. Vergleiche current.stage_id mit previous.stage_id, bevor du entscheidest, etwas zu senden:
import express from 'express';
const app = express();
app.use(express.json());
app.post('/pipedrive-deal-hook', async (req, res) => {
const { current, previous } = req.body;
if (current.stage_id === previous?.stage_id) {
return res.sendStatus(200); // not a stage change, ignore
}
const ownerPhone = current.owner_id?.phone;
if (!ownerPhone) 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: ownerPhone,
text: `Deal "${current.title}" ist in Phase ${current.stage_id} gewechselt. Wert: ${current.currency} ${current.value}.`,
}),
});
res.sendStatus(200);
});
Dieselbe Logik funktioniert in PHP oder Python – TextMeFlow bietet SDKs für beide, oder du rufst den REST-Endpunkt direkt mit einem beliebigen HTTP-Client auf.
Schritt 3: Phasen-IDs und Telefonnummern sauber auflösen
Die Webhook-Payload von Pipedrive liefert dir stage_id, nicht den Phasennamen – hole die Phasenliste der Pipeline einmal ab (GET /v1/stages in der Pipedrive-API) und cache die Zuordnung von ID zu Name, statt sie fest zu codieren, denn Phasennamen und ihre Reihenfolge ändern sich, wenn sich der Vertriebsprozess weiterentwickelt. Die Telefonnummer einer Person oder eines Eigentümers speichert Pipedrive als Freitext; normalisiere sie vor dem Senden nach E.164 und überspringe den Versand (nicht raten), wenn das Feld sich nicht parsen lässt:
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}`;
}
Schritt 4: Aktivitäts-Webhooks für Erinnerungen nutzen, nicht nur Deal-Webhooks
Für Hinweise im Stil von „Ruf den Kunden in 30 Minuten an" abonnierst du activity.added oder activity.updated statt der Deal-Ereignisse und prüfst in deinem Empfänger due_date / due_time gegen die aktuelle Uhrzeit, bevor du sendest – Pipedrive löst den Webhook aus, wenn sich der Aktivitätsdatensatz ändert, nicht wenn die Aktivität tatsächlich fällig ist. Ein einfacher Ansatz: Plane bei activity.added einen verzögerten Job (eine Queue, eine Cron-Prüfung oder ein scheduled_at-Feld, das ein periodischer Worker ausliest), der die WhatsApp-Nachricht zu due_date/due_time abzüglich deiner Vorlaufzeit sendet, und breche ihn ab, wenn die Aktivität vorher als erledigt markiert oder gelöscht wird.
Den Empfänger idempotent halten
Pipedrive kann einen Webhook nach einem Timeout oder einem 5xx deines Endpunkts erneut zustellen. Dedupliziere anhand der Objekt-ID plus des Felds, auf das du reagierst (Deal-ID + neue Phasen-ID oder Aktivitäts-ID + Fälligkeitszeitpunkt), damit ein erneuter Versuch nicht dieselbe WhatsApp-Nachricht zweimal an denselben Vertriebsmitarbeiter sendet.
Wofür das gut ist
Gute Einsatzfälle: einen Vertriebsmitarbeiter benachrichtigen, sobald sein Deal „Contract Sent" oder „Won" erreicht, ihn an einen bald fälligen Anruf erinnern, eine Führungskraft anpingen, wenn ein hochwertiger Deal zu lange in einer Phase hängt. Schlechter Einsatzfall: über dieses Muster WhatsApp-Nachrichten an die Kontakte oder Leads selbst ohne deren vorherige Einwilligung senden – das ist Kundenkommunikation, keine interne Vertriebsbenachrichtigung, und erfordert eine saubere Handhabung der Einwilligung. Nutze dieses Muster für interne Eins-zu-eins-Benachrichtigungen an dein eigenes Team; das hält auch das Volumen niedrig und außerhalb des Anti-Spam-Risikoscores.
Kostenlos mit TextMeFlow starten – 50 Nachrichten pro Monat, ohne Zeitlimit, genug, um einen Pipedrive-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