ODS
API ReferenceAPI tổng đàiKhởi tạo cuộc gọi

Khởi tạo cuộc gọi Click-to-Call V2

Khởi tạo cuộc gọi tự động gọi tới khách hàng trước và chuyển tiếp theo Inbound Route.

POSThttps://api.ods.vn/api/CloudFone/AutoCallV2

API thực thi cuộc gọi tự động đảo hướng: Tổng đài quay số gọi đến khách hàng trước. Khi khách hàng nhấc máy, tổng đài mới chuyển tiếp cuộc gọi vào hướng đích định tuyến trước (Inbound Route hoặc IVR/Hàng đợi) đã thiết lập trên tổng đài.

Cách thức hoạt động

Cuộc gọi được tổng đài điều phối qua 2 chặng liên tiếp:

Sơ đồ tuần tự Click-to-Call V2 (Đảo hướng gọi khách trước)
CRM / ERPKhởi tạo lệnh gọiTổng đài ODSĐiều phối viễn thôngKhách hàngNhận cuộc gọi trướcInbound RouteIVR / Hàng đợi Ext1POST /api/CloudFone/AutoCallV22200 OK { result: "success", keySearch }⚡ Bất đồng bộ: Nhận lệnh ngay, chưa gọi aiChặng 1: Gọi số khách hàng trước3Quay số gọi khách (PhoneNumber)4Khách hàng nhấc máy (Answered)Chặng 2: Chuyển tiếp Inbound Route5Định tuyến vào Inbound Route / IVR (Ext)6Nhân viên trực / IVR tiếp nhận7Nối thoại đàm thoạiKhách hàng ⟷ Hàng đợi / IVR
1. Đảo chiều gọi khách trước

Khác với V1, V2 gọi tới số khách hàng trước. Khách hàng bắt máy thì cuộc gọi mới được chuyển tiếp vào tổng đài.

2. Tham số Ext là Route

Trường Ext trong V2 không phải số máy nhánh cá nhân, mà là tên Inbound Route đã cấu hình.

3. Cú pháp PhoneNumber

Phải truyền theo định dạng <Tên_Trunk>/<Số_khách> để chỉ định đầu số gọi ra.

Điểm khác biệt quan trọng so với Click-to-Call V1: Ở V2, tổng đài gọi khách hàng trước. Do đó tham số Ext không phải số máy nhánh cá nhân mà là tên Inbound Route (ví dụ: C2C-WebSite) trỏ vào hàng đợi hoặc kịch bản chào mừng tự động.

Tham số request

Tham sốKiểu dữ liệuBắt buộcMô tả chi tiết
ServiceNamestringCóMã dịch vụ tổng đài khi mua tại ODS (ví dụ: CF-BS0XXXX).
AuthUserstringCóMã tài khoản khách hàng (ví dụ: ODSXXXX).
AuthKeystringCóKhóa bí mật API do ODS cấp.
ExtstringCóTên Inbound Route đã cấu hình trên trang quản trị tổng đài (ví dụ: C2C-WebSite).
PhoneNumberstringCóĐịnh dạng <Tên_đầu_số_hoặc_Trunk>/<Số_điện_thoại_khách> (ví dụ: 02873007788/0900000000).
KeySearchstringKhôngMã định danh cuộc gọi (khuyến nghị GUID). Nếu không truyền, hệ thống sẽ tự sinh ngẫu nhiên.

Cấu trúc phản hồi

TrườngKiểu dữ liệuMô tả
resultstringTrạng thái thực thi (success hoặc failed).
messagestringThông báo kết quả từ tổng đài.
keySearchstringMã định danh cuộc gọi trả về.

Lưu ý quan trọng

  • Tham số Ext ở endpoint này là Tên Inbound Route đã được tạo sẵn trên Portal ODS, không phải số máy nhánh thông thường.
  • Định dạng PhoneNumber bắt buộc phải có dấu gạch chéo / phân tách giữa đầu số gọi ra và số điện thoại người nhận.

Lỗi thường gặp

Bài viết liên quan

Click-to-Call V1

Khởi tạo cuộc gọi gọi về máy nhánh nhân viên trước.

Lịch sử cuộc gọi

Tra cứu kết quả cuộc gọi sau khi kết thúc.

Khởi tạo cuộc gọi Click-to-Call

Thực hiện cuộc gọi từ phần mềm (CRM, ERP) đến khách hàng thông qua máy nhánh nhân viên với API AutoCall.

Thêm và cập nhật danh bạ

Thêm mới hoặc cập nhật liên hệ trong danh bạ tổng đài AI Contact Center.