ปลั๊กอิน Gmail

ปลั๊กอิน Gmail จะผสานรวมฐานข้อมูล Odoo เข้ากับกล่องจดหมาย Gmail เพื่อให้ผู้ใช้สามารถติดตามงานทั้งหมดระหว่าง Gmail และ Odoo ได้โดยไม่สูญเสียข้อมูลใดๆ

Important

ตรวจสอบให้แน่ใจว่าได้ตรวจสอบเวอร์ชั่นของฐานข้อมูลใน แอปการตั้งค่า ‣ การตั้งค่าทั่วไป ที่ด้านล่างของหน้า

For database versions 19.2 and later, see the latest documentation for installation instructions.

ดูเพิ่มเติม

เรียนรู้ว่า Odoo จัดการข้อมูลของคุณอย่างไรโดยอ่าน นโยบายความเป็นส่วนตัว ของ Odoo และ ข้อกำหนดและเงื่อนไข

ผู้ใช้ Odoo Online

สำหรับฐานข้อมูลที่โฮสต์บน Odoo Online (หรือ Odoo.sh) ให้ทำตามขั้นตอนต่อไปนี้เพื่อกำหนดค่าปลั๊กอิน Gmail

ติดตั้งปลั๊กอิน Gmail

ขั้นแรก ให้เข้าสู่ระบบบัญชี Gmail ที่ผู้ใช้ต้องการเชื่อมต่อกับ Odoo

จากกล่องจดหมาย Gmail ให้คลิกไอคอนเครื่องหมายบวกที่แผงด้านขวาเพื่อรับส่วนเสริม หากแผงด้านข้างไม่ปรากฏ ให้คลิกไอคอนลูกศรที่มุมขวาล่างของกล่องจดหมายเพื่อแสดงส่วนเสริมนั้น

ไอคอนเครื่องหมายบวกบนแผงด้านข้างกล่องจดหมาย Gmail

จากนั้นใช้แถบค้นหาเพื่อค้นหา 'Odoo' และค้นหา Odoo Inbox Addin

Add-in Odoo Inbox บน Google Workspace Marketplace

หรือไปที่หน้า Odoo Inbox Addin โดยตรงบน Google Workspace Marketplace.

เมื่อค้นหาปลั๊กอินได้แล้ว ให้คลิก ติดตั้ง จากนั้นคลิก ดำเนินการต่อ เพื่อเริ่มการติดตั้ง

ขั้นตอนต่อไป ให้เลือกบัญชี Gmail ที่ผู้ใช้ต้องการเชื่อมต่อกับ Odoo จากนั้นคลิก อนุญาต เพื่อให้ Odoo เข้าถึงบัญชี Google ได้ Google จะแสดงหน้าต่างป๊อปอัปเพื่อยืนยันว่าการติดตั้งเสร็จสมบูรณ์

กำหนดค่าฐานข้อมูล Odoo

The Mail Plugin feature must be enabled in the Odoo database in order to use the Gmail Plugin. To enable the feature, go to Settings app ‣ General Settings. Under the Integrations section, activate Mail Plugin, and then click Save.

ฟีเจอร์ปลั๊กอินเมลในการตั้งค่า

กำหนดค่ากล่องจดหมาย Gmail

ในกล่องจดหมาย Gmail ตอนนี้จะมีไอคอน Odoo สีม่วงปรากฏขึ้นที่แผงด้านขวา คลิกที่ไอคอน Odoo เพื่อเปิดหน้าต่างปลั๊กอิน Odoo จากนั้นคลิกที่อีเมลใดๆ ในกล่องจดหมาย คลิก การอนุญาตการเข้าถึง ในหน้าต่างปลั๊กอินเพื่อให้ Odoo สามารถเข้าถึงกล่องจดหมาย Gmail ได้

ปุ่มอนุญาตการเข้าถึงในแถบด้านข้างทางขวาของแผงปลั๊กอิน Odoo

