Maintenance: Tweaks in M365 common error pages

channels/microsoft365-graph/common-errors.rst

@@ -15,10 +15,10 @@ your error is not covered here.
 Problem with User Mailbox
 -------------------------
 
-``MailboxNotEnabledForRESTAPI``
-  *The mailbox is either inactive, soft-deleted, or is hosted on-premise.*
+**Error message:** ``MailboxNotEnabledForRESTAPI. The mailbox is either inactive,
+soft-deleted, or is hosted on-premise.``
 
-Possible reasons:
+**Possible reasons:**
 
 - The user has no access to the mailbox.
 - The account has no mailbox at all (user mailboxes).
@@ -29,8 +29,8 @@ a mailbox for this user.
 Problem with User Permissions
 -----------------------------
 
-``ErrorItemNotFound``
-  *The specified object was not found in the store., Default folder Root not found.*
+**Error message:** ``ErrorItemNotFound. The specified object was not found in the
+store. Default folder Root not found.``
 
 Indicates that the user has no delegation permissions for the mailbox.
 Make sure that the permissions are set correctly or consider using another
@@ -39,8 +39,7 @@ account.
 Problem with Shared Mailbox
 ---------------------------
 
-``ErrorInvalidUser``
-  *The requested user '\*' is invalid.*
+**Error message:** ``ErrorInvalidUser. The requested user '\*' is invalid.``
 
 Possible reason could be that the shared mailbox you provided is wrong.
 Check if the provided shared mailbox email address is correct.

channels/microsoft365/common-errors.rst

@@ -21,11 +21,8 @@ request to the wrong tenant.
 
 In this case, please compare whether the client ID created in Zammad
 matches that in Azure for the Azure App.
-
 The Client ID can be found in the Zammad settings under
 *Channels > Microsoft 365 IMAP Email > App Configuration*.
-See :doc:`account setup </channels/microsoft365/accounts>` how to find
-the client ID in Azure and where to copy it to Zammad.
 
 Wrong or Expired Client Secret
 ------------------------------
@@ -38,12 +35,6 @@ Wrong or Expired Client Secret
    :align: center
 
 This error occurs when the client uses an incorrect or expired client secret.
-
-.. warning:: **Important notice:**
-  We never ask the client for the client secret as this can potentially be a
-  security risk. We ask the customer to create a new client secret and copy the
-  value and not the ID to Zammad.
-
 See :doc:`account setup </channels/microsoft365/accounts>` for more
 information.
 
@@ -59,10 +50,9 @@ neither a valid DNS name, nor a valid external domain.
    :align: center
 
 If a wrong tenant is used in Zammad or the email account is not a member of
-the tenant created in Zammad, this error message occurs.
-
-In this case, please check if the tenant is entered correctly in
-Zammad, or remove the tenant completely.
+the tenant created in Zammad, this error message occurs. In such a case, please
+check if the tenant is entered correctly in Zammad, or remove the tenant
+completely.
 
 .. warning:: **Important notice:**
    Once the tenant is completely removed, all email accounts can be created in
@@ -89,8 +79,8 @@ can be found on how to request admin consent from Zammad.
    The request for the admin consent can be bypassed by assigning the admin
    consent in Azure to the App.
 
-   Home > App Registration > Manage > API Permission > Grant admin consent for
-   "MSFT".
+   *Home > App Registration > Manage > API Permission > Grant admin consent for
+   "MSFT"*.
 
 Missing Permissions for the Azure User
 --------------------------------------
@@ -174,7 +164,6 @@ To avoid this, you should change the
 from "Dynamic Delivery" to something else fitting your needs (e.g. "Block") for
 your Office 365 instance.
 
-
 Authentication Unsuccessful
 ---------------------------
 

locale/admin-docs.pot

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Zammad Admin Documentation pre-release\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2026-04-09 17:00+0200\n"
+"POT-Creation-Date: 2026-04-10 07:29+0200\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -4423,7 +4423,7 @@ msgid "In case you are using an user mailbox, the new user has to match the exis
 msgstr ""
 
 #: ../channels/microsoft365-graph/accounts.rst:207
-#: ../channels/microsoft365/common-errors.rst:72
+#: ../channels/microsoft365/common-errors.rst:62
 msgid "Request Admin Consent"
 msgstr ""
 
@@ -4448,16 +4448,12 @@ msgstr ""
 msgid "Problem with User Mailbox"
 msgstr ""
 
-#: ../channels/microsoft365-graph/common-errors.rst:19
-msgid "``MailboxNotEnabledForRESTAPI``"
-msgstr ""
-
-#: ../channels/microsoft365-graph/common-errors.rst:19
-msgid "*The mailbox is either inactive, soft-deleted, or is hosted on-premise.*"
+#: ../channels/microsoft365-graph/common-errors.rst:18
+msgid "**Error message:** ``MailboxNotEnabledForRESTAPI. The mailbox is either inactive, soft-deleted, or is hosted on-premise.``"
 msgstr ""
 
 #: ../channels/microsoft365-graph/common-errors.rst:21
