Yeastar P-Series Microsoft SQL Integration

🇹🇭 ภาษาไทย

Microsoft SQL Integration ของ Yeastar P-Series ช่วย sync ข้อมูล CDR (Call Detail Records) จาก PBX ไปยัง Microsoft SQL Server database อัตโนมัติ เหมาะสำหรับองค์กรที่ต้องการ custom analytics, reporting, หรือเชื่อมต่อกับ BI tools เช่น Power BI

ข้อกำหนด: Enterprise Plan (EP) หรือ Ultimate Plan (UP)

---

ฟีเจอร์หลัก

ฟีเจอร์	คำอธิบาย
CDR Sync	ส่ง Call Detail Records จาก PBX ไปยัง SQL Server
Scheduled Sync	sync ตามตารางเวลาที่กำหนด
Real-time Push	push CDR ทันทีเมื่อสายสิ้นสุด
Field Mapping	กำหนด mapping ระหว่าง CDR fields และ SQL table columns
Filtered Sync	กรองข้อมูลที่จะ sync ตาม criteria

---

Sync Modes

Mode	คำอธิบาย	เหมาะกับ
Scheduled Sync	sync ตามกำหนด (เช่น ทุกชั่วโมง, ทุกวัน)	Reporting ที่ไม่ต้องการ real-time
Real-time Push	push ทันทีเมื่อ CDR สร้างขึ้น	Live dashboards, alerting systems

---

การตั้งค่า

1. เตรียม SQL Server

-- สร้าง database และ table สำหรับรับ CDR
CREATE TABLE cdr_records (
    call_id         VARCHAR(50),
    caller          VARCHAR(50),
    callee          VARCHAR(50),
    call_type       VARCHAR(20),
    call_status     VARCHAR(20),
    start_time      DATETIME,
    answer_time     DATETIME,
    end_time        DATETIME,
    duration        INT,
    talk_duration   INT,
    trunk           VARCHAR(50),
    recording_file  VARCHAR(255)
);

2. ตั้งค่าบน PBX

PBX Web Portal → Settings > CRM Integration > Microsoft SQL

Parameter	คำอธิบาย
SQL Server	IP หรือ hostname ของ SQL Server
Port	Default: 1433
Database	ชื่อ database
Username	SQL user (ต้องมีสิทธิ์ INSERT)
Password	SQL user password
Table Name	ชื่อ table ที่รับ CDR
Sync Mode	Scheduled หรือ Real-time
Sync Interval	ถ้าเป็น Scheduled: กำหนดความถี่

---

CDR Fields ที่รองรับ

CDR Field	คำอธิบาย	ตัวอย่างค่า
call_id	ID เฉพาะของสาย	2024011512345
caller	หมายเลขผู้โทร	1001, 0812345678
callee	หมายเลขปลายทาง	1002, 0898765432
call_type	ประเภทสาย	Inbound, Outbound, Internal
call_status	ผลสาย	Answered, No Answer, Busy, Failed
start_time	เวลาเริ่มต้นสาย	2024-01-15 09:30:00
answer_time	เวลาที่รับสาย	2024-01-15 09:30:05
end_time	เวลาวางสาย	2024-01-15 09:35:00
duration	ระยะเวลาตั้งแต่โทร (วินาที)	300
talk_duration	ระยะเวลาสนทนาจริง (วินาที)	295
trunk	Trunk ที่ใช้	SIP_Trunk_1
recording_file	path ไฟล์บันทึก	/recordings/2024/...wav
dnis	หมายเลขที่ถูกโทรเข้า (DID)	021234567
extension_group	กลุ่ม extension	Sales, Support

---

Use Cases

กรณีใช้งาน	วิธีใช้ SQL Integration
Power BI / Tableau dashboard	Scheduled sync → connect BI tool ไปที่ SQL DB
Real-time call monitoring screen	Real-time push → query SQL ด้วย live dashboard
Monthly call reports	Scheduled daily sync → run SQL queries
ตรวจสอบ SLA	Query average answer time, missed calls
Billing ตาม call	Export CDR → คำนวณค่าใช้จ่ายตามสาย

---

ความเชื่อมโยง

• Yeastar P-Series — PBX platform หลัก
• Yeastar P-Series API — CDR query ผ่าน REST API (ทางเลือกแทน SQL sync)
• Yeastar P-Series Admin Guide — CDR settings และ Reports
• Yeastar P-Series Call Center — Call Center metrics ที่ต้องการ CDR data

---

🇬🇧 English

Microsoft SQL Integration for Yeastar P-Series automatically syncs CDR (Call Detail Records) from the PBX to a Microsoft SQL Server database. It enables custom analytics, reporting pipelines, and BI tool integration (e.g., Power BI, Tableau).

Requirements: Enterprise Plan (EP) or Ultimate Plan (UP)

---

Sync Modes

Mode	Description	Use Case
Scheduled Sync	Sync at a configured interval (hourly, daily, etc.)	Periodic reporting
Real-time Push	Push CDR record immediately on call completion	Live dashboards, alerting

---

Setup

1. Prepare SQL Server: create database and table with appropriate columns
2. Configure connection: Settings > CRM Integration > Microsoft SQL
   • Server host/port (default: 1433), database name, credentials, table name
3. Select sync mode and interval
4. Map CDR fields to SQL table columns
5. Test connection and save

---

CDR Fields Available

Field	Description
call_id	Unique call identifier
caller / callee	Calling and called numbers
call_type	Inbound / Outbound / Internal
call_status	Answered / No Answer / Busy / Failed
start_time / answer_time / end_time	Call timestamps
duration	Total call duration (seconds)
talk_duration	Actual talk time (seconds)
trunk	SIP/analog trunk used
recording_file	Path to call recording file
dnis	Dialed number (DID/DDI)
extension_group	Extension group name

---

Related Pages

• Yeastar P-Series — Parent PBX platform
• Yeastar P-Series API — CDR query via REST API (alternative to SQL sync)
• Yeastar P-Series Admin Guide — CDR settings and reporting
• Yeastar P-Series Call Center — Call center metrics requiring CDR data