Differences

This shows you the differences between two versions of the page.

--- leon:mailboxes [2020/11/06 14:46]
bartek
+++ leon:mailboxes [2023/10/11 06:05] (current)
bartek
@@ Line 1: / Line 1: @@
 ====== Mailboxes ======
-A panel **Mailboxes** is dedicated to setting up mailbox configuration. Emails sent out from/to **Requests/Quotes** section can be found in folders of the defined email account.
+The reason behind adding this new functionality was to have access to all emails sent out from/to Sales Panel Message of the section 'Requests/Quotes', in folders of the user's email mailbox (Inbox/Outbox). Now it is also possible to use this feature in OPS, while using Multi-leg Requests module and sending other OPS requests (it doesn't apply to Handling Requests).
-**SETTING UP**
+===== Setting up =====
 {{:leon:settings:icon.png?nolink|}}
-In a section **Settings** enter the panel 'Mailboxes' and click {{:leon:settings:add template icon.png?nolink|}} at the bottom - a new window will show for Mailbox configuration, which needs to be filed in with details, such as:
+In a section **Settings**, we have added a new panel **Mailboxes**. Enter this panel and click {{:leon:settings:add mailbox icon.png?nolink|}} at the bottom of the page - a new window will show up for 'Mailbox' configuration, which needs to be filed in with details, such as:
-  * **Mailbox name**
+  * **Mailbox name** - it's simply a name of the mailbox, by which you will identify that in the system
-  * **E-mail**
+  * **E-mail** - the address of the mailbox
-  * **SMTP configuration** - SMTP host, SMTP port, Username, Password & Protocol.
+  * **Authorization** - allows to select authorization method: Basic, Google Workspace, Office365 or Office365 Shared
-  * **IMAP configuration** - same details as for SMTP configuration.
+  * **Keep copies of messages on Leon servers** - option to store copies of messages on Leon servers. The message in tab 'Messages' has to be read (opened) and once it is, Leon uploads it to the servers. This way, the message doesn't disappear from Leon when it is deleted from the inbox
+  * **Use IMAP** - this will allow including (checkbox ticked) or excluding (unticked) the IMAP from the mailbox settings. If the IMAP is excluded, Leon will still send the messages, however, the reply will not be visible in Leon
+  * **Send emails carbon copy (CC) to this mailbox** - this feature allows you to send the copies of the messages to the mailbox itself, as a CC, so you can have them in your mailbox even if you don't use IMAP synchronization
+  * **Suspended** - the mailbox can be suspended automatically in case of connection error between Leon and the mailbox servers. One of the possible reasons can be incorrect configuration, change of credentials, etc. If the mailbox is suspended, please verify the settings, untick the "suspended" checkbox, load folders and save the configuration
+==== Basic authorization ====
+[{{ :leon:settings:mailboxes:mailbox_conf_basic.png?nolink&400|Basic authorization mailbox configuration window}}]
+To use basic authorization method enter SMTP and IMAP details.
+  * **SMTP configuration** - SMTP host, SMTP port, Username, Password & Protocol. This setting is required to allow Leon sending messages using your email address
+  * **IMAP configuration** - same as above, however, IMAP is not required unless you want to have your inbox (replies to your messages sent from Leon) to be visible in Leon as well
-{{:leon:settings:mailbox config.png?nolink|}}
+=== Gmail with 2-Step Verification ===
-Before saving Mailbox settings, loading folders must be done - click {{:leon:settings:load folders.png?nolink|}} icon and Leon will show a drop-down box **Outbox**, where all folders of the pre-defined email account will show and **1** outbox folder must be selected. In the **Inbox** field, it's possible to select more than **1** inbox folder. It is also possible to include 'Subfolders' into the configuration - Leon then will search for emails ot only in folders but also in inbox subfolders.
+If you have 2-Step Verification enabled on your Gmail account, please use [[https://support.google.com/accounts/answer/185833?hl=en&ref_topic=7189145|App Password]] to configure your mailbox in Leon, or use Google Workspace method.
-{{:leon:settings:inbox-outbox.png?nolink|}}
+=== Office 365 ===
+If you use Office 365, it is recommended to authorize using Office 365 method. If you want to use Basic Authorization and you are unable to configure the mailbox in Leon this way, please use contact your Office 365 administrator to confirm that [[https://docs.microsoft.com/en-us/exchange/clients-and-mobile-in-exchange-online/disable-basic-authentication-in-exchange-online|Basic Authentication]] and [[https://docs.microsoft.com/en-us/exchange/clients-and-mobile-in-exchange-online/authenticated-client-smtp-submission|SMTP AUTH]] are **enabled**.
-If an email 'Reply to' defined in 'Email Templates' (in the below example it is email template 'Sales Panel Message') is **the same** as the one defined in 'Mailboxes' panel, emails will also show in pre-defined email mailbox.
+If you use two-step verification with Office 365, you will also need the [[https://support.microsoft.com/en-gb/account-billing/manage-app-passwords-for-two-step-verification-d6dc8c6d-4bf7-4851-ad95-6d07799387e9|App Password]] to configure your mailbox in Leon.
-{{:leon:settings:email example.png?nolink|}}
+=== Office 365 Shared Mailboxes ===
+[{{ :leon:settings:mailboxes:mailbox_conf_office365-shared.png?nolink&400|Office 365 Shared mailbox configuration window}}]
+If you use Office 365 shared mailbox, it is recommended to use Office 365 Shared method. For basic authorization, the username is a combination of your username and shared mailbox alias. For example:
+Your username: ''personal@testaddress.aero''
+Shared mailbox alias: ''shared''
+Shared mailbox username: ''personal@testaddress.aero\shared'' or ''personal@testaddress.aero\shared@testaddress.aero''
+==== Google Workspace / Office 365 ====
+In this method, after clicking {{:leon:settings:mailboxes:authorize_button.png?nolink|}} button, you will be redirected to Google Workspace or Office 365 (depending on the method selected), where you can log in to the e-mail selected and authorize Leon to access your mailbox.
+==== Office 365 Shared ====
+In this method, in the **Authorization E-mail** text box you need to enter a-mail address which is used to access the shared mailbox. After clicking {{:leon:settings:mailboxes:authorize_button.png?nolink|}} button, you will be redirected to Google Workspace, where you can authorize Leon to access your shared mailbox.
+===== Sending an e-mail using a mailbox =====
+If an email address added to a field **Reply to** defined in **Email Templates** is the same as the one defined in **Mailboxes** panel, emails will be sent using that mailbox.
+{{:leon:settings:email example.png?nolink|}}

Leonsoftware Wiki

User Tools

Site Tools

Differences

Page Tools