Microsoft Outlook 365 mit CiviCRM verbinden
Wer Microsoft Outlook 365 für seine E-Mail-Kommunikation verwendet, kann direkt aus Outlook heraus auf Kontakte und Gruppen in CiviCRM zugreifen. Möglich macht das die Erweiterung Outlook 365 Integration, die von Jaap Jansma (CiviCoop) entwickelt und unter anderem von Agileware weiterentwickelt wurde.
Die Erweiterung stellt ein Add-in für die Web- und Desktopversion von Outlook 365 bereit. Damit lassen sich:
- Kontakte und Gruppen aus CiviCRM suchen und als E-Mail-Empfänger auswählen,
- neue Kontakte aus Absendern und Empfängern von E-Mails in CiviCRM anlegen und Gruppen zuordnen,
- E-Mails als Aktivitäten in CiviCRM speichern und den beteiligten Kontakten zuordnen.
Die Erweiterung dient also dazu, CiviCRM aus Outlook heraus zu nutzen. Sie ist aber keine allgemeine Synchronisationslösung für sämtliche Outlook-Daten.
Inhaltsverzeichnis
Wie funktioniert die Anbindung?
Die Verbindung wird über ein Outlook-Add-in hergestellt, das auf die CiviCRM-Installation zugreift. Für die Einrichtung sind einige Schritte erforderlich:
-
Erweiterungen installieren: Neben der Outlook 365 Integration werden die CiviCRM-Erweiterungen Data Processor und API Key benötigt. Sie ermöglichen die Kontaktsuche und die Verwaltung der benutzerspezifischen API-Zugangsschlüssel.
-
Outlook-Add-in bereitstellen: Nach der Installation steht im CiviCRM-Administrationsmenü die Funktion Download Outlook 365 Manifest zur Verfügung. Darüber lässt sich eine XML-Datei herunterladen, die das Add-in für die eigene CiviCRM-Installation beschreibt. Dieses Manifest wird in Outlook als benutzerdefiniertes Add-in eingebunden. Die Bereitstellung kann für einzelne Benutzer oder zentral für eine Organisation erfolgen.
-
Verbindung herstellen: Beim ersten Aufruf benötigt das Add-in drei Angaben: die REST-URL der CiviCRM-Installation (in CiviCRM standalone:
https://deine-domain.de/civicrm/ajax/rest), den Site Key der Installation und einen persönlichen API Key für den jeweiligen CiviCRM-Benutzer. Über diese Zugangsdaten kommuniziert Outlook mit der CiviCRM-APIv3. Für jeden Benutzer wird ein eigener API-Schlüssel eingerichtet. Ist die Erweiterung API Key installiert, findet man Site- und API-Key am Kontakt, der dem Benutzer zugeordnet ist. -
Zugriff und Suchergebnisse konfigurieren: In CiviCRM müssen die erforderlichen Berechtigungen eingerichtet werden. Über die Erweiterung Data Processor lässt sich außerdem festlegen, welche Kontakte, Gruppen und Informationen für die Suche aus Outlook heraus zur Verfügung stehen. Damit kann beispielsweise der Zugriff auf bestimmte Kontaktgruppen eingeschränkt werden.
↑ Zurück zum Inhaltsverzeichnis
Besonderheit bei CiviCRM Standalone
Bei CiviCRM Standalone wird nach der Installation der Outlook-Erweiterung die zusätzliche Berechtigung Access Outlook 365 pages im Berechtigungssystem registriert.
Sie ist unter Administration → Benutzer und Berechtigungen → Benutzerberechtigungen zu finden.
Die Entwickleranleitung verlangt, diese Berechtigung auch für anonyme Besucher freizugeben, damit das Outlook-Add-in seine Seiten ohne eine bestehende CiviCRM-Browsersitzung aufrufen kann. Unter CiviCRM Standalone entspricht dies der Rolle Alle (auch anonyme User).
Die Berechtigung muss dieser Rolle ausdrücklich zugewiesen werden. Sie ist nach der Installation zunächst noch nicht zugeordnet.
Diese Freigabe ist von der Authentifizierung für den Zugriff auf CiviCRM-Daten zu unterscheiden. Hierfür benötigt jeder Benutzer weiterhin seinen persönlichen API-Schlüssel und die entsprechenden Zugriffsrechte.
↑ Zurück zum Inhaltsverzeichnis
Installation und Einrichtung
Die Entwickler stellen eine englischsprachige Schritt-für-Schritt-Anleitung bereit, die die Installation der Erweiterungen, die erforderlichen Berechtigungen, die Bereitstellung des Outlook-Add-ins und die Konfiguration der Verbindung beschreibt.
Eine deutschsprachige Anleitung findet sich außerdem in der Community von Software für Engagierte. Sie enthält praktische Hinweise zur Einrichtung, zur Steuerung der zugänglichen Kontaktdaten über den Data Processor sowie ergänzende Erfahrungsberichte. Der Beitrag wurde 2022 veröffentlicht und 2023 ergänzt.
Weiterführende Informationen:
- Outlook 365 Integration im CiviCRM-Erweiterungsverzeichnis
- Getting Started – Installationsanleitung der Entwickler
- Deutschsprachige Anleitung und Diskussion bei Software für Engagierte
Stand der Recherche: 19. Oktober 2026. Im CiviCRM-Erweiterungsverzeichnis ist Version 2.2.7 vom 14. November 2024 veröffentlicht. Die Registrierung der Outlook-Berechtigung wurde unter CiviCRM Standalone 6.19.1 überprüft. Die vollständige Funktionsfähigkeit der Integration sollte fallweise getestet werden. Für aktuelle Installationshinweise ist die Dokumentation der Entwickler maßgeblich.
