> For the complete documentation index, see [llms.txt](https://replyx-docs.sematell.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://replyx-docs.sematell.com/how-to/admins/email-channels.md). # E-Mail-Kanäle anbinden Als Admin verbindest du E-Mail-Kanäle, damit ReplyX Nachrichten empfangen und Antworten senden kann. ## Bevor du startest Kläre vor der Einrichtung, welches Postfach ReplyX nutzen soll und welche Zugangsdaten oder Freigaben du für den jeweiligen Anbieter brauchst. ## E-Mail-Kanäle verbinden Du startest die Konfiguration über: `Kommunikation -> E-Mail-Kanäle -> E-Mail-Kanal verbinden` Unterstützte Varianten: * `Exchange Online` mit OAuth2 * `IMAP/SMTP` mit Basic Auth ## Variante auswählen * `Exchange Online`: bevorzugte Variante für Microsoft-365-Umgebungen * `IMAP/SMTP`: Fallback für klassische Provider oder eigene Mailserver ## Exchange Online anbinden Voraussetzungen: * Microsoft-365-Tenant * Zugriff auf das Azure Portal beziehungsweise Microsoft Entra ID * das Support-Postfach, das ReplyX verwenden soll Beim Authorization Code Flow erfolgt die Autorisierung im Kontext des angemeldeten Benutzerkontos. Deshalb sind sowohl die Zustimmung zur App im Microsoft-Tenant als auch die Postfachrechte dieses Benutzerkontos relevant. ## Admin Consent in Microsoft Entra ID erteilen Admin Consent ist nötig, wenn ReplyX beim Verbinden anzeigt, dass eine Administratorgenehmigung erforderlich ist, oder wenn der angemeldete Benutzer die App nicht für den Tenant freigeben darf. Für tenantweiten Admin Consent benötigt der ausführende Admin eine passende Rolle, zum Beispiel `Cloud Application Administrator` oder eine vergleichbare Rolle mit Berechtigung zur Administratorzustimmung. 1. Öffne das Microsoft Entra Admin Center. 2. Wechsle zu `Enterprise applications`. 3. Suche nach `ReplyX E-Mail-Connector`. 4. Öffne die Anwendung. 5. Wechsle zu `Permissions` beziehungsweise `Berechtigungen`. 6. Führe `Grant admin consent` beziehungsweise `Administratorzustimmung erteilen` aus. 7. Verbinde oder prüfe danach den Exchange-Online-Kanal in ReplyX erneut. Weitere Informationen: [Grant tenant-wide admin consent to an application](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/grant-admin-consent?pivots=portal) ## Zugriff auf eine Shared Mailbox freigeben Wenn ReplyX eine Shared Mailbox verwenden soll, muss das Benutzerkonto, das für den Authorization Code Grant verwendet wird, explizit Zugriff auf diese Shared Mailbox haben. Es reicht nicht, dass die Shared Mailbox in Outlook sichtbar ist. Das Konto muss namentlich unter `Full Access` beziehungsweise `Read and manage` hinterlegt sein. Zugriff über Gruppen, Auto-Mapping oder bestehende Outlook-Sichtbarkeit kann für die Anbindung unzureichend sein. 1. Öffne das Exchange Admin Center. 2. Wechsle zu `Recipients -> Mailboxes`. 3. Wähle die Shared Mailbox aus. 4. Öffne `Mailbox delegation` beziehungsweise `Delegation`. 5. Klicke bei `Full Access` beziehungsweise `Read and manage` auf `Edit` oder `Manage`. 6. Wähle `Add permissions`. 7. Füge das Benutzerkonto hinzu, das für den Authorization Code Grant verwendet wird. 8. Speichere die Änderung. 9. Verbinde oder prüfe danach den Exchange-Online-Kanal in ReplyX erneut. Weitere Informationen: [Create a shared mailbox](https://learn.microsoft.com/en-us/microsoft-365/admin/email/create-a-shared-mailbox?view=o365-worldwide) ## Schritte für Exchange Online 1. Prüfe, welches Microsoft-365-Postfach ReplyX verwenden soll. 2. Richte bei einer Shared Mailbox `Full Access` beziehungsweise `Read and manage` für das verwendete Benutzerkonto ein. 3. Erteile bei Bedarf Admin Consent in Microsoft Entra ID. 4. Starte die Verbindung in ReplyX. 5. Melde dich mit dem berechtigten Benutzerkonto an. 6. Bestätige den Zugriff. 7. Hinterlege Tenant-ID und Support-Postfach. 8. Speichere und prüfe die Verbindung. ## IMAP/SMTP anbinden ## Schritte für IMAP/SMTP Halte diese Angaben bereit: * IMAP-Server, Port, Benutzername, Passwort und Verschlüsselung * SMTP-Server, Port, Benutzername, Passwort und Verschlüsselung Das Beispiel zeigt die getrennte Konfiguration für eingehende E-Mails per IMAP und ausgehende E-Mails per SMTP. ![IMAP- und SMTP-Einstellungen für einen E-Mail-Kanal](https://875369800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWF28ykq7VpKkIK20Ysvv%2Fuploads%2Fgit-blob-4dce5697b2555aa98996fdfc130a14ad0664c8a8%2Freplyx-imap-smtp-settings.png?alt=media) Empfehlungen: * Verschlüsselung immer aktivieren * nur dedizierte Support-Postfächer verwenden * Passwortänderungen dokumentieren ## Ergebnis ReplyX empfängt neue Nachrichten über den verbundenen Kanal und sendet Antworten über den konfigurierten Versandweg. ## Häufige Probleme | Problem | Ursache | Lösung | | ------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | Administratorgenehmigung erforderlich | Der angemeldete Benutzer darf die App nicht tenantweit freigeben. | Admin Consent im Microsoft Entra Admin Center erteilen lassen. | | Shared Mailbox kann nicht gelesen werden | Das verwendete Benutzerkonto hat keinen expliziten Full Access auf die Shared Mailbox. | Im Exchange Admin Center `Full Access` beziehungsweise `Read and manage` für dieses Konto setzen. | | Postfach ist in Outlook sichtbar, funktioniert aber in ReplyX nicht | Outlook-Sichtbarkeit ist kein sicherer Nachweis für ausreichende API-Berechtigungen. | Prüfen, ob das Konto in der Shared Mailbox Delegation explizit unter `Full Access` beziehungsweise `Read and manage` gelistet ist. | | Bestehender Kanal funktioniert nach Flow-Umstellung nicht mehr | Der Kanal wurde noch mit dem alten Authorization Flow eingerichtet. | Exchange-Online-Kanal in ReplyX neu verbinden. | ## Betriebshinweise * Erreichbarkeit der Mailserver prüfen * Firewall-, Proxy- und Portfreigaben prüfen * Freigaben und Zugriffe regelmäßig überprüfen ## Verwandte Themen * [Kommunikation und Integrationen](https://github.com/sematell/rx_documentation/tree/main/docs/de/concepts/communication-and-integrations.md) * [Integrationen verbinden](/how-to/admins/integrations.md) * [Typische Störungen beheben](/how-to/admins/troubleshooting.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://replyx-docs.sematell.com/how-to/admins/email-channels.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.