Webhooks & n8n-Integration
Eingehende Nachrichten in Echtzeit an n8n, Make oder dein CRM weiterleiten. Webhook-Format und Beispiel-Workflows.
Eingehende Webhooks
LeadChat kann jede eingehende Nachricht in Echtzeit an einen Webhook deiner Wahl pushen — typisch an n8n, Make.com oder dein eigenes CRM.
Webhook konfigurieren
Einstellungen → Integrationen → Webhooks → URL hinzufügen
Pflichtfelder:
- URL: dein Endpoint (https)
- Secret: optional, zur Signatur-Verifikation
- Events: `message.received`, `message.sent`, `campaign.completed`
Payload-Format
```json
{
"event": "message.received",
"timestamp": "2026-06-10T11:42:13Z",
"instance": "main-nummer",
"from": "+4915112345678",
"contact": {
"id": "uuid",
"firstname": "Max",
"lastname": "Mustermann",
"company": "Acme GmbH",
"tags": ["b2b", "lead-30"]
},
"message": {
"id": "msg-uuid",
"text": "Ja, gerne nächste Woche",
"media_url": null
}
}
```
Signatur-Verifikation
Wenn du ein Secret gesetzt hast, schickt LeadChat den Header `X-LeadChat-Signature` mit einem HMAC-SHA256 des Bodys.
```js
const expected = crypto
.createHmac('sha256', SECRET)
.update(rawBody)
.digest('hex');
if (signature !== expected) return res.status(401).end();
```
n8n-Beispiel-Workflow
1. Webhook-Node in n8n als Trigger
2. URL kopieren → in LeadChat als Webhook-URL hinterlegen
3. IF-Node: filter auf `event === "message.received"`
4. HubSpot/Pipedrive-Node: Lead anlegen oder Notiz hinzufügen
5. WhatsApp-Antwort-Node (via LeadChat API, siehe unten)
Outbound API (Beta)
Eigene Nachrichten senden:
```http
POST https://api.leadchatapp.de/v1/messages
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"instance": "main-nummer",
"to": "+4915112345678",
"text": "Hallo {firstname}, danke für deine Anfrage!"
}
```
API-Key generieren unter Einstellungen → API → Schlüssel erstellen.
> Beta-Hinweis: Die Outbound-API ist in geschlossener Beta. Anmeldung via [api@leadchatapp.de](mailto:api@leadchatapp.de).