[MERGE] Forward-port of branch 13.0 to 14.0

2021-05-28 17:38:04 +02:00
parent dee28c59a1 4ca0d019c7
commit 1758c674e6
17 changed files with 238 additions and 153 deletions
@@ -17,7 +17,7 @@ Configuration

 Go to :menuselection:`Apps` and install the **VoIP Module**.

-.. image:: media/axivox-voip-installation.png
+.. image:: axivox/voip-installation.png
   :align: center
   :alt: VoIP module installation on an Odoo database

@@ -29,21 +29,28 @@ Go to :menuselection:`Settings --> General Settings --> Integrations`, and fill
 - **WebSocket**: type in ``wss://pabx.axivox.com:3443``
 - **VoIP Environment**: set as *Production*

-.. image:: media/axivox-voip-configuration.png
+.. image:: axivox/voip-configuration.png
   :align: center
   :alt: Integration of Axivox as VoIP provider in an Odoo database

+Configure the VOIP user in the Odoo's user
+------------------------------------------
+
 Go to :menuselection:`Settings --> Users & Companies --> Users`, then open the user's form you want
 to configure. Under the **Preferences** tab, fill out the section **PBX Configuration**:

 - **SIP Login / Browser's Extension**: the Axivox *username*
 - **SIP Password**: the Axivox *SIP Password*

+.. image:: axivox/odoo-user.png
+   :align: center
+   :alt: Integration of Axivox user in the Odoo user preference
+
 .. note::
   You can find all this information by logging in at https://manage.axivox.com/, selecting the user
   you want to configure, and referring to the fields as pictured below.

-   .. image:: media/axivox-manager-sip.png
+   .. image:: axivox/manager-sip.png
      :align: center
      :alt: SIP credentials in the Axivox manager

@@ -57,7 +64,7 @@ You can also receive phone calls. Odoo rings and displays a notification.
 .. note::
   Your number is the one provided by Axivox.

-.. image:: media/axivox-incoming-call.png
+.. image:: axivox/incoming-call.png
   :align: center
   :alt: Incoming VoIP call in Odoo

@@ -65,7 +72,7 @@ You can also receive phone calls. Odoo rings and displays a notification.
   If you see a *Missing Parameter* message in the **Odoo softphone**, refresh your Odoo window and
   try again.

-   .. image:: media/axivox-missing-parameter.png
+   .. image:: axivox/missing-parameter.png
      :align: center
      :alt: "Missing Parameter" error message in the Odoo softphone

@@ -74,6 +81,6 @@ You can also receive phone calls. Odoo rings and displays a notification.
   international format, leading with the plus (+) sign followed by the international country code.
   E.g., +16506913277 (where +1 is the international prefix for the United States).

-   .. image:: media/axivox-incorrect-number.png
+   .. image:: axivox/incorrect-number.png
      :align: center
      :alt: "Incorrect Number" error message in the Odoo softphone
@@ -60,7 +60,8 @@ Then set your email domain name in the General Settings.
 Can I use an Office 365 server
 ------------------------------
 You can use an Office 365 server if you run Odoo on-premise.
-Office 365 SMTP relays are not compatible with Odoo Online.
+Office 365 SMTP relays are not compatible with Odoo Online unless you configure
+Odoo to force the outgoing "From" address (see below).

 Please refer to `Microsoft's documentation <https://support.office.com/en-us/article/How-to-set-up-a-multifunction-device-or-application-to-send-email-using-Office-365-69f58e99-c550-4274-ad18-c805d654b4c4>`__ 
 to configure a SMTP relay for your Odoo's IP address.
@@ -108,6 +109,48 @@ Restriction
 -----------
 Please note that the port 25 is blocked for security reasons. Try using 587, 465 or 2525.

+Choose allowed "From" email addresses
+-------------------------------------
+
+Sometimes, an email's "From" (outgoing) address can belong to a different
+domain, and that can be a problem.
+
+For example, if a customer with address *mary@customer.example.com* responds to
+a message, Odoo will try to redistribute that same email to other subscribers
+in the thread. But if the domain *customer.example.com* forbids that kind of
+usage for security (kudos for that), the Odoo's redistributed email would get
+rejected by some recipients' mail servers.
+
+To avoid those kind of problems, you should make sure all emails use a "From"
+address from your authorized domain.
+
+If your MTA supports `SRS (Sender Rewriting Scheme)
+<https://en.wikipedia.org/wiki/Sender_Rewriting_Scheme>`_, you can enable it
+to handle these situations. However, that is more complex and requires more
+technical knowledge that is not meant to be covered by this documentation.
+
+Instead, you can also configure Odoo to do something similar by itself:
+
+#.  Set your domain name in the General Settings.
+
+    .. image:: media/alias_domain.png
+       :align: center
+
+#.  In developer mode, go to :menuselection:`Settings --> Technical -->
+    Parameters --> System Parameters`.
+
+#.  Add one system parameter from these:
+
+    * If you want *all* your outgoing messages to use the same "From" address,
+      use the key ``mail.force.smtp.from`` and set that address as value
+      (such as ``outgoing@mycompany.example.com``).
+
+    * If you want to keep the original "From" address for emails that use your
+      same domain, but change it for emails that use a different domain, use
+      the key ``mail.dynamic.smtp.from`` and set as value the email address
+      that should be used in those cases (such as
+      ``outgoing@mycompany.example.com``).
+
 .. _discuss/email_servers/inbound_messages:

 How to manage inbound messages