-msgid "Possible reasons:"
+msgid "**Possible reasons:**"
 msgstr ""
 
 #: ../channels/microsoft365-graph/common-errors.rst:23
@@ -4476,12 +4472,8 @@ msgstr ""
 msgid "Problem with User Permissions"
 msgstr ""
 
-#: ../channels/microsoft365-graph/common-errors.rst:33
-msgid "``ErrorItemNotFound``"
-msgstr ""
-
-#: ../channels/microsoft365-graph/common-errors.rst:33
-msgid "*The specified object was not found in the store., Default folder Root not found.*"
+#: ../channels/microsoft365-graph/common-errors.rst:32
+msgid "**Error message:** ``ErrorItemNotFound. The specified object was not found in the store. Default folder Root not found.``"
 msgstr ""
 
 #: ../channels/microsoft365-graph/common-errors.rst:35
@@ -4492,15 +4484,11 @@ msgstr ""
 msgid "Problem with Shared Mailbox"
 msgstr ""
 
-#: ../channels/microsoft365-graph/common-errors.rst:43
-msgid "``ErrorInvalidUser``"
-msgstr ""
-
-#: ../channels/microsoft365-graph/common-errors.rst:43
-msgid "*The requested user '\\*' is invalid.*"
+#: ../channels/microsoft365-graph/common-errors.rst:42
+msgid "**Error message:** ``ErrorInvalidUser. The requested user '\\*' is invalid.``"
 msgstr ""
 
-#: ../channels/microsoft365-graph/common-errors.rst:45
+#: ../channels/microsoft365-graph/common-errors.rst:44
 msgid "Possible reason could be that the shared mailbox you provided is wrong. Check if the provided shared mailbox email address is correct."
 msgstr ""
 
@@ -5013,173 +5001,157 @@ msgstr ""
 #: ../channels/microsoft365/common-errors.rst:None
 #: ../channels/microsoft365/common-errors.rst:None
 #: ../channels/microsoft365/common-errors.rst:None
-#: ../channels/microsoft365/common-errors.rst:105
-#: ../channels/microsoft365/common-errors.rst:114
+#: ../channels/microsoft365/common-errors.rst:95
+#: ../channels/microsoft365/common-errors.rst:104
 #: ../channels/microsoft365/common-errors.rst:None
 msgid "Error message"
 msgstr ""
 
 #: ../channels/microsoft365/common-errors.rst:22
-msgid "In this case, please compare whether the client ID created in Zammad matches that in Azure for the Azure App."
+msgid "In this case, please compare whether the client ID created in Zammad matches that in Azure for the Azure App. The Client ID can be found in the Zammad settings under *Channels > Microsoft 365 IMAP Email > App Configuration*."
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:25
-msgid "The Client ID can be found in the Zammad settings under *Channels > Microsoft 365 IMAP Email > App Configuration*. See :doc:`account setup </channels/microsoft365/accounts>` how to find the client ID in Azure and where to copy it to Zammad."
-msgstr ""
-
-#: ../channels/microsoft365/common-errors.rst:31
+#: ../channels/microsoft365/common-errors.rst:28
 msgid "Wrong or Expired Client Secret"
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:33
+#: ../channels/microsoft365/common-errors.rst:30
 msgid "**Error message:** 500: We're sorry, but something went wrong."
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:40
-msgid "This error occurs when the client uses an incorrect or expired client secret."
+#: ../channels/microsoft365/common-errors.rst:37
+msgid "This error occurs when the client uses an incorrect or expired client secret. See :doc:`account setup </channels/microsoft365/accounts>` for more information."
 msgstr ""
 
 #: ../channels/microsoft365/common-errors.rst:42
