Account Setup¶
After youâve registered Zammad as an OAuth app in your Azure Portal, you can begin connecting Microsoft accounts to Zammad.
â ïž But first, a word of warning! The import process does things you might not expect:
Gefahr
đŻ Zammad will delete all emails in your inbox during the import process.
Use the Keep Messages on Server setting to disable this behavior.
Warnung
đź Zammad will send an auto-reply message to every email it imports. (Including the old ones!)
Make sure to disable this behavior prior adding an email account, and to turn it back on once all your messages have been imported.
đ Migrate an Existing Email Channel¶
If youâve already added your Microsoft 365 account as a regular email channel, youâll have to convert it to a Microsoft 365 channel eventually: Microsoft is planning to end support for simple password authentication in third-party email clients (like Zammad). But thereâs no rush just yet.
Upcoming versions of Zammad will feature an automated migration wizard to help you make the switch, and itâll be available well before Microsoft officially pulls the plug on password auth.
Add a New Account¶
Click Add Account to connect your Microsoft 365 / Outlook accounts to Zammad. You will be redirected to a Microsoft sign-in and confirmation page.
Bemerkung
đ”ïž Aliases are not imported automatically.
See Secondary Addresses to add them yourself.
Channel¶
- Folder
Specify which folder (or label) to fetch from, or leave empty to fetch from
INBOX
.If specifying a nested folder, be sure to use the full path; e.g.,
Inquiries/Tech-Support
.- Keep messages on server
Specify what happens to your emails after Zammad imports them:
no
Zammad deletes all imported messagesyes
Zammad marks imported messages as read(With this option, Zammad will only import unread messages. This means Zammad may miss messages if the mailbox is externally modified.)
Bemerkung
đ€ Why does Zammad delete messages by default?
If you never clean out your inbox, itâll eventually reach its storage limit, and your mail server will start rejecting incoming messages. Most Zammad users never even look at their inbox once itâs set up, so they rely on Zammad to keep it clean for them.
If you choose yes here, remember that itâs your responsibility to clean out your inbox from time to time to keep it below its storage limit.
Troubleshooting¶
- I successfully added my account, but Zammad isnât fetching new email
- If you specified a custom folder/label to fetch from, are you sure incoming mail is arriving in that folder?