Yeastar Odoo CRM Integration Guide
แหล่งที่มา: raw/odoo-crm-integration-guide-p-series-appliance-edition-en.pdf
เวอร์ชัน: v1.0 — ธันวาคม 2025
ใช้กับ: Yeastar P-Series Appliance Edition (PBX firmware 37.21.0.66+)
ข้อกำหนดระบบ
ฝั่ง Yeastar PBX
| ข้อกำหนด | รายละเอียด |
|---|---|
| Edition | Appliance Edition (on-premises hardware) |
| Plan | Enterprise Plan (EP) หรือ Ultimate Plan (UP) |
| Firmware | Version 37.21.0.66 ขึ้นไป |
| Network | PBX ต้องมี Internet access |
ฝั่ง Odoo
| ข้อกำหนด | รายละเอียด |
|---|---|
| Edition | Odoo Enterprise (ต้องมี module CRM) |
| Hosting | Odoo Online (SaaS) หรือ Self-hosted — ทั้งสองแบบรองรับ |
| Version | Odoo 14.0 ขึ้นไป |
| Account | ต้องเป็น Administrator |
✅ Self-hosted Odoo Enterprise รองรับ — integration ใช้ Odoo API Key ซึ่งไม่ขึ้นกับ hosting model
ฟีเจอร์ที่ได้รับ (5 ฟีเจอร์)
| ฟีเจอร์ | คำอธิบาย |
|---|---|
| Click to Call | คลิกเบอร์โทรในหน้า Odoo CRM → โทรออกผ่าน Linkus Web Client อัตโนมัติ (ต้องใช้ Chrome extension “Yeastar Linkus for Google”) |
| Call Popup | มีสายเข้าจาก contact ใน Odoo → หน้า contact เด้งขึ้นใน browser อัตโนมัติ |
| Call Journal | บันทึก call activity (วัน/เวลา, ชื่อ, ระยะเวลา, ทิศทาง) เข้า Odoo CRM อัตโนมัติเมื่อวางสาย |
| Contact Sync | sync contact จาก Odoo CRM → Yeastar phonebook; ใช้แสดงชื่อผู้โทรเมื่อมีสายเข้า/ออก |
| Lead/Contact Creation | เมื่อมีสายจาก caller ที่ไม่มีในระบบ → สร้าง Odoo Contact หรือ Lead ใหม่อัตโนมัติ (ตั้งค่าได้ว่าจะสร้างประเภทไหน) |
ขั้นตอน Setup ครบถ้วน
Step 1: สร้าง API Key บน Odoo
- Login ไปยัง Odoo ด้วย Administrator account
- คลิก icon account (มุมบนขวา) → Preferences
- ไปที่ tab Account Security
- ในส่วน API Keys → คลิก NEW API KEY
- ใส่ชื่อ description (เช่น
Yeastar PBX Integration) - คลิก GENERATE KEY → คัดลอกและบันทึก key ไว้ (ดูได้ครั้งเดียว ปิดหน้าต่างแล้วดูไม่ได้อีก)
⚠️ API Key ใช้สิทธิ์ของ account ที่สร้าง — ควรใช้ dedicated admin account สำหรับ integration
Step 2: เชื่อมต่อ PBX กับ Odoo CRM
- Login Yeastar PBX Web Portal
- ไปที่ Integrations → CRM → Odoo
- กรอกข้อมูล:
| ฟิลด์ | ตัวอย่าง | หมายเหตุ |
|---|---|---|
| Your Odoo Address | https://odoo.company.com | URL ของ Odoo database (ไม่มี / ท้าย) |
| Database Name | company_prod | ชื่อ database (ตรวจสอบจาก Settings → Activate Developer Mode → ดูใน URL) |
| Administrator Login Name | [email protected] | Email ของ Odoo admin |
| API Key | xxxxxxxxxxxxxxxx | Key จาก Step 1 |
- คลิก Save → รอ status เปลี่ยนเป็น Connected
ถ้า Connection failed: ตรวจสอบ URL (ต้องมี https://), ชื่อ database, และ API Key
Step 3: เชื่อม Odoo Users กับ PBX Extensions
วิธีที่ 1 — Auto Associate (อีเมลใน Odoo = อีเมลใน PBX extension):
- คลิก Associate Automatically
- ยืนยัน → Save
วิธีที่ 2 — Manual Associate (อีเมลต่างกัน):
- ตาราง User Mapping จะแสดง Odoo users ทั้งหมด
- เลือก PBX Extension สำหรับแต่ละ user
- คลิก Confirm → Save
การตั้งค่าฟีเจอร์เพิ่มเติม
Contact Sync
Integrations → CRM → Odoo → Contact Sync tab
| ตัวเลือก | คำอธิบาย |
|---|---|
| Sync Direction | Odoo → PBX เท่านั้น (one-way) |
| Sync Trigger | Manual หรือ Scheduled |
| Contact Scope | ทุก contact หรือ เฉพาะบางกลุ่ม |
Lead/Contact Creation
Integrations → CRM → Odoo → Contact Creation tab
| ตัวเลือก | คำอธิบาย |
|---|---|
| Create Type | สร้างเป็น Lead หรือ Contact |
| Trigger | เมื่อสายเข้าจาก caller ที่ไม่รู้จัก |
| Assigned To | Odoo user ที่รับผิดชอบ record ที่สร้างใหม่ |
Call Popup
Integrations → CRM → Odoo → Call Popup tab
- สามารถเลือกว่าจะ popup เฉพาะ inbound หรือทั้ง inbound+outbound
- popup จะเปิดใน browser ที่ใช้งาน Linkus for Google Chrome extension อยู่
Chrome Extension ที่ต้องติดตั้ง
สำหรับฟีเจอร์ Click to Call และ Call Popup:
“Yeastar Linkus for Google” — Chrome Extension
- ค้นหาใน Chrome Web Store:
Yeastar Linkus for Google - ต้อง login ด้วย Yeastar account ที่ associate กับ Odoo user
Troubleshooting ที่พบบ่อย
| ปัญหา | สาเหตุที่เป็นไปได้ | วิธีแก้ |
|---|---|---|
| Status: Connection Failed | URL ผิด / Database ไม่ตรง / API Key หมดอายุ | ตรวจสอบข้อมูลทั้งหมด; regenerate API Key |
| Click to Call ไม่ทำงาน | Chrome extension ไม่ได้ติดตั้ง / ไม่ได้ login | ติดตั้ง + login Yeastar Linkus for Google |
| Call Popup ไม่ขึ้น | User ไม่ได้ associate กับ extension | ตรวจสอบ User Mapping ใน Step 3 |
| Contact ไม่ sync | Sync ไม่ได้ trigger | Manual sync หรือตั้ง schedule |
| Lead ไม่ถูกสร้าง | Contact Creation feature ไม่ได้เปิด | เปิด feature ใน Contact Creation tab |
Related
- Odoo Yeastar CRM Integration — หน้า entity รวมข้อมูล integration นี้
- Yeastar P-Series CRM Integration — ภาพรวม CRM integrations ทั้งหมดของ Yeastar
- Yeastar P-Series — PBX ที่ใช้ใน integration นี้
- Odoo CRM — Odoo CRM module