ขั้นตอนต่อไป ให้คลิก เข้าสู่ระบบ จากนั้นป้อน URL ของฐานข้อมูล Odoo ที่ผู้ใช้ต้องการเชื่อมต่อกับกล่องจดหมาย Gmail และเข้าสู่ระบบฐานข้อมูล

Note

ใช้ URL ทั่วไปสำหรับฐานข้อมูล ไม่ใช่ URL ของหน้าเฉพาะในฐานข้อมูล ตัวอย่างเช่น ใช้ https://mycompany.odoo.com, ไม่ใช่ https://mycompany.odoo.com/web#cids=1&action=menu.

สุดท้าย ให้คลิก อนุญาต เพื่อให้ Gmail เข้าถึงฐานข้อมูล Odoo จากนั้นเบราว์เซอร์จะแสดงข้อความ สำเร็จ! จากนั้นให้ปิดหน้าต่าง กล่องจดหมาย Gmail และฐานข้อมูล Odoo เชื่อมต่อกันแล้ว

ผู้ใช้ Odoo On-Premise

สำหรับฐานข้อมูลที่โฮสต์บนเซิร์ฟเวอร์อื่นที่ไม่ใช่ Odoo Online (หรือ Odoo.sh) ให้ปฏิบัติตามขั้นตอนต่อไปนี้เพื่อกำหนดค่าปลั๊กอิน Gmail

Note

Google กำหนดให้ผู้สร้างส่วนเสริมต้องจัดทำรายการ URL ที่สามารถใช้ในการดำเนินการและการเปลี่ยนเส้นทางที่เปิดใช้งานโดยส่วนเสริม ซึ่งถือเป็นแนวทางปฏิบัติด้านความปลอดภัย การทำเช่นนี้จะช่วยปกป้องผู้ใช้โดยรับประกันว่าส่วนเสริมจะไม่เปลี่ยนเส้นทางผู้ใช้ไปยังเว็บไซต์ที่เป็นอันตราย (อ่านเพิ่มเติมเกี่ยวกับ Google Apps Script.)

เนื่องจาก Odoo สามารถแสดงรายการโดเมน odoo.com เท่านั้น และไม่สามารถแสดงรายการโดเมนเซิร์ฟเวอร์เฉพาะของลูกค้าภายในองค์กรแต่ละราย ลูกค้าภายในองค์กรจึงไม่สามารถติดตั้งปลั๊กอิน Gmail จาก Google Workspace Marketplace ได้

ติดตั้งปลั๊กอิน Gmail

ขั้นแรก ให้เข้าถึงคลังข้อมูล GitHub <https://github.com/odoo/mail-client-extensions>`_ สำหรับปลั๊กอินอีเมล Odoo จากนั้น คลิกที่ปุ่มสีเขียว Code จากนั้น คลิก ดาวน์โหลด ZIP เพื่อดาวน์โหลดไฟล์ปลั๊กอินอีเมลลงในคอมพิวเตอร์ของผู้ใช้

ดาวน์โหลดไฟล์ ZIP จากที่เก็บ GitHub ของ Odoo สำหรับปลั๊กอินเมล

เปิดไฟล์ ZIP บนคอมพิวเตอร์ จากนั้นไปที่ mail-client-extensions-master ‣ gmail ‣ src ‣ views และเปิดไฟล์ login.ts โดยใช้ซอฟต์แวร์แก้ไขข้อความ เช่น Notepad (Windows), TextEdit (Mac) หรือ Visual Studio Code

ลบข้อความสามบรรทัดต่อไปนี้ออกจากไฟล์ login.ts:

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

การดำเนินการนี้จะลบข้อจำกัดโดเมน odoo.com ออกจากโปรแกรมปลั๊กอิน Gmail

