Tích hợp Alohub Softphone × Zoho CRM

Hướng dẫn cài đặt và sử dụng extension Alohub Softphone trên Zoho CRM: gọi từ số điện thoại và gắn cuộc gọi vào đúng Lead/Deal/Contact/Account.

Tổng quan

Mục	Giá trị
Host	`crm.zoho.com`, `.eu`, `.in`, `.com.au`, `.jp`, `crmplus.zoho.com`
Module	`Leads`, `Contacts`, `Potentials` (Deals), `Accounts`
Gắn cuộc gọi	Map module → `Who_Id` / `What_Id` / `$se_module`

Lưu ý: Zoho không tự liên kết Lead ↔ Contact. Đứng ở bản ghi nào thì cuộc gọi gắn đúng bản ghi đó.

Điều kiện

Tài khoản Alohub provider là Zoho, đã kết nối OAuth đúng data center (.com/.eu/.in/...).
Quyền tạo bản ghi Calls trong Zoho.

Cài đặt

Cài extension, mở Zoho CRM theo đúng DC của bạn.
Mở side panel, đăng nhập. Badge provider hiển thị Zoho.

Sử dụng — Gọi từ số điện thoại

Chip "Gọi" xuất hiện cạnh số điện thoại ở chi tiết bản ghi và danh sách. Với widget zpb-phone của Zoho, extension ẩn icon gọi mặc định và đặt chip Alohub ngay cạnh — chip này mang sẵn context bản ghi nên gắn cuộc gọi chính xác nhất.

Log cuộc gọi gắn đúng bản ghi

Extension đọc URL dạng .../tab/<Module>/<id>:

Context module	Trường Zoho Calls
`Contacts`	`Who_Id = recordId`
`Leads`	`Who_Id = recordId`, `$se_module = "Leads"`
`Potentials` / Deals	`What_Id = recordId`, `$se_module = "Deals"`
`Accounts`	`What_Id = recordId`, `$se_module = "Accounts"`
(không có context)	fallback: tìm Contact theo số điện thoại

Xử lý sự cố

Hiện tượng	Cách xử lý
Thấy cả icon Zoho lẫn chip Alohub	Reload; extension ẩn `zpb-phone` qua CSS — nếu vẫn còn, báo dev
Gắn nhầm Contact thay vì Lead	Kiểm tra URL đúng `/tab/Leads/<id>`; xem console `[Alohub] DIAL ctx`
Sai data center	Mở đúng `crm.zoho.<dc>`; provider Alohub có `apiDomain` khớp

Cần hỗ trợ thêm? Liên hệ Alohub.