Accounts
========

.. toctree::
   :hidden:

   accounts/register-app
   accounts/account-setup
   accounts/migrate-from-email-channel
   accounts/secondary-addresses
   accounts/managing-accounts

:doc:`accounts/register-app`
   Use the **Connect Microsoft 365 App** dialog to register Zammad as an
   OAuth app on Microsoft.

   (This step is **required**; read on to learn why.)

   .. figure:: /images/channels/microsoft365/accounts/register-app/04-add-oauth-credentials.gif
      :alt: Registering Zammad as a Microsoft OAuth app
      :scale: 60%
      :align: center

:doc:`accounts/account-setup`
   Use the **Add Account** dialog to connect your account.

   You're migrating existing email channels? Look below!

   .. figure:: /images/channels/microsoft365/accounts/account-setup/add-microsoft365-account-to-zammad.gif
      :alt: Adding your gmail account to Zammad
      :scale: 60%
      :align: center

:doc:`accounts/migrate-from-email-channel`
   Use the *Migrate now!* button within your email channels to quickly move
   your mailboxes to Microsoft 365. You can roll back if things hit the fan!

   .. figure:: /images/channels/microsoft365/accounts/migrate-email-channel-to-microsoft365.gif
      :alt: Migrate an existing email channel to Microsoft 365
      :scale: 60%
      :align: center

:doc:`accounts/secondary-addresses`
   Send and receive email at **additional email addresses**,
   all through the same mailbox/account.

   .. figure:: /images/channels/microsoft365/accounts/add-microsoft365-alias.gif
      :alt: Adding new aliases to your Microsoft account in Zammad
      :scale: 60%
      :align: center

:doc:`accounts/managing-accounts`
   Edit the configuration of existing accounts in the **Accounts Panel**.

   .. figure:: /images/channels/microsoft365/panel.png
      :alt: Existing accounts can be edited from the Accounts panel.
      :scale: 60%
      :align: center

.. note:: 🤔 **How do I use my Microsoft 365 account for outgoing system notifications?**

   On **subscription/cloud-hosted instances**, you can't.
   Notifications will always come from
   “Notification Master <noreply\@your.zammad.domain>”.

   On **self-hosted instances**, we still don't recommend it.
   Using a Microsoft account for automated, outgoing messages is risky:
   users who exceed Microsoft's
   `email sending limits <https://docs.microsoft.com/en-us/office365/servicedescriptions/exchange-online-service-description/exchange-online-limits#receiving-and-sending-limits>`_
   can have their accounts suspended.

   Set up a generic :doc:`email channel </channels/email/index>` instead,
   then use the :ref:`Email Notification <email-notification>` setting.