Microsoft 365 Mailversand für Gambio (OAuth2)

Gambio-Mails über Microsoft 365 senden: ohne SMTP-Passwort

Microsoft stellt den E-Mail-Versand mit Benutzername und Passwort (Basic Authentication) schrittweise ab. Läuft Ihr Shop-Postfach bei Microsoft 365 (früher Office 365, Exchange Online), kann der klassische SMTP-Versand von Gambio deshalb ausfallen, oft mit Meldungen wie smtp_connect_failed. Das Modul Microsoft 365 Mailversand löst das Problem an der Wurzel: Der Shop meldet sich als eigene Anwendung bei Ihrem Microsoft-365-Konto an und versendet über die Microsoft Graph API mit OAuth2.

Ihre Vorteile

• Alle Shop-Mails über Microsoft 365: Bestellbestätigungen, Kontaktformular, Statusmails und alle Mailvorlagen.
• Keine Änderung an Ihren Mail-Einstellungen: Gambio baut die Mails wie gewohnt auf, inklusive Anhängen sowie HTML- und Text-Teil. Nur der letzte Schritt, der Versand, läuft über Microsoft.
• Jede Mail mit der richtigen Absenderadresse: Shop-Adresse, Bestell- und Kontaktpostfach werden einzeln als Absender verwendet. Ein optionales Ersatz-Postfach fängt Adressen ab, die in Microsoft 365 kein Postfach sind.
• Ausfallsicher: Ist das Modul ausgeschaltet oder nicht vollständig eingerichtet, versendet der Shop über die normale Gambio-Einstellung. Es geht keine E-Mail verloren.
• Automatische Secret-Erneuerung (optional): Das Modul erzeugt vor Ablauf selbst ein neues Client-Secret, prüft es und entfernt danach das alte.
• Sicher: Das Client-Secret wird verschlüsselt gespeichert und nie wieder angezeigt. Mit einer Application Access Policy beschränken Sie die App auf die Absender-Postfächer Ihres Shops.
• Prüfwerkzeuge im Admin: Statusanzeige, Verbindungstest (zeigt die tatsächlich erteilten Berechtigungen), Testmail und Ablaufwarnung.

So funktioniert die Einrichtung

Die Einrichtung erfolgt einmalig und erfordert Administratorrechte in Microsoft 365. Eine bebilderte Schritt-für-Schritt-Anleitung liegt dem Modul bei. Dieselbe Anleitung steht in der Modulseite im Shop-Admin, mit kopierfertigen PowerShell-Befehlen:

1. App in Microsoft Entra registrieren und Anwendungs-ID sowie Verzeichnis-ID ins Modul übernehmen.
2. Geheimen Clientschlüssel erstellen und im Modul hinterlegen.
3. Berechtigung zum Senden (Mail.Send) erteilen.
4. Zugriff auf die Shop-Postfächer beschränken (optional, empfohlen).
5. Automatische Secret-Erneuerung vorbereiten (optional).

Die Schritte 4 und 5 werden in PowerShell oder im Graph Explorer ausgeführt und sollten von Fachpersonal vorgenommen werden. Gern übernehmen wir die Einrichtung für Sie: support@winhelp.eu

Technische Daten

• Für Gambio ab Version GX4.3 (PHP 7.4 oder neuer); eigene Modulversion für GX5 oder GX26.
• Versand über Microsoft Graph API (sendMail) mit OAuth2 (Client Credentials).
• Maximal 4 MB je Mail (Grenze von Microsoft, gemessen nach der Kodierung).
• Öffentliche Microsoft-Cloud; Sonderclouds (z. B. GCC High, China) werden nicht unterstützt.
• Installation, Update und Deinstallation über das Gambio-Modul-Center, ohne Überschreiben von Shop-Dateien.

Häufige Fragen

Funktioniert das auch mit „Office 365“?
Ja. Office 365 und Microsoft 365 sind derselbe Dienst, Microsoft hat ihn umbenannt. Das Modul arbeitet mit jedem Microsoft-365-/Exchange-Online-Postfach.

Warum nicht einfach SMTP mit Passwort?
Microsoft schaltet die Anmeldung mit Passwort für den Mailversand schrittweise ab. OAuth2 ist der Weg, den Microsoft vorsieht.

Was passiert, wenn die Verbindung gestört ist?
Das Modul zeigt den letzten Fehler im Admin an. Ist es nicht vollständig eingerichtet, versendet Gambio über die normale Einstellung.

Brauche ich ein eigenes Postfach pro Absender?
Nein. Es wird je Mail die Absenderadresse des Shops verwendet. Adressen, die kein Postfach sind, können über ein Ersatz-Postfach laufen; die ursprüngliche Adresse steht dann als „Antwort an“.

Support

Bei Fragen zur Einrichtung oder Nutzung erreichen Sie uns unter support@winhelp.eu.