Corcava logoDas einzige Business-Tool, das Sie brauchenCorcava
Menü

E-Mail-Integration & Konnektivität

Gmail-Integration

OAuth-Verbindung und -Einrichtung

Corcava bietet nahtlose Gmail-Integration über Google-OAuth-Authentifizierung:

Gmail-Verbindungsprozess:

  1. OAuth-Autorisierung: Verbindung über den Google-OAuth-Flow initiieren
  2. Berechtigungsvergabe: Notwendige Berechtigungen für E-Mail-Zugriff und -Versand erteilen
  3. Token-Verwaltung: Sichere Speicherung von Access- und Refresh-Tokens
  4. Konto-Verifizierung: E-Mail-Konto-Inhaberschaft und Gültigkeit verifizieren
  5. Integrations-Bestätigung: Bestätigung der erfolgreichen Gmail-Verbindung

OAuth-Konfiguration:

  • Access Type: Offline-Zugriff für durchgängige E-Mail-Funktionalität
  • Kontoauswahl: Aufforderung zur Kontoauswahl während der Authentifizierung
  • Consent-Flow: Vollständiger Consent-Flow mit korrekter Berechtigungsvergabe
  • State-Management: Sichere State-Parameter-Behandlung für Callback-Validierung

Erforderliche Berechtigungen:

  • Gmail Compose: Berechtigung zum Verfassen und Erstellen von E-Mail-Nachrichten
  • Gmail Send: Berechtigung zum Senden von E-Mails über das verbundene Gmail-Konto
  • Gmail Read Only: Berechtigung zum Lesen eingehender E-Mails für die Synchronisation
  • Calendar Events: Berechtigung zur Verwaltung von Kalender-Terminen (für Meeting-Integration)
  • Calendar Read Only: Berechtigung zum Lesen von Kalenderinformationen

Gmail-API-Funktionalität

Die Gmail-Integration nutzt die Google Gmail API für umfassendes E-Mail-Management:

E-Mail-Versand-Funktionen:

  • Nachrichtenerstellung: Korrekt formatierte Gmail-Nachrichten mit HTML-Inhalt erstellen
  • Betreff-Kodierung: UTF-8-Base64-Kodierung für internationale Betreffzeilen
  • MIME-Formatierung: Korrekte MIME-Version- und Content-Type-Header für E-Mail-Kompatibilität
  • Nachrichtenübertragung: E-Mails über die Gmail-API mit korrekter Authentifizierung senden

Nachrichtenformatierung:

  • HTML-Inhalt-Unterstützung: Vollständiger HTML-E-Mail-Inhalt mit Rich-Formatierung
  • Zeichenkodierung: UTF-8-Kodierung für internationale Zeichen
  • E-Mail-Header: Korrekte From-, To-, Subject- und MIME-Header
  • Content-Transfer-Encoding: Quoted-printable-Kodierung für zuverlässige Zustellung

Token-Verwaltung:

  • Access-Token-Validierung: Automatische Validierung des Access-Token-Ablaufs
  • Refresh-Token-Behandlung: Automatische Token-Aktualisierung bei abgelaufenen Access-Tokens
  • Token-Updates: Nahtlose Token-Updates ohne Benutzereingriff
  • Fehlerbehandlung: Umfassende Fehlerbehandlung für abgelaufene oder ungültige Tokens

Gmail-Konto-Verwaltung

Gmail-Konten werden effizient innerhalb von Team-Strukturen verwaltet:

Konto-Organisation:

  • Teambasierte Verwaltung: Gmail-Konten sind nach Team für korrekte Zugriffskontrolle organisiert
  • Benutzerzuordnung: Jedes Gmail-Konto ist einem bestimmten Benutzer zugeordnet
  • Mehrere Konten: Benutzer können mehrere Gmail-Konten verbinden
  • Provider-Identifikation: Klare Identifikation von Google als E-Mail-Provider

Konto-Speicherung:

  • Sichere Token-Speicherung: Access- und Refresh-Tokens sicher gespeichert
  • E-Mail-Adressen-Aufzeichnung: Verbundene Gmail-Adressen zur Identifikation gespeichert
  • Konto-Status-Verfolgung: Verbindungsstatus und Gültigkeit der Konten überwachen
  • Fehlerzustands-Verwaltung: Token-Ablauf und Fehlerzustände verfolgen und verwalten

Microsoft/Outlook-Integration

Microsoft Graph API-Verbindung

Corcava unterstützt Microsoft 365 und Outlook über die Microsoft Graph API:

Microsoft-Verbindungsprozess:

  1. OAuth-Redirect: Weiterleitung zum Microsoft-OAuth-Autorisierungs-Endpunkt
  2. Scope-Autorisierung: Erforderliche Berechtigungen für E-Mail- und Kalenderzugriff anfordern
  3. Kontoauswahl: Aufforderung zur Microsoft-Kontoauswahl
  4. Token-Austausch: Autorisierungscode gegen Access- und Refresh-Tokens eintauschen
  5. Konto-Erstellung: UserMailbox-Datensatz mit Microsoft-Anmeldedaten erstellen