ขั้นตอนต่อไป ในไฟล์ ZIP ให้ไปที่ mail-client-extensions-master ‣ gmail และเปิดไฟล์ชื่อ appsscript.json ในส่วน urlFetchWhitelist ให้แทนที่การอ้างอิงทั้งหมดไปยัง odoo.com ด้วยโดเมนเซิร์ฟเวอร์เฉพาะของลูกค้า Odoo

จากนั้น ในโฟลเดอร์เดียวกัน gmail ให้เปิดไฟล์ชื่อ README.md ทำตามคำแนะนำในไฟล์ README.md เพื่อพุชไฟล์ปลั๊กอิน Gmail เป็น Google Project

Note

คอมพิวเตอร์จะต้องสามารถรันคำสั่ง Linux ได้ จึงจะปฏิบัติตามคำแนะนำในไฟล์ README.md ได้

หลังจากนั้น แชร์ Google Project กับบัญชี Gmail ที่ผู้ใช้ต้องการเชื่อมต่อกับ Odoo จากนั้น คลิก เผยแพร่ และ ปรับใช้จากรายการ สุดท้าย คลิก ติดตั้งส่วนเสริม เพื่อติดตั้งปลั๊กอิน Gmail

กำหนดค่าฐานข้อมูล Odoo

The Mail Plugin feature must be enabled in the Odoo database in order to use the Gmail Plugin. To enable the feature, go to Settings app ‣ General Settings. Under the Integrations section, activate Mail Plugin, and then click Save.

ฟีเจอร์ปลั๊กอินเมลในการตั้งค่า

กำหนดค่ากล่องจดหมาย Gmail

ในกล่องจดหมาย Gmail ตอนนี้จะมีไอคอน Odoo สีม่วงปรากฏขึ้นที่แผงด้านขวา คลิกที่ไอคอน Odoo เพื่อเปิดหน้าต่างปลั๊กอิน Odoo จากนั้นคลิกที่อีเมลใดๆ ในกล่องจดหมาย คลิก การอนุญาตการเข้าถึง ในหน้าต่างปลั๊กอินเพื่อให้ Odoo สามารถเข้าถึงกล่องจดหมาย Gmail ได้

ปุ่มอนุญาตการเข้าถึงในแถบด้านข้างทางขวาของแผงปลั๊กอิน Odoo

ขั้นตอนต่อไป ให้คลิก เข้าสู่ระบบ จากนั้นป้อน URL ของฐานข้อมูล Odoo ที่ผู้ใช้ต้องการเชื่อมต่อกับกล่องจดหมาย Gmail และเข้าสู่ระบบฐานข้อมูล

Note

ใช้ URL ทั่วไปสำหรับฐานข้อมูล ไม่ใช่ URL ของหน้าเฉพาะในฐานข้อมูล ตัวอย่างเช่น ใช้ https://mycompany.odoo.com, ไม่ใช่ https://mycompany.odoo.com/web#cids=1&action=menu.

สุดท้าย ให้คลิก อนุญาต เพื่อให้ Gmail เข้าถึงฐานข้อมูล Odoo จากนั้นเบราว์เซอร์จะแสดงข้อความ สำเร็จ! จากนั้นให้ปิดหน้าต่าง กล่องจดหมาย Gmail และฐานข้อมูล Odoo เชื่อมต่อกันแล้ว

การแก้ไขปัญหา

The legacy version of the Odoo Inbox Addin might display a generic error message after upgrading the connected database to version 19.0:

Add-on error: Something went wrong while executing add-on. For help, contact the add-on developer.

If standard troubleshooting (reinstalling, clearing cache, upgrading the backend Mail Plugin module) does not resolve the issue, manually refresh the Gmail plugin to sync with the upgraded database:

  1. In the Gmail inbox, click the (Odoo) icon in the side panel to open the Odoo Inbox Addin (Legacy).

  2. Click the (More actions) icon in the top corner of the plugin.

  3. Click Refresh.

This forces the plugin to manually sync its connection with the newly upgraded database version, clearing the stalled script and resolving the execution error.

Refresh button in the Odoo Gmail plugin.