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.
https://api.ods.vn/api/CloudFone/AutoCallAPI này dùng để làm tính năng "Bấm để gọi" (Click-to-Call) trên phần mềm CRM, ERP hoặc website: Nhân viên bấm nút "Gọi" trên màn hình, tổng đài sẽ tự động kết nối máy nhánh của nhân viên với số điện thoại của khách hàng mà không cần bấm số thủ công.
Cách thức hoạt động
Cuộc gọi được tổng đài điều phối tự động qua 2 chặng liên tiếp:
API phản hồi 200 OK để báo nhận lệnh thành công, không đồng nghĩa khách đã nghe máy.
Tổng đài gọi máy nhánh nhân viên trước. Nhân viên bắt máy thì tổng đài mới quay số gọi khách hàng.
Trạng thái nghe máy, thời lượng thoại và file ghi âm sẽ được gửi về qua Webhook hoặc tra cứu theo KeySearch.
Máy nhánh nhân viên (Ext) bắt buộc phải đang đăng ký online trên IP Phone, Softphone hoặc Webphone để nhận chuông ở chặng 1. Nếu bạn cần tổng đài gọi khách hàng trước rồi mới chuyển tiếp vào nhóm trực hoặc kịch bản IVR, hãy sử dụng Click-to-Call V2.
Tham số request
| Tham số | Kiểu dữ liệu | Bắt buộc | Mặc định | Mô tả chi tiết |
|---|---|---|---|---|
ServiceName | string | Có | — | Mã dịch vụ tổng đài khi mua tại ODS (ví dụ: CF-BS00XXXXX). |
AuthUser | string | Có | — | Mã tài khoản khách hàng khi mua tổng đài (ví dụ: CF000XXX). |
AuthKey | string | Có | — | Khóa bí mật API do ODS cấp (chỉ gọi từ backend, không để lộ ở client). |
Ext | string | Có | — | Số máy nhánh của nhân viên nhận cuộc gọi (ví dụ: 101, 9119). |
PhoneNumber | string | Có | — | Số điện thoại của khách hàng cần gọi đến (ví dụ: 0900000000). |
Prefix | string | Không | "0" | Tiền tố gọi ra theo cấu hình tổng đài (thường giữ mặc định "0"). |
PhoneName | string | Không | "" | Tên khách hàng hiển thị trên máy nhánh khi chuông reo (để trống sẽ hiện "tongdaitudong"). |
KeySearch | string | Không | "" | Mã tham chiếu tự đặt (khuyến nghị UUID) để đối chiếu lịch sử cuộc gọi sau này. |
Cấu trúc và ý nghĩa phản hồi
| Trường | Kiểu dữ liệu | Mô tả chi tiết |
|---|---|---|
result | string | Trạng thái xử lý lệnh: "success" hoặc "failed". |
message | string | Thông báo phản hồi từ hệ thống tổng đài. |
keySearch | string | Mã định danh cuộc gọi trả về (dùng tra cứu CDR hoặc nhận webhook). |
Ý nghĩa của result: "success": Chỉ xác nhận tổng đài đã tiếp nhận lệnh và bắt đầu đổ chuông máy nhánh nhân viên. Để biết khách hàng có nhấc máy hay không (ANSWERED), xem qua Webhook Popup hoặc Lịch sử cuộc gọi.
Xử lý sự cố thường gặp
Kiểm tra số máy nhánh Ext có đang đăng nhập/online trên phần mềm Softphone hoặc điện thoại bàn IP Phone hay không, hoặc thiết bị có đang bật chế độ DND (Không làm phiền) không.
Kiểm tra định dạng số điện thoại PhoneNumber có hợp lệ không, tiền tố Prefix (thường là "0"), và kiểm tra đầu số tổng đài có còn hoạt động hay bị chặn chiều gọi ra không.
Không nên tự động gửi lại request ngay. Nếu tổng đài đang xử lý, việc gọi lại sẽ gây ra cuộc gọi trùng lặp (khách hàng bị reo chuông 2 lần). Hãy kiểm tra điện thoại nhân viên có reo hay không trước khi bấm gọi lại.
Bài viết liên quan
Click-to-Call V2
Khởi tạo cuộc gọi gọi khách hàng trước theo Inbound Route.
Webhook Popup
Nhận sự kiện cuộc gọi thời gian thực (đổ chuông, nghe máy, cúp máy).
Lịch sử cuộc gọi (GetCallLogs)
Tra cứu cước gọi, thời lượng đàm thoại và file ghi âm.
Xác thực API
Tìm hiểu cách lấy thông tin ServiceName, AuthUser, AuthKey.