WhatsApp-Nachrichten aus Intercom senden (Webhook-Guide)
Intercom ist für den Browser-Tab gebaut, den du gerade offen hast. Sobald ein Kunde diesen Tab schließt, bleibt deine Antwort ungelesen, bis er sich wieder daran erinnert, oder du hakst per E-Mail nach, die genauso schleppend behandelt wird wie ein Support-Ticket. WhatsApp-Benachrichtigungen schließen diese Lücke: Antwortet ein Agent oder wird eine Konversation gelöst, bekommt der Kunde eine Nachricht, die er innerhalb von Minuten tatsächlich sieht. Eine Intercom-App aus dem Marketplace brauchst du dafür nicht. Ein Webhook-Abonnement und ein kleiner Empfänger, der die Messages-API von TextMeFlow aufruft, genügen.
Schritt 1: Webhook-Abonnement in Intercom anlegen
Gehe in Intercom zu Settings → Developers → Webhooks (oder lege unter Settings → Developers → Developer Hub eine Private App an, falls dein Workspace diesen Weg verlangt) und füge ein neues Webhook-Abonnement hinzu. Du brauchst:
- Eine Ziel-URL: ein kleiner Empfänger, den du selbst hostest, z. B.
https://yourapp.example.com/intercom-hook - Die Topics, die du abonnierst. Zwei sind hier wichtig:
conversation.admin.replied(ein Agent hat geantwortet) undconversation.admin.closed(die Konversation wurde gelöst) - Ein Client Secret, mit dem Intercom jede Zustellung über einen
X-Hub-Signature-Header signiert
Abonniere nur die Topics, mit denen du etwas machst. Intercom bietet Dutzende Konversations-Events (zugewiesen, zurückgestellt, getaggt, Teil von einem Bot hinzugefügt und mehr). Wenn du genau replied und closed wählst, bleibt dein Empfänger einfach, und du löst keine WhatsApp-Nachricht für interne Verwaltungsvorgänge aus.
Schritt 2: Signatur prüfen, bevor du dem Payload vertraust
Jede Intercom-Webhook-Zustellung enthält eine HMAC-SHA1-Signatur des rohen Bodys, berechnet mit deinem Client Secret. Prüfe sie, bevor du irgendetwas aus dem Payload liest. Dieselbe Sorgfalt verlangt TextMeFlow von den eigenen Webhook-Empfängern (siehe Webhook-Signaturen verifizieren):
import crypto from 'crypto';
function verifyIntercomSignature(rawBody, signatureHeader, secret) {
const expected = crypto
.createHmac('sha1', secret)
.update(rawBody)
.digest('hex');
const provided = signatureHeader.replace('sha1=', '');
return crypto.timingSafeEqual(
Buffer.from(expected, 'hex'),
Buffer.from(provided, 'hex')
);
}
Weise alles, was nicht übereinstimmt, mit einem 401 ab, bevor du req.body anfasst. Ein ungeprüfter Payload ist nur ein String, den jemand an deinen Endpunkt gepostet hat.
Schritt 3: Konversation einer Telefonnummer zuordnen
Der Webhook-Payload von Intercom enthält die Konversation und den Kontakt, aber nicht unbedingt eine brauchbare Telefonnummer. Das hängt davon ab, was du im Intercom-Kontakt gespeichert hast. Hat dein Anmeldeprozess oder eine frühere Synchronisierung die Nummer des Kunden bereits in ein benutzerdefiniertes Attribut geschrieben (z. B. phone_whatsapp), liest du sie aus payload.data.item.contacts.contacts[0]. Ist dieses Feld nicht zuverlässig befüllt, hast du zwei Möglichkeiten: den Kontakt über die Intercom-API per id nachschlagen, um sein Standardfeld phone zu holen, oder nicht senden, wenn das Feld fehlt, statt eine Nummer zu raten.
Schritt 4: Webhook empfangen und WhatsApp-Nachricht senden
import express from 'express';
const app = express();
app.use(express.json({ verify: (req, res, buf) => { req.rawBody = buf; } }));
app.post('/intercom-hook', async (req, res) => {
const signature = req.headers['x-hub-signature'];
if (!verifyIntercomSignature(req.rawBody, signature, process.env.INTERCOM_CLIENT_SECRET)) {
return res.sendStatus(401);
}
const topic = req.body.topic;
const conversation = req.body.data?.item;
const phone = conversation?.contacts?.contacts?.[0]?.phone;
if (!phone) return res.sendStatus(200);
const text = topic === 'conversation.admin.closed'
? `Deine Support-Konversation wurde gelöst. Antworte hier, falls du weiterhin Hilfe brauchst.`
: `Du hast eine neue Antwort in deiner Support-Konversation. Schau sie dir an, wenn du Zeit hast.`;
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: phone, text }),
});
res.sendStatus(200);
});
app.listen(3000);
Antworte schnell mit 200 und führe den WhatsApp-Aufruf aus, ohne die Retry-Logik von Intercom darauf warten zu lassen. Intercom wiederholt eine Zustellung, die in ein Timeout läuft, und du willst keine doppelten Nachrichten, nur weil dein Empfänger langsam war und nicht defekt.
Schritt 5: Auf Übergänge beschränken, die Kunden wichtig sind
conversation.admin.replied feuert bei jeder einzelnen Admin-Nachricht, auch bei einem kurzen „Wir schauen uns das jetzt an“, dem in der nächsten Minute drei weitere Nachrichten folgen. Schickt dein Support-Team mehrere kurze Antworten pro Konversation, solltest du Debouncing erwägen: Halte die Benachrichtigung 60 bis 90 Sekunden zurück und sende sie einmal, wenn für diese Konversations-ID kein weiteres Reply-Topic eintrifft, oder benachrichtige nur bei der ersten Antwort nach einer Phase, in der der Kunde nichts geschrieben hat. Eine Nachricht für jeden Tipp-Schub bringt Kunden bei, deine WhatsApp-Nummer zu ignorieren, und das ist das Gegenteil dessen, was du mit dieser Integration aufbauen willst. In den Hinweisen zur Anti-Spam-Pipeline steht, wie sich repetitive Sendungen generell auf die Zustellbarkeit auswirken.
Nur an Nummern mit Einwilligung senden
Intercom-Konversationen hat der Kunde selbst begonnen, was den transaktionalen Fall abdeckt (Antworten und Lösungen zu seinem eigenen offenen Ticket). Das gibt dir keinen Freibrief, diese Nummer für anderes anzuschreiben: Marketing-Nachfassaktionen brauchen weiterhin ein eigenes Opt-in. Halte beide Verwendungen in deinen eigenen Unterlagen getrennt.
Sobald das läuft, funktioniert dasselbe Muster (ein Webhook-Topic abonnieren, die Signatur prüfen, einer Telefonnummer zuordnen, die Messages-API aufrufen) mit jedem Support-Tool, das Event-Webhooks bietet, nicht nur mit Intercom. Bereit, es mit deinem eigenen Account auszuprobieren?
Kostenlos mit TextMeFlow starten: 50 Nachrichten pro Monat, keine Kreditkarte.
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