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: hệ thống gọi tự động bằng TTS, hỗ trợ DTMF và thư viện giọng đọc.
- 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 thời gian thực, xác thực bằng HMAC-SHA256.
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...) | Đọc tài liệu, hỗ trợ sinh mã tích hợp và phân tích lỗi API. |
| Mọi lập trình viên | Tham khảo public REST API + SDK của Zorio |
Các bước tích hợp điển hình
- 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.
- 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). Đọc tài liệu của module tương ứng trong Portal. Kiểm tra API bằng cURL hoặc Postman. Cấu hình webhook để nhận sự kiện thời gian thực (nếu cần). Triển khai lên môi trường 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ò, cấp quyền (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.