Giới thiệu

Zorio là nền tảng Contact Center cho doanh nghiệp gồm:

• PBX: tổng đài SIP/WebRTC, hỗ trợ máy nhánh nội bộ, hàng đợi (queue), IVR, ghi âm, click-to-call.
• Telesales: dialer + chiến dịch + lead + caller-ID rotation + báo cáo + audit log.
• AutoCall TTS: voice bot tự động hoá outbound với DTMF actions + voice library.
• Webphone SDK: SDK WebRTC nhúng webphone vào CRM/ứng dụng riêng của khách hàng.
• Webhook outbound: gửi sự kiện realtime qua HMAC-SHA256 ký chuẩn ngành.

Tài liệu này phục vụ:

Đối tượng	Mục đích sử dụng
Đối tác CRM	Tích hợp Zorio vào CRM riêng (Salesforce, HubSpot, Odoo, custom...)
Đội kỹ thuật doanh nghiệp	Xây ứng dụng riêng quanh hệ thống Zorio đã được cấp
AI agent (Claude Code, Codex, GPT...)	Tự động đọc tài liệu, sinh code tích hợp, debug request
Bất kỳ developer nào	Tham khảo public REST API + SDK của Zorio

Các bước tích hợp điển hình

1. Lấy thông tin truy cập: đăng nhập vào tài khoản Zorio đã được cấp → vào trang Cài đặt → API tokens → tạo token mới.
2. Xác định module cần tích hợp: PBX (cuộc gọi cơ bản), Telesales (dialer), AutoCall (TTS bot), Webphone (giao diện gọi).
3. Đọc tài liệu module tương ứng trong portal này.
4. Gọi thử endpoint bằng cURL/Postman.
5. Cài đặt webhook để nhận sự kiện realtime nếu cần.
6. Triển khai production.

Kiến trúc tích hợp

┌──────────────────────────┐
│ Hệ thống/CRM của bạn     │
└──────────┬───────────────┘
           │
   REST API (Bearer token)  +  Webhook (HMAC-SHA256)  +  Webphone SDK
           │
┌──────────▼───────────────┐
│ app.zorio.vn    │  ← REST API endpoint chính
│  ├─ /api/pbx/...         │
│  ├─ /api/telesales/...   │
│  ├─ /api/autocall/...    │
│  └─ /api/integrations/   │
└──────────┬───────────────┘
           │
┌──────────▼───────────────┐
│ Zorio PBX (SIP/WebRTC)  │
└──────────────────────────┘

Tiếp theo

• Khái niệm cơ bản — Tài khoản khách hàng, tên miền, vai trò, permission tier.
• Lấy API Token — Cấp token từ tài khoản đã được cấp.
• Quy ước chung — Base URL, pagination, error format, timestamp.