[IMP] Outlook: update setup steps

closes odoo/documentation#15367

Signed-off-by: Felicia Kuan (feku) <feku@odoo.com>
This commit is contained in:
jero-odoo
2025-11-19 08:41:39 -05:00
parent fe49f036e7
commit 75ff3dbe8b
9 changed files with 47 additions and 54 deletions

View File

@@ -16,7 +16,7 @@ The Outlook :doc:`Mail Plugin <../mail_plugins>` needs to be configured both on
Enable Mail Plugin
------------------
First, enable the *Mail Plugin* feature in the database. Go to :menuselection:`Settings --> General
First, enable the *Mail Plugin* module in the database. Go to :menuselection:`Settings --> General
Settings --> Integrations`, enable :guilabel:`Mail Plugin`, and :guilabel:`Save` the configuration.
.. _mail-plugin/outlook/install-plugin:
@@ -29,36 +29,26 @@ later: `https://download.odoocdn.com/plugins/outlook/manifest.xml
<https://download.odoocdn.com/plugins/outlook/manifest.xml>`_.
Next, open the Outlook mailbox, and select any email. After completing this, click on the
:guilabel:`More actions` button in the upper right-side and select :guilabel:`Get Add-ins`.
:guilabel:`Apps` button in the upper right-side, then click :guilabel:`Get add-ins`.
.. image:: outlook/more-actions.png
:align: center
:alt: More actions button in Outlook
.. tip::
For locally installed versions of Microsoft Outlook, access the :guilabel:`Get Add-ins` menu item
while in preview mode (**not** with a message open). First, click on the :guilabel:`...
(ellipsis)` icon in the upper right of the previewed message, then scroll down, and click on
:guilabel:`Get Add-ins`.
:alt: Apps button in Outlook
Following this step, select the :guilabel:`My add-ins` tab on the left-side.
.. image:: outlook/my-add-ins.png
:align: center
:alt: My add-ins in Outlook
Under :guilabel:`Custom add-ins` towards the bottom, click on :guilabel:`+ Add a custom add-in`, and
then on :guilabel:`Add from file...`
Under :guilabel:`Custom Addins` towards the bottom, click on :guilabel:`+ Add a custom add-in`, then
select :guilabel:`Add from file...`
.. image:: outlook/custom-add-ins.png
:align: center
:alt: Custom add-ins in Outlook
For the next step, attach the `manifest.xml` file downloaded above, and press :guilabel:`OK`. Next,
read the warning and click on :guilabel:`Install`.
.. image:: outlook/add-in-warning.png
:align: center
:alt: Custom add-in installation warning in Outlook
.. _mail-plugin/outlook/connect-database:
@@ -67,18 +57,16 @@ Connect the database
--------------------
Now, Outlook will be connected to the Odoo database. First, open any email in the Outlook mailbox,
click on the :guilabel:`More actions` button in the upper right-side, and select :guilabel:`Odoo for
Outlook`.
click on the :guilabel:`Apps` button in the upper right-side, and select :guilabel:`Odoo Inbox
Addin`.
.. image:: outlook/odoo-for-outlook.png
:align: center
:alt: Odoo for Outlook add-in button
The right-side panel can now display **Company Insights**. At the bottom, click on
:guilabel:`Login`.
.. image:: outlook/panel-login.png
:align: center
:alt: Logging in the Odoo database
.. note::
@@ -88,69 +76,74 @@ The right-side panel can now display **Company Insights**. At the bottom, click
.. tip::
If, after a short while, the panel is still empty, it is possible that the browser cookie
settings prevented it from loading. Note that these settings also change if the browser is in
"Incognito" mode.
*Incognito* mode.
To fix this issue, configure the browser to always allow cookies on Odoo's plugin page.
For Google Chrome, change the browser cookie settings by following the guide at:
`https://support.google.com/chrome/answer/95647
<https://support.google.com/chrome/answer/95647>`_
and adding `download.odoo.com` to the list of :guilabel:`Sites that can always use cookies`.
<https://support.google.com/chrome/answer/95647>`_ and adding `download.odoo.com` to the list of
:guilabel:`Sites that can always use cookies`.
Once this is complete, the Outlook panel needs to be opened again.
Now, enter the Odoo database URL and click on :guilabel:`Login`.
.. image:: outlook/enter-database-url.png
:align: center
:alt: Entering the Odoo database URL
Next, click on :guilabel:`Allow` to open the pop-up window.
.. image:: outlook/new-window-warning.png
:align: center
:alt: New window pop-up warning
If the user isn't logged into the database, enter the credentials. Click on :guilabel:`Allow` to let
the Outlook Plugin connect to the database.
.. image:: outlook/odoo-permission.png
:align: center
:alt: Allowing the Outlook Plugin to connect to a database
.. _mail-plugin/outlook/add-shortcut:
Add a shortcut to the plugin
----------------------------
Using the inbox plugin
======================
By default, the Outlook Plugin can be opened from the *More actions* menu. However, to save time,
it's possible to add it next to the other default actions.
To use the plugin, open any email in the Outlook mailbox, click on the :guilabel:`Apps` button in
the upper right-side, and select :guilabel:`Odoo Inbox Addin` to open the panel.
In the Outlook mailbox, click on :guilabel:`Settings`, then on :guilabel:`View all Outlook
settings`.
.. note::
The options available in the panel will vary based on the applications installed in the database.
.. image:: outlook/all-outlook-settings.png
:align: center
:alt: Viewing all Outlook settings
Now, select :guilabel:`Customize actions` under :guilabel:`Mail`, click on :guilabel:`Odoo for
Outlook`, and then :guilabel:`Save`.
.. image:: outlook/customize-actions.png
:align: center
:alt: Odoo for Outlook customized action
Following this step, open any email; the shortcut should be displayed.
.. image:: outlook/odoo-outlook-shortcut.png
:align: center
:alt: Odoo for Outlook customized action
Using the plugin
Create a contact
----------------
Now that the plug-in is installed and operational, all that needs to be done to create a lead is to
click on the `O` [Odoo icon] or navigate to :guilabel:`More actions` and click on :guilabel:`Odoo
for Outlook`. The side panel will appear on the right-side, and under :guilabel:`Opportunities`
click on :guilabel:`New`. A new window with the created opportunity in the Odoo database will
populate.
To create a contact record in Odoo from an email, click the :icon:`fa-plus-circle`
:guilabel:`(circle plus)` icon.
.. note::
A contact record **must** be created before a lead/opportunity can be created.
Create an opportunity
---------------------
To create an opportunity from an email, click the :icon:`fa-plus` :guilabel:`(plus)` icon next to
:guilabel:`Opportunities`. Doing so opens a new opportunity record in Odoo in a new tab. The subject
of the email is used as the opportunity title, and the content of the email is added to the
:guilabel:`Notes` tab of the opportunity.
Create a task
-------------
To create a task from an email, click the :icon:`fa-plus` :guilabel:`(plus)` icon next to
:guilabel:`Tasks`. Then, enter the title of the project where the task should be created in the
resulting field, and select the appropriate project from the resulting list. This opens a new task
record in Odoo in a new tab. The subject of the email is used as the task title, and the content of
the email is added to the :guilabel:`Description` tab.
Create a ticket
---------------
To create a task from an email, click the :icon:`fa-plus` :guilabel:`(plus)` icon next to
:guilabel:`Tickets`. Doing so opens a new ticket record in Odoo in a new tab. The subject of the
email is used as the ticket title, and the content of the email is added to the
:guilabel:`Description` tab of the ticket.

Binary file not shown.

Before

Width:  |  Height:  |  Size: 16 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 6.3 KiB

After

Width:  |  Height:  |  Size: 8.0 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 15 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 7.3 KiB

After

Width:  |  Height:  |  Size: 11 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 2.4 KiB

After

Width:  |  Height:  |  Size: 27 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 1.8 KiB

After

Width:  |  Height:  |  Size: 4.5 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 2.5 KiB

After

Width:  |  Height:  |  Size: 7.8 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 2.7 KiB