> ## Documentation Index
> Fetch the complete documentation index at: https://docs.northline-echo.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrationen & Automatisierung

> API, Webhooks, CSV-Export, Trigger, Benachrichtigungen

## Integrationen & Automatisierung

Leads können per **API** und **Webhooks** an CRM, ERP oder eigene Dienste angebunden werden. Zusätzlich: Trigger bei neuem Lead, Benachrichtigungen, optionale Eskalationslogik.

***

# API & Export

* **REST-API** – Leads (und ggf. Jobs) abrufen, filtern, in eigenes CRM integrieren. Authentifizierung (API-Key/OAuth), rollenbasierte Berechtigung. Details [API-Dokumentation](/api-guide/overview).
* **CSV-Export** – Aus Lead-Inbox oder Admin Leads exportieren; Filter nach Zeitraum, Status, Quelle, Assistent. Exporte personenbezogen – sicher aufbewahren, nach Nutzung löschen/anonymisieren (DSGVO).
* **Synchronisierung** – Typisch: Northline Echo als Quelle; CRM erhält neue Leads und Status-Updates (API-Polling oder Webhooks). Bei Zweiweg-Sync Duplikate und IDs beachten; AV-Verträge bei Weitergabe.

<Warning>
  API-Keys nur serverseitig oder in sicheren Konfigurationen verwenden; keine Geheimnisse im Frontend oder in öffentlichen Repositories.
</Warning>

***

# Webhooks & Trigger

* **Neuer Lead** – Webhook bei Erfassung (Voice/Chat); Payload z. B. Lead-ID, Felder, Zeitstempel. Konfigurierte URL (eigener Service, Zapier, Make, CRM) wird aufgerufen.
* **Weiterleitung** – Bei neuem Lead API-Aufruf oder Webhook an CRM (Kontakt/Ticket); über Zwischenservice E-Mail/Slack. Nur nötige Felder weiterleiten; Empfänger unter DSGVO berücksichtigen.
* **Benachrichtigungen** – E-Mail bei neuem Lead (wenn angeboten); In-App-Hinweise (z. B. Badge „Neue Leads“); adressierbar an Rollen (z. B. OWNER, Vertrieb).
* **Eskalation** – Bei Verfügbarkeit: Regeln auf Status/Zeitstempel/urgency\_score; z. B. „Lead nicht innerhalb von X Stunden kontaktiert“ → Benachrichtigung, Zuweisung oder Ticket in externem System.

*More coming soon.*