E-Mail-Integration & Konnektivität
Gmail-Integration
OAuth-Verbindung und -Einrichtung
Corcava bietet nahtlose Gmail-Integration über Google-OAuth-Authentifizierung:
Gmail-Verbindungsprozess:
- OAuth-Autorisierung: Verbindung über den Google-OAuth-Flow initiieren
- Berechtigungsvergabe: Notwendige Berechtigungen für E-Mail-Zugriff und -Versand erteilen
- Token-Verwaltung: Sichere Speicherung von Access- und Refresh-Tokens
- Konto-Verifizierung: E-Mail-Konto-Inhaberschaft und Gültigkeit verifizieren
- 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:
- OAuth-Redirect: Weiterleitung zum Microsoft-OAuth-Autorisierungs-Endpunkt
- Scope-Autorisierung: Erforderliche Berechtigungen für E-Mail- und Kalenderzugriff anfordern
- Kontoauswahl: Aufforderung zur Microsoft-Kontoauswahl
- Token-Austausch: Autorisierungscode gegen Access- und Refresh-Tokens eintauschen
- 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:
- Konto-Scan: Verbundene Gmail-Konten auf neue Nachrichten scannen
- Kontakt-Identifikation: E-Mails von bekannten Kontakten identifizieren
- Duplikat-Prüfung: Auf bestehende E-Mails prüfen, um Duplikate zu vermeiden
- Aktivitäts-Erstellung: Kontakt-Aktivitätsdatensätze für neue E-Mails erstellen
- 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
