Gmail 外掛程式

*Gmail 外掛程式*將 Odoo 資料庫與 Gmail 收件匣整合,讓使用者能夠在 Gmail 和 Odoo 之間追蹤所有工作,而不會遺失任何資訊。

重要

請務必在:menuselection:`設定應用程式 –> 一般設定`頁面底部檢查資料庫版本。

對於 19.2 及更高版本的資料庫,請參閱 最新使用說明 以獲取安裝說明。

其他資料

閱讀 Odoo 的 `隱私權政策<https://www.odoo.com/privacy>`_ 和:doc:條款與條件 <../../../../legal>,了解 Odoo 如何處理您的資料。

Odoo 雲端版使用者

對於託管在 Odoo 雲端版(或 Odoo.sh)上的資料庫,請按照以下步驟配置 Gmail 外掛程式。

安裝 Gmail 外掛程式

首先,登入使用者希望連線至 Odoo 的 Gmail 帳戶。

從 Gmail 收件匣,按一下右側面板上的加號圖示以取得附加元件。如果側邊面板不可見,請按一下收件匣右下角的箭頭圖示以顯示它。

Gmail 收件匣側邊面板上的加號圖示。

然後,使用搜尋列搜尋 Odoo 並找到 Odoo Inbox Addin

Google Workspace Marketplace 上的 Odoo Inbox Addin。

或者,直接前往 Google Workspace Marketplace 上的 Odoo Inbox Addin 頁面。

找到外掛程式後,按一下 Install。然後,按一下 Continue 以開始安裝。

接下來,選擇使用者希望連線至 Odoo 的 Gmail 帳戶。然後按一下 Allow 以讓 Odoo 存取 Google 帳戶。Google 接著會顯示一個彈出視窗,確認安裝成功。

配置 Odoo 資料庫

必須在 Odoo 資料庫中啟用 Mail Plugin 功能才能使用 Gmail 外掛程式。若要啟用此功能,請前往 Settings ‣ General Settings。在 Integrations 區段下,啟用 Mail Plugin,然後按一下 Save

設定中的郵件外掛程式功能。

配置 Gmail 收件匣

在 Gmail 收件匣中,右側面板現在可以看到紫色的 Odoo 圖示。按一下 Odoo 圖示以開啟 Odoo 外掛程式視窗。然後,按一下收件匣中的任何電子郵件。在外掛程式視窗中按一下 Authorize Access 以授予 Odoo 存取 Gmail 收件匣的權限。

Odoo 外掛程式面板右側邊欄中的授權存取按鈕。

接下來,按一下 Login。然後,輸入使用者希望連線至 Gmail 收件匣的 Odoo 資料庫網址,並登入資料庫。

備註

使用資料庫的一般網址,而非資料庫中特定頁面的網址。例如,使用 https://mycompany.odoo.com,而非 https://mycompany.odoo.com/web#cids=1&action=menu

最後,按一下 Allow 以讓 Gmail 存取 Odoo 資料庫。瀏覽器接著會顯示 Success! 訊息。之後,關閉視窗。Gmail 收件匣和 Odoo 資料庫現在已連線。

Odoo 離線安裝使用者

對於託管在 Odoo 雲端版(或 Odoo.sh)以外伺服器上的資料庫,請依照以下步驟配置 Gmail 外掛程式。

備註

作為其安全性指南的一部分,Google 要求附加元件建立者提供可用於附加元件啟動的動作和重新導向的網址清單。這可確保例如沒有附加元件將使用者重新導向至惡意網站,從而保護使用者。(在 Google Apps Script 上閱讀更多資訊。)

由於 Odoo 只能列出 odoo.com 網域,而不能列出每個離線安裝客戶的獨特伺服器網域,因此離線安裝客戶無法從 Google Workspace Marketplace 安裝 Gmail 外掛程式。

安裝 Gmail 外掛程式

首先,存取 Odoo 郵件外掛程式的 GitHub 儲存庫。接著,按一下綠色的 Code 按鈕。然後,按一下 Download ZIP 將郵件外掛程式檔案下載到使用者的電腦。

從 Odoo GitHub 儲存庫下載郵件外掛程式的 ZIP 檔案。

在電腦上開啟 ZIP 檔案。然後,前往 mail-client-extensions-master ‣ gmail ‣ src ‣ views,並使用任何文字編輯軟體(例如記事本 (Windows)、TextEdit (Mac) 或 Visual Studio Code)開啟 login.ts 檔案。

login.ts 檔案中刪除以下三行文字:

if (!/^https:\/\/([^\/?]*\.)?odoo\.com(\/|$)/.test(validatedUrl)) {
     return notify("The URL must be a subdomain of odoo.com");
}

這會從 Gmail 外掛程式中移除 odoo.com 網域限制。

接著,在 ZIP 檔案中,前往 mail-client-extensions-master ‣ gmail,並開啟名為 appsscript.json 的檔案。在 urlFetchWhitelist 區段中,將所有對 odoo.com 的參照替換為 Odoo 客戶的獨特伺服器網域。

然後,在同一個 gmail 資料夾中,開啟名為 README.md 的檔案。按照 README.md 檔案中的說明,將 Gmail 外掛程式檔案推送為 Google 專案。

備註

電腦必須能夠執行 Linux 指令,才能按照 README.md 檔案中的說明操作。

之後,將 Google 專案分享給使用者希望連線到 Odoo 的 Gmail 帳戶。然後,按一下 PublishDeploy from manifest。最後,按一下 Install the add-on 來安裝 Gmail 外掛程式。

配置 Odoo 資料庫

必須在 Odoo 資料庫中啟用 Mail Plugin 功能才能使用 Gmail 外掛程式。若要啟用此功能,請前往 Settings ‣ General Settings。在 Integrations 區段下,啟用 Mail Plugin,然後按一下 Save

設定中的郵件外掛程式功能。

配置 Gmail 收件匣

在 Gmail 收件匣中,右側面板現在可以看到紫色的 Odoo 圖示。按一下 Odoo 圖示以開啟 Odoo 外掛程式視窗。然後,按一下收件匣中的任何電子郵件。在外掛程式視窗中按一下 Authorize Access 以授予 Odoo 存取 Gmail 收件匣的權限。

Odoo 外掛程式面板右側邊欄中的授權存取按鈕。

接下來,按一下 Login。然後,輸入使用者希望連線至 Gmail 收件匣的 Odoo 資料庫網址,並登入資料庫。

備註

使用資料庫的一般網址,而非資料庫中特定頁面的網址。例如,使用 https://mycompany.odoo.com,而非 https://mycompany.odoo.com/web#cids=1&action=menu

最後,按一下 Allow 以讓 Gmail 存取 Odoo 資料庫。瀏覽器接著會顯示 Success! 訊息。之後,關閉視窗。Gmail 收件匣和 Odoo 資料庫現在已連線。