[Modul] Microsoft 365 / Office 365: Shop-Mails per OAuth2 versenden (Graph API)

Thema wurde von WinHelp GmbH, 13. Oktober 2026 erstellt.

  1. WinHelp GmbH

    WinHelp GmbH Erfahrener Benutzer

    Hallo zusammen,

    das Thema kommt hier immer wieder hoch: Die Shop-Mails über Microsoft 365 gehen nicht mehr raus, im Log steht [ICODE]smtp_connect_failed[/ICODE]. Das ist kein Gambio-Fehler. Microsoft schaltet die Anmeldung per Benutzername und Passwort (Basic Authentication) nach und nach ab, und der SMTP-Versand in Gambio kann kein OAuth2.

    Wir haben uns dafür ein Modul gebaut. Vorweg, damit das klar ist: Das ist ein kommerzielles Modul von uns (WinHelp GmbH).

    Kurz, was es tut: Gambio baut die Mails wie bisher zusammen, mit Anhängen, HTML- und Textteil und allen Vorlagen. Nur der letzte Schritt, der eigentliche Versand, läuft nicht mehr über SMTP, sondern über die Microsoft Graph API mit OAuth2 (Client Credentials). Jede Mail behält ihre eigene Absenderadresse, Shop-, Bestell- und Kontaktpostfach bleiben also getrennt. Für Adressen, hinter denen in Microsoft 365 gar kein Postfach steckt, kann man optional ein Ersatz-Postfach hinterlegen.

    Wichtig war uns, dass nichts hängen bleibt: Ist das Modul aus oder noch nicht fertig eingerichtet, versendet Gambio einfach wie vorher. Es bleibt also keine Bestellbestätigung liegen, nur weil im Entra-Portal etwas fehlt.

    Eingerichtet wird einmalig im Microsoft-365-Tenant, dafür braucht man Adminrechte: App in Entra registrieren, Client-Secret anlegen, Mail.Send freigeben und – empfohlen – per Application Access Policy auf die Shop-Postfächer einschränken. Die Anleitung inklusive der PowerShell-Befehle liegt bei und steht auch im Shop-Admin auf der Modulseite. Das Secret kann sich das Modul auf Wunsch selbst erneuern.

    Technisch: ab GX4.3 mit PHP 7.4, für GX5 und GX26 gibt es eine eigene Version. Microsoft deckelt den Versand bei 4 MB pro Mail, das gilt hier genauso. Sonderclouds wie GCC High oder China unterstützen wir nicht.

    Die automatische Secret-Erneuerung läuft beim Mailversand mit und lässt sich im Admin per Button auslösen. Ein Shop, der in den letzten Wochen vor Ablauf gar keine Mail verschickt, erneuert das Secret also nicht von allein.

    Mehr dazu: https://shop.winhelp.eu/gambio-modul-microsoft-365-mailversand-oauth2.html

    Fragen zur Einrichtung gerne hier im Thread, dann haben andere auch was davon.