Tích hợp Alohub Softphone × HubSpot

Hướng dẫn cài đặt và sử dụng extension Alohub Softphone trên HubSpot CRM: gọi từ số điện thoại và tự log lịch sử cuộc gọi vào đúng bản ghi.

Tổng quan

Mục	Giá trị
Host	`https://app.hubspot.com/*`
Module	Contact `0-1`, Company `0-2`, Deal `0-3`, Ticket `0-5`
Gắn cuộc gọi	HubSpot Associations — log 1 lần, hiện ở mọi bản ghi liên kết

Điều kiện

Tài khoản Alohub đã cấu hình provider là HubSpot (kết nối Private App token / OAuth ở phía BE).
Người dùng có quyền tạo call engagement trên HubSpot.

Cài đặt

Cài extension, mở app.hubspot.com.
Mở side panel Alohub, đăng nhập.
Badge provider hiển thị HubSpot.

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

Trên trang Contact/Company/Deal/Ticket hoặc danh sách, chip "Gọi" xuất hiện cạnh mỗi số điện thoại. Bấm chip để side panel quay số và bắt đầu cuộc gọi.

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

Extension đọc URL để xác định bản ghi đang xem:

URL HubSpot	module / recordId
`/record/0-1/12345`	`0-1` / `12345`
`/contact/12345/`	`0-1` / `12345`
`/company/678`	`0-2` / `678`
`/deal/910`	`0-3` / `910`

Khi click chip trong danh sách, extension tìm link bản ghi gần nhất trong khối DOM để gắn đúng dòng được click. BE tạo call engagement và associate vào bản ghi đó; nhờ Associations, cuộc gọi tự hiển thị ở các bản ghi liên kết (contact ↔ company ↔ deal).

Lưu ý: Một cuộc gọi chỉ cần log 1 lần — HubSpot tự hiển thị nó ở mọi bản ghi có liên kết associations.

Xử lý sự cố

Hiện tượng	Cách xử lý
Không thấy chip "Gọi"	Reload trang; kiểm tra extension đang bật trên `app.hubspot.com`
Cuộc gọi không gắn bản ghi	Mở DevTools console xem log `[Alohub] DIAL ctx`; kiểm tra URL có `module/recordId`
Không đăng nhập được	Kiểm tra Server URL ở Options; xem cấu hình reCAPTCHA nếu BE bật xác thực

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