-msgid "**Important notice:** We never ask the client for the client secret as this can potentially be a security risk. We ask the customer to create a new client secret and copy the value and not the ID to Zammad."
-msgstr ""
-
-#: ../channels/microsoft365/common-errors.rst:47
-msgid "See :doc:`account setup </channels/microsoft365/accounts>` for more information."
-msgstr ""
-
-#: ../channels/microsoft365/common-errors.rst:51
 msgid "Wrong Tenant"
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:53
+#: ../channels/microsoft365/common-errors.rst:44
 msgid "**Error message:** AADSTS0023: Specified tenant identifier 'xxxxxxxx' is neither a valid DNS name, nor a valid external domain."
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:61
-msgid "If a wrong tenant is used in Zammad or the email account is not a member of the tenant created in Zammad, this error message occurs."
+#: ../channels/microsoft365/common-errors.rst:52
+msgid "If a wrong tenant is used in Zammad or the email account is not a member of the tenant created in Zammad, this error message occurs. In such a case, please check if the tenant is entered correctly in Zammad, or remove the tenant completely."
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:64
-msgid "In this case, please check if the tenant is entered correctly in Zammad, or remove the tenant completely."
-msgstr ""
-
-#: ../channels/microsoft365/common-errors.rst:67
+#: ../channels/microsoft365/common-errors.rst:57
 msgid "**Important notice:** Once the tenant is completely removed, all email accounts can be created in Zammad regardless of which tenant the email account is a member of."
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:74
+#: ../channels/microsoft365/common-errors.rst:64
 msgid "**Prompt:** approval required"
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:81
+#: ../channels/microsoft365/common-errors.rst:71
 msgid "This message occurs when the admin tries to create an email account in Zammad that has not yet received approval from the Azure global admin."
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:84
+#: ../channels/microsoft365/common-errors.rst:74
 msgid "In our documentation, :doc:`step-by-step instructions </channels/microsoft365/accounts/account-setup>` can be found on how to request admin consent from Zammad."
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:89
+#: ../channels/microsoft365/common-errors.rst:79
 msgid "The request for the admin consent can be bypassed by assigning the admin consent in Azure to the App."
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:92
-msgid "Home > App Registration > Manage > API Permission > Grant admin consent for \"MSFT\"."
+#: ../channels/microsoft365/common-errors.rst:82
+msgid "*Home > App Registration > Manage > API Permission > Grant admin consent for \"MSFT\"*."
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:96
+#: ../channels/microsoft365/common-errors.rst:86
 msgid "Missing Permissions for the Azure User"
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:98
+#: ../channels/microsoft365/common-errors.rst:88
 msgid "**Error message:** Can't use Channel:Driver::SMTPAuthentificationError:Net::SMTPAuthentificationError"
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:105
+#: ../channels/microsoft365/common-errors.rst:95
 msgid "Error message in the M365 channel settings"
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:107
+#: ../channels/microsoft365/common-errors.rst:97
 msgid "or"
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:114
+#: ../channels/microsoft365/common-errors.rst:104
 msgid "Error message in the ticket"
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:116
+#: ../channels/microsoft365/common-errors.rst:106
 msgid "This error occurs when the admin wants to create an email account in Zammad whose user does not have permission for SMTP authentication to the mail server. Please check the following two most common problems in this case."
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:121
+#: ../channels/microsoft365/common-errors.rst:111
 msgid "Private Email Account"
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:123
+#: ../channels/microsoft365/common-errors.rst:113
 msgid "If it is a private email account, the admin must grant the SMTP authentication permission to the user of the inbox. The permission is provided at https://admin.microsoft.com."
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:127
+#: ../channels/microsoft365/common-errors.rst:117
 msgid "Add the SMTP authentication permission under *Users > Active Users*  and click on *User > Email > Manage Email Apps*."
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:136
+#: ../channels/microsoft365/common-errors.rst:126
 msgid "Shared Inbox"
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:138
+#: ../channels/microsoft365/common-errors.rst:128
 msgid "If it is a shared inbox, you can try to enable the SMTP Authentication (``SmtpClientAuthenticationDisabled``) in the Azure shell. This isn't a Zammad problem, so we can only help to a limited extent here."
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:142
+#: ../channels/microsoft365/common-errors.rst:132
 msgid "To enable the SMTP Authentication, use the following commands:"
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:144
+#: ../channels/microsoft365/common-errors.rst:134
 msgid "If not installed:"
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:150
+#: ../channels/microsoft365/common-errors.rst:140
 msgid "Log in to Exchange using Powershell:"
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:156
+#: ../channels/microsoft365/common-errors.rst:146
 msgid "Switching on the SMTP authentication for a mailbox - also possible with a shared mailbox:"
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:164
+#: ../channels/microsoft365/common-errors.rst:154
 msgid "Retrieval of Email Failed"
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:166
+#: ../channels/microsoft365/common-errors.rst:156
 msgid "**Error message:** Retrieval using the IMAP4 protocol failed for the following message: [...]"
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:169
+#: ../channels/microsoft365/common-errors.rst:159
 msgid "This can be caused by Microsoft Defender for Office 365 when Zammad fetches an email while its attachment is still being checked."
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:172
+#: ../channels/microsoft365/common-errors.rst:162
 msgid "To avoid this, you should change the `Safe Attachments unknown malware response <https://learn.microsoft.com/en-us/defender-office-365/safe-attachments-about?view=o365-worldwide#safe-attachments-policy-settings>`_ from \"Dynamic Delivery\" to something else fitting your needs (e.g. \"Block\") for your Office 365 instance."
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:179
+#: ../channels/microsoft365/common-errors.rst:168
 msgid "Authentication Unsuccessful"
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:181
+#: ../channels/microsoft365/common-errors.rst:170
 msgid "**Error message:** 535 5.7.3 Authentication unsuccessful"
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:183
+#: ../channels/microsoft365/common-errors.rst:172
 msgid "This error message can have different reasons. See description below for one of them."
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:186
+#: ../channels/microsoft365/common-errors.rst:175
 msgid "Microsoft allows sign-in and authentication using the primary email address. While this works for fetching emails, SMTP authentication may not work in this case."
 msgstr ""
 
-#: ../channels/microsoft365/common-errors.rst:190
+#: ../channels/microsoft365/common-errors.rst:179
 msgid "Try to delete the MS account and recreate it using your username. In Zammad, manually change the email address to the username. Then you should be able to send and receive emails again."
 msgstr ""