Tích hợp WhatsApp Business với tổng đài UCM6300
UCM6300 tích hợp WhatsApp Business qua WhatsApp Cloud API của Meta, cho phép người dùng Wave Desktop nhận và trả lời tin nhắn WhatsApp tập trung. Bạn tạo ứng dụng trên Meta Developer, lấy Access Token và Phone Number ID, rồi khai báo trong UCM tại Advanced Messaging > Chatbot > WhatsApp, đăng ký Webhook URL về Meta và có thể bật chatbot tự động.
Cần chuẩn bị gì?
- Số điện thoại riêng chưa đăng ký WhatsApp, có thể nhận OTP qua SMS/cuộc gọi
- Meta Business Portfolio và tài khoản Meta Developer (developers.facebook.com)
- UCM6300/A hoặc CloudUCM, firmware tối thiểu UCM630x/630xA 1.0.29.19 (CloudUCM 1.0.29.7)
- UCM truy cập được công khai qua HTTPS với chứng thư TLS/SSL do CA cấp (khuyến nghị dùng địa chỉ RemoteConnect dạng https://xxxx.a.gdms.cloud) — Meta từ chối chứng thư tự ký
- Chỉ Wave Desktop hỗ trợ; Wave Web và Wave Mobile không hỗ trợ
Các bước
-
Tạo ứng dụng trên Meta
Đăng nhập developers.facebook.com, bấm Create App, chọn nhóm Business messaging với use case kết nối khách hàng qua WhatsApp, rồi chọn/tạo Meta Business Portfolio.
-
Lấy Phone Number ID
Vào Use Cases (biểu tượng bút chì), bấm Customize ở use case WhatsApp. Trong phần Quickstart/API Setup, sao chép Phone Number ID của số test hoặc số production.
-
Tạo Access Token vĩnh viễn
Trong Meta Business Settings > Users > System Users, thêm System User vai trò Admin, gán tài sản (App với quyền Manage app, WhatsApp Account với quyền Manage WhatsApp Business Accounts), rồi Generate token: chọn app, đặt hạn (ví dụ 60 ngày), bật quyền whatsapp_business_messaging và whatsapp_business_management, sao chép và lưu token an toàn. (Tùy chọn: lấy App Secret tại App Settings > Basic.)
-
Khai báo WhatsApp trên UCM
Vào Advanced Messaging > Chatbot > WhatsApp, bấm Add WhatsApp và điền các trường bên dưới.
Trường Ý nghĩa Mặc định Enable Kích hoạt tài khoản WhatsApp Tắt Name Tên hiển thị của cấu hình — Access Token Token vĩnh viễn lấy từ Meta — Webhook URL Tự sinh; sao chép để đăng ký bên Meta Tự động Client Secret App Secret từ Meta (tùy chọn) — WhatsApp Phone Number Phone Number ID; bấm + thêm nhiều số — Destination Number Máy nhánh nhận tin nhắn — Enable Chatbot Bật trả lời tự động Tắt -
Đăng ký Webhook về Meta
Mở lại ứng dụng ở developers.facebook.com, vào Use Cases > Customize, phần Configuration bấm Edit, dán Webhook URL từ UCM vào Callback URL, nhập chuỗi bất kỳ vào Verify Token, bấm Verify and Save. Sau đó ở phần Webhook bấm Manage, tìm trường messages và bấm Subscribe, rồi Done.
-
Sử dụng trên Wave Desktop
Người dùng được gán không cần cấu hình phía client; mở add-in WhatsApp Business để xem thông tin tài khoản (chỉ đọc) và Send Template Messages (gửi mẫu tin đã duyệt). Tin đến hiển thị trong module Chat; agent có cửa sổ phục vụ 24 giờ kể từ tin đầu của khách.
Bảng tham số hay phải chỉnh
| Tham số | Mặc định | Khi nào cần đổi |
|---|---|---|
| Enable | Tắt | Bật để kích hoạt tài khoản WhatsApp vừa khai báo. |
| Access Token | — | Dán token vĩnh viễn từ Meta; cập nhật khi token hết hạn. |
| WhatsApp Phone Number (Phone Number ID) | — | Nhập Phone Number ID; bấm + để thêm nhiều số. |
| Destination Number | — | Khai báo máy nhánh (agent) sẽ nhận và xử lý tin nhắn. |
| Chatbot Mode | — | Chọn Automatic Reception (bot xử lý trước) hoặc Chat Assistance (bot và agent song song). |
Chưa làm được, kiểm tra gì?
- Verify Webhook thất bại: UCM phải truy cập được qua HTTPS công khai với chứng thư do CA cấp; Meta từ chối chứng thư tự ký. Khuyến nghị dùng địa chỉ RemoteConnect.
- Không đăng ký được số WhatsApp: Số điện thoại phải chưa gắn tài khoản WhatsApp nào; nếu đã đăng ký thì phải hủy đăng ký trước. Số test được miễn phí nhắn tin 90 ngày.
Làm gì tiếp theo?
Xem thêm hướng dẫn tích hợp UCM6300