Übersicht

15. Integrationen

Unter /integrationen lassen sich folgende externe Dienste verbinden:

IntegrationVerbindungsartZweck
GmailOAuth (Google)Mailversand, Follow-ups, KI-Lead-Qualifizierung
Google KalenderOAuth (Google)Terminbuchungen, Google-Meet-Links
ZoomOAuthZoom-Meeting-Links für Buchungsseiten
IMAP/SMTPEigene ZugangsdatenAlternative zu Gmail für Mailversand/-empfang
WhatsApp BusinessNummer + SetupWhatsApp-Chatbot (siehe 13-automationen.md)

OAuth-Flow (Google/Zoom)

  1. „Verbinden" klickt auf /integrationen → Redirect zum jeweiligen OAuth-Anbieter.
  2. Rückkehr über /api/public/oauth/google/callback bzw. /api/public/oauth/zoom/callback — diese Callback-Routen sind ausschließlich für den OAuth-Redirect bestimmt, nicht für eigene Integrationen nutzbar.
  3. Zugangs-/Refresh-Token werden verschlüsselt beim Kunden hinterlegt und automatisch erneuert.

IMAP/SMTP

Alternative für Kunden ohne Gmail: Host, Port, Benutzername, Passwort — Verbindungstest direkt im Dialog. Voraussetzung für KI-Lead-Qualifizierung und KI-Follow-up, wenn kein Gmail verbunden ist.

Nicht enthaltene Integrationen

Es gibt aktuell keine Integrationen für Meta/Facebook Ads, Instagram oder LinkedIn — siehe 16-meta.md, 17-instagram.md, 18-linkedin.md.