Yeastar P-Series CRM Integration
🇹🇭 ภาษาไทย
ภาพรวม
Yeastar P-Series รองรับการ integrate กับ CRM หลายระบบ — ช่วยให้ผู้ใช้งานสามารถรับ/โทรสาย, ดูข้อมูลลูกค้า, บันทึกประวัติการโทร และ sync ผู้ติดต่อได้ทั้งหมดโดยไม่ต้องออกจาก CRM interface
ข้อกำหนดทั่วไป: Enterprise Plan (EP) หรือ Ultimate Plan (UP)
CRM ที่รองรับ:
| CRM | Firmware ขั้นต่ำ | ประเภท |
|---|---|---|
| Custom CRM (ผ่าน REST API) | 37.18.0.102+ | สร้าง template เอง |
| Microsoft Dynamics 365 | 37.19.0.22+ | Built-in integration |
| Google Workspace | 37.19.0.22+ | User Sync + SSO |
| Odoo CRM | 37.21.0.66+ | Built-in integration |
ฟีเจอร์หลักที่ได้หลัง integrate CRM
| ฟีเจอร์ | รายละเอียด |
|---|---|
| Click to Call | คลิกหมายเลขใน CRM → โทรออกผ่าน Linkus Web Client ทันที (ต้องติดตั้ง Yeastar Linkus for Google Chrome extension) |
| Call Popup | เมื่อรับ/โทรไปหา CRM contact → browser เปิด profile contact อัตโนมัติ |
| Contact Synchronization | Sync ผู้ติดต่อจาก CRM ไปยัง PBX phonebook เมื่อมีสายเข้า/ออก |
| Lead/Contact Creation | สร้าง lead หรือ contact ใหม่ใน CRM อัตโนมัติสำหรับหมายเลขที่ไม่รู้จัก |
| Call Journal | บันทึก call activity ลงใน CRM อัตโนมัติเมื่อจบสาย |
| Recording Playback | เล่น call recording ที่เก็บใน PBX ได้จากหน้า CRM โดยตรง |
1. Custom CRM Integration
เชื่อม Yeastar P-Series กับ CRM ใดก็ได้ที่รองรับ REST API โดยสร้าง template เอง
ข้อกำหนด:
- Firmware: 37.18.0.102+ (template creation: 37.20.0.19+)
- Plan: Enterprise/Ultimate
- CRM ต้องรองรับ REST API
ขีดจำกัด: สร้าง template ได้สูงสุด 10 templates
Authentication Methods ที่รองรับ
| วิธี | ใช้เมื่อ |
|---|---|
| None | ไม่ต้อง auth หรือใช้ API key ใน request |
| Basic | Username + Password แบบ HTTP Basic Auth |
| OAuth2 | OAuth 2.0 flow |
| Bearer Token | JWT หรือ access token |
API Request ที่กำหนดใน Template
| Request | จำเป็น | ทำอะไร |
|---|---|---|
| Search Contacts | ต้องมี | ค้นหา contact ใน CRM ตาม criteria |
| Get Users | ไม่บังคับ | ดึง CRM users เพื่อ associate กับ extension |
| Create Contacts | ไม่บังคับ | สร้าง contact/lead ใหม่ |
| Call Journalling | ไม่บังคับ | บันทึก call log |
การกำหนด Field Mapping
- ใช้ GJSON Path Syntax สำหรับ map ค่าจาก JSON response ของ CRM
- ตัวอย่าง path:
users.#.id,data.#(key=="value").field - PBX fields ที่ map: User Unique ID, First Name, Last Name, Email
Template Format
- Template ถูก export/import เป็น XML
- Template สามารถ clone หรือ import จากไฟล์ได้
- Path: PBX web portal → Integrations → CRM → Custom
2. Microsoft Dynamics 365 Integration
ฝัง Linkus client ลงใน Dynamics 365 CRM โดยตรง — ผู้ใช้ไม่ต้องสลับแอปเลย
ข้อกำหนด:
- Firmware: 37.19.0.22+
- Plan: Enterprise/Ultimate
- PBX: เข้าถึงได้จากภายนอกผ่าน domain name (FQDN หรือ domain)
- Microsoft 365: สมัคร subscription อย่างน้อย Business Basic
- Microsoft Dynamics 365 Sales
Browser ที่แนะนำ: Microsoft Edge, Google Chrome, Opera
ขั้นตอน Admin Setup
- เพิ่ม Yeastar P-Series PBX เป็น channel provider ใน Dynamics 365 ผ่าน Channel Integration Framework (CIF)
- สร้าง plugin ชื่อ “Linkus for Dynamics 365” ฝังใน CRM interface
- Assign Channel Access permission ให้ Microsoft accounts ของผู้ใช้ที่เกี่ยวข้อง
ขั้นตอน User Setup (หลัง admin ตั้งค่า)
- Login ด้วย Linkus credentials ภายใน Dynamics 365 CRM
- กำหนดค่า:
- Number Matching (เชื่อม phone number รูปแบบต่างๆ)
- Contact Creation (auto หรือ manual)
- Call Popup (auto หรือ manual)
- Phone Call Activity Creation (บันทึก call log)
- Call Recording Playback
- Auto Launch plugin
ฟีเจอร์เพิ่มเติมสำหรับ Dynamics 365
- Phone Call Activity Logging — log call พร้อม context ไปที่ Dynamics 365 record โดยตรง
- Call Flip — สลับสายระหว่าง devices ระหว่าง call ได้จาก plugin
3. Google Workspace Integration
Sync user accounts จาก Google Workspace มายัง PBX และเปิดใช้ Google SSO สำหรับ Linkus
ข้อกำหนด:
- Firmware: 37.19.0.22+
- Plan: Enterprise/Ultimate
- Google Workspace: Business หรือ Enterprise edition
- PBX Network: Yeastar FQDN หรือ Public IP (NAT)
- SSO ต้องใช้ FQDN/Domain เท่านั้น — ใช้ IP address ไม่ได้ (Google ไม่อนุญาต redirect URI เป็น IP)
ฟีเจอร์หลัก
| ฟีเจอร์ | รายละเอียด |
|---|---|
| User Sync (One-way) | Google Workspace → PBX (ไม่ใช่ทิศทางกลับ) |
| Auto Create Extensions | สร้าง extension อัตโนมัติสำหรับ Google users ที่ sync มา |
| Single Sign-on (SSO) | Login Linkus UC Client ด้วย Google account |
ขั้นตอนการ Setup
ฝั่ง Google (ทำโดย Super Admin):
- สร้าง Google Cloud Project สำหรับ integration
- Enable Admin SDK API
- Configure OAuth consent screen
- สร้าง Web Application credentials → ได้ Client ID + Client Secret
ฝั่ง PBX:
- กรอก Client ID, Client Secret จาก Google
- Path: Integrations → Collaboration → Google SSO
การจัดการ Sync
- ตั้ง schedule auto-sync ได้
- Sync แบบ manual ได้ทันที
- หยุด sync ชั่วคราว (Pause) หรือ disconnect integration ได้
4. Odoo CRM Integration
ข้อกำหนด:
- Firmware: 37.21.0.66+
- Plan: Enterprise/Ultimate
- Odoo: Online hosting, Enterprise edition, Version 14.0+
ฟีเจอร์ที่รองรับ
- Click to Call (ต้องมี Linkus for Google Chrome extension)
- Call Popup
- Call Journal (บันทึก activity ลง Odoo อัตโนมัติ)
- Contact Synchronization
- Contact/Lead Creation (อัตโนมัติหรือ manual)
ขั้นตอนหลัก
- Integrate Yeastar PBX กับ Odoo CRM
- ตั้งค่า Contact Synchronization
- ตั้งค่า Lead/Contact Creation
- ตั้งค่า Call Popup
- ตั้งค่า Call Journal
เปรียบเทียบ CRM Integrations
| ฟีเจอร์ | Custom CRM | Dynamics 365 | Google Workspace | Odoo |
|---|---|---|---|---|
| Click to Call | ✅ | ✅ | ❌ | ✅ |
| Call Popup | ✅ | ✅ | ❌ | ✅ |
| Contact Sync | ✅* | ✅ | User Sync | ✅ |
| Lead/Contact Creation | ✅* | ✅ | ❌ | ✅ |
| Call Journal | ✅* | ✅ (Phone Call Activity) | ❌ | ✅ |
| Recording Playback | ✅* | ✅ | ❌ | ❌ |
| SSO | ❌ | ❌ | ✅ | ❌ |
| Embedded Plugin | ❌ | ✅ (CIF plugin) | ❌ | ❌ |
| Min. Firmware | 37.18.0.102 | 37.19.0.22 | 37.19.0.22 | 37.21.0.66 |
*ขึ้นอยู่กับ template configuration และ CRM capabilities
ความเชื่อมโยง
- Yeastar P-Series — parent PBX system
- Yeastar P-Series Admin Guide — Integrations menu setup
- Yeastar P-Series API — PBX API ที่ CRM integration ใช้ภายใน
- Yeastar P-Series Call Flow Designer — HTTP Request component สามารถ call CRM API โดยตรงระหว่าง call flow
🇬🇧 English
Overview
Yeastar P-Series supports integration with multiple CRM systems, enabling users to make/receive calls, view contact profiles, log call activities, and sync contacts — all without leaving the CRM interface.
Requirement: Enterprise Plan (EP) or Ultimate Plan (UP)
| CRM | Min. Firmware | Type |
|---|---|---|
| Custom CRM (via REST API) | 37.18.0.102+ | Template-based |
| Microsoft Dynamics 365 | 37.19.0.22+ | Built-in |
| Google Workspace | 37.19.0.22+ | User Sync + SSO |
| Odoo CRM | 37.21.0.66+ | Built-in |
Common CRM Features
| Feature | Description |
|---|---|
| Click to Call | Click any phone number in CRM to dial via Linkus Web Client (requires Yeastar Linkus for Google Chrome extension) |
| Call Popup | Automatically opens contact profile when receiving/answering/ending a call with a CRM contact |
| Contact Synchronization | Sync CRM contacts to PBX phonebook on call events |
| Lead/Contact Creation | Auto-create lead or contact in CRM for unknown callers |
| Call Journal | Automatically log call activities to CRM when call ends |
| Recording Playback | Play PBX call recordings directly from CRM call log |
1. Custom CRM Integration
Connect Yeastar P-Series to any CRM that supports REST API by building a custom integration template.
Requirements: Firmware 37.18.0.102+ (template creation: 37.20.0.19+); Enterprise/Ultimate Plan; CRM must support REST API
Limit: Up to 10 custom templates
Authentication methods: None, Basic, OAuth2, Bearer Token
Template API requests:
- Search Contacts (required) — find contacts in CRM
- Get Users (optional) — retrieve CRM users to associate with extensions
- Create Contacts (optional) — create leads/contacts for unknown callers
- Call Journalling (optional) — log call records to CRM
Field mapping: Uses GJSON Path Syntax to map CRM JSON response fields to PBX fields (User Unique ID, First Name, Last Name, Email)
Template format: XML; can be exported, imported, and cloned
2. Microsoft Dynamics 365 Integration
Embeds a Linkus plugin directly inside Dynamics 365 CRM via Channel Integration Framework (CIF).
Requirements:
- Firmware 37.19.0.22+; Enterprise/Ultimate Plan
- PBX accessible via domain name (FQDN or custom domain)
- Microsoft 365 subscription (Business Basic or higher)
- Microsoft Dynamics 365 Sales
Admin setup:
- Add Yeastar PBX as a channel provider in Dynamics 365 via CIF — creates the “Linkus for Dynamics 365” embedded plugin
- Assign Channel Access permission to relevant Microsoft user accounts
Per-user setup: Login via Linkus credentials inside Dynamics 365 → configure Number Matching, Contact Creation, Call Popup, Phone Call Activity Creation, Recording Playback, Auto Launch
Additional features: Phone Call Activity Logging (logs calls with CRM context), Call Flip (transfer active call between devices)
3. Google Workspace Integration
One-way user synchronization from Google Workspace to PBX with optional Google SSO for Linkus.
Requirements:
- Firmware 37.19.0.22+; Enterprise/Ultimate Plan
- Google Workspace Business or Enterprise edition
- PBX with Yeastar FQDN or Public IP (NAT)
- SSO requires FQDN/Domain — IP address cannot be used as Google SSO redirect URI
Features:
| Feature | Description |
|---|---|
| User Sync (one-way) | Google Workspace → PBX; updates in Google auto-sync to PBX |
| Auto Create Extensions | Extensions automatically created for synced Google users |
| SSO | Users log into Linkus UC Clients with Google credentials |
Setup steps:
- Google side (super admin): Create Cloud Project → Enable Admin SDK API → Configure OAuth consent → Create web app credentials → Obtain Client ID + Client Secret
- PBX side: Enter Client ID + Client Secret at Integrations → Collaboration → Google SSO
Sync management: Schedule automatic sync, trigger manual sync, pause, or disconnect integration
4. Odoo CRM Integration
Requirements:
- Firmware 37.21.0.66+; Enterprise/Ultimate Plan
- Odoo Online hosting, Enterprise edition, version 14.0+
Features: Click to Call, Call Popup, Call Journal, Contact Synchronization, Contact/Lead Creation (auto or manual)
CRM Feature Comparison
| Feature | Custom | Dynamics 365 | Google Workspace | Odoo |
|---|---|---|---|---|
| Click to Call | ✅* | ✅ | ❌ | ✅ |
| Call Popup | ✅* | ✅ | ❌ | ✅ |
| Contact Sync | ✅* | ✅ | User sync only | ✅ |
| Lead/Contact Creation | ✅* | ✅ | ❌ | ✅ |
| Call Journal | ✅* | ✅ | ❌ | ✅ |
| Recording Playback | ✅* | ✅ | ❌ | ❌ |
| SSO | ❌ | ❌ | ✅ | ❌ |
| Embedded Plugin | ❌ | ✅ (CIF) | ❌ | ❌ |
| Min. Firmware | 37.18.0.102 | 37.19.0.22 | 37.19.0.22 | 37.21.0.66 |
*Depends on template configuration and CRM capabilities
Related Pages
- Yeastar P-Series — Parent PBX system
- Yeastar P-Series Admin Guide — Integrations menu configuration
- Yeastar P-Series API — Underlying PBX API used by CRM integrations
- Yeastar P-Series Call Flow Designer — HTTP Request component can call CRM APIs during call flow