Microsoft-OAuth-Konfiguration:

  • Provider-Auswahl: Microsoft-Provider-Identifikation und -Konfiguration
  • Konto-Aufforderung: Kontoauswahl-Aufforderung für Mehrkonto-Szenarien
  • Response Type: Authorization-Code-Flow für sicheren Token-Austausch
  • Offline Access: Offline-Zugriff für durchgängige Funktionalität

Erforderliche Microsoft-Scopes:

  • Offline Access: Berechtigung für Offline-Token-Refresh
  • User.Read: Berechtigung zum Lesen grundlegender Benutzerprofilinformationen
  • Mail.Read: Berechtigung zum Lesen von E-Mails aus dem verbundenen Microsoft-Konto
  • Mail.Send: Berechtigung zum Senden von E-Mails über die Microsoft Graph API
  • Calendars.ReadWrite: Berechtigung zur Verwaltung von Kalender-Terminen und Meetings

Microsoft-Konto-Verwaltung

Microsoft-Konten sind nahtlos in die Plattform integriert:

Konto-Integration:

  • Zustandslose Authentifizierung: Zustandsloser OAuth-Flow für sichere Authentifizierung
  • Benutzerinformationen-Extraktion: E-Mail- und Benutzerinformationen aus Microsoft-Antwort extrahieren
  • Konto-Speicherung: Access-Tokens, Refresh-Tokens und E-Mail-Adressen speichern
  • Team-Zuordnung: Microsoft-Konten den passenden Teams und Benutzern zuordnen

Microsoft-Provider-Unterstützung:

  • Provider-Identifikation: Klare Identifikation von Microsoft als E-Mail-Provider
  • Konto-Anzeige: Korrekte Anzeigenamen und Identifikation für Microsoft-Konten
  • Token-Verwaltung: Sichere Speicherung und Verwaltung der Microsoft-Authentifizierungs-Tokens
  • Fehlerbehandlung: Umfassende Fehlerprotokollierung und -behandlung für Microsoft-Authentifizierung

E-Mail-Konto-Verwaltung

Mehrere verbundene Konten verwalten

Corcava unterstützt mehrere E-Mail-Konto-Verbindungen pro Benutzer und Team:

Mehrkonto-Unterstützung:

  • Provider-Vielfalt: Unterstützung für Google- und Microsoft-E-Mail-Provider
  • Team-Organisation: E-Mail-Konten nach Team mit korrekter Zugriffskontrolle organisiert
  • Benutzerzuordnung: Jedes E-Mail-Konto bestimmten Benutzern zugeordnet
  • Konto-Identifikation: Klare Identifikation von Konto-Providern und E-Mail-Adressen

Konto-Verwaltungsfunktionen:

  • Konto-Erstellung: Einfache Erstellung neuer E-Mail-Konto-Verbindungen
  • Konto-Updates: Bestehende Konto-Anmeldedaten und Tokens aktualisieren
  • Konto-Refresh: Abgelaufene Tokens für weitere Funktionalität aktualisieren
  • Konto-Anzeige: Benutzerfreundliche Anzeige verbundener E-Mail-Konten

Provider-Verwaltung:

  • Google-Integration: Vollständige Google-/Gmail-Konto-Verwaltung
  • Microsoft-Integration: Vollständige Microsoft-/Outlook-Konto-Verwaltung
  • Provider-Auswahl: Einfache Auswahl zwischen unterstützten E-Mail-Providern
  • Einheitliche Oberfläche: Konsistente Oberfläche unabhängig vom E-Mail-Provider

E-Mail-Konto-Speicherung und -Sicherheit

E-Mail-Konten werden mit umfassenden Sicherheitsmaßnahmen sicher gespeichert:

Sichere Speicherung:

  • Token-Verschlüsselung: Sichere Speicherung von Access- und Refresh-Tokens
  • Team-Isolation: E-Mail-Konten aus Sicherheitsgründen nach Team getrennt
  • Benutzerzuordnung: Konten korrekt autorisierten Benutzern zugeordnet
  • Provider-Verfolgung: Klare Verfolgung des E-Mail-Providers pro Konto

Konto-Validierung:

  • Token-Validierung: Regelmäßige Validierung gespeicherter Authentifizierungs-Tokens
  • Ablauf-Verwaltung: Automatische Behandlung des Token-Ablaufs
  • Fehlerzustands-Verfolgung: Fehlerzustände von Konten verfolgen und verwalten
  • Verbindungsstatus: Verbindungsstatus aller E-Mail-Konten überwachen

E-Mail-Versand

Versand über verbundene Konten

Verbundene E-Mail-Konten ermöglichen direkten E-Mail-Versand über externe Provider:

Gmail-Versand:

  • API-Integration: E-Mails direkt über die Gmail-API senden
  • Authentifizierung: Gespeicherte Access-Tokens für authentifizierten Versand nutzen
  • Nachrichtenformatierung: Korrekte Nachrichtenformatierung für Gmail-Kompatibilität
  • Zustellungs-Bestätigung: Bestätigung der erfolgreichen E-Mail-Zustellung

Versandprozess:

  • Kontoauswahl: Aus verfügbaren verbundenen E-Mail-Konten wählen
  • Nachrichten-Vorbereitung: Nachrichten mit korrekter Formatierung und Headern vorbereiten
  • Authentifizierung: Mit gespeicherten Konto-Anmeldedaten authentifizieren
  • Versand-Verfolgung: E-Mail-Versandstatus und -ergebnisse verfolgen

E-Mail-Verfassen:

  • HTML-Inhalt: Unterstützung für Rich-HTML-E-Mail-Inhalt
  • Betreff-Behandlung: Korrekte Betreffzeilen-Kodierung und -Formatierung
  • Empfängerverwaltung: Einzel- und Mehrfach-Empfänger handhaben
  • Fehlerbehandlung: Umfassende Fehlerbehandlung bei Versandfehlern

Ausgehende E-Mail-Verwaltung

Ausgehende E-Mails werden umfassend verfolgt und verwaltet:

E-Mail-Statusverfolgung:

  • Status-Zustände: E-Mail-Status verfolgen (gesendet, fehlgeschlagen, Warteschlange, Entwurf)
  • Zustellungs-Bestätigung: Erfolgreiche E-Mail-Zustellung erfassen
  • Fehlerprotokollierung: E-Mail-Versandfehler protokollieren und verfolgen
  • Status-Updates: Echtzeit-Status-Updates für ausgehende E-Mails

Ausgehende E-Mail-Funktionen:

  • UserMailbox-Zuordnung: Ausgehende E-Mails mit bestimmten verbundenen Konten verknüpfen
  • Empfänger-Verfolgung: E-Mail-Empfänger und Zustelladressen verfolgen
  • Betreff-Aufzeichnung: E-Mail-Betreffe zur Referenz und Verfolgung erfassen
  • Inhaltsverwaltung: E-Mail-Inhalt und Formatierung verwalten

E-Mail-Synchronisation

Verarbeitung eingehender E-Mails

Corcava verarbeitet automatisch eingehende E-Mails aus verbundenen Konten:

Automatischer E-Mail-Abruf:

  • Geplante Verarbeitung: Regelmäßiger Abruf eingehender E-Mails aus verbundenen Konten
  • Kontakt-Zuordnung: Eingehende E-Mails bestehenden Kontakten im System zuordnen
  • Duplikatvermeidung: Doppelte E-Mail-Verarbeitung und -Speicherung verhindern
  • Nachrichten-Extraktion: E-Mail-Betreff, Inhalt und Metadaten extrahieren

E-Mail-Verarbeitungs-Workflow:

  1. Konto-Scan: Verbundene Gmail-Konten auf neue Nachrichten scannen
  2. Kontakt-Identifikation: E-Mails von bekannten Kontakten identifizieren
  3. Duplikat-Prüfung: Auf bestehende E-Mails prüfen, um Duplikate zu vermeiden
  4. Aktivitäts-Erstellung: Kontakt-Aktivitätsdatensätze für neue E-Mails erstellen
  5. E-Mail-Speicherung: Eingehende E-Mail-Details und -Inhalt speichern

Kontakt-Aktivitäts-Integration

Eingehende E-Mails sind in die Kontakt-Aktivitätsverfolgung integriert:

Aktivitäts-Aufzeichnung:

  • Kontakt-Zuordnung: Eingehende E-Mails bestimmten Kontakten zuordnen
  • Aktivitätstyp: E-Mails als Kontakt-Aktivitäten mit korrektem Typ erfassen
  • Zeitleisten-Integration: E-Mails in die Kontakt-Aktivitäts-Zeitleiste einbeziehen
  • Benutzerzuordnung: E-Mail-Aktivitäten den passenden Benutzern zuordnen

E-Mail-Aktivitäts-Funktionen:

  • Betreff-Verfolgung: E-Mail-Betreffe zur Aktivitätsreferenz erfassen
  • Nachrichteninhalt: E-Mail-Nachrichteninhalt zur Prüfung speichern
  • Kontakt-Verknüpfung: Direkte Verknüpfung zwischen E-Mails und Kontaktdatensätzen
  • Aktivitätsverlauf: Vollständiger Verlauf der E-Mail-Kommunikation pro Kontakt

Synchronisations-Vorteile:

  • Einheitliche Kommunikation: Alle E-Mail-Kommunikation in Kontaktdatensätzen zentralisiert
  • Aktivitäts-Zeitleiste: Chronologische Zeitleiste aller Kontakt-Interaktionen
  • Team-Sichtbarkeit: Teamweite Sichtbarkeit der E-Mail-Kommunikation
  • Kontakt-Kontext: Vollständiger Kontext der E-Mail-Kommunikation pro Kontakt

Verwandte Artikel