WhatsApp Business API chính thức
Kết nối tài khoản WhatsApp Business Platform chính thức của Meta (Cloud API) với cshub để gửi phát sóng bằng mẫu chính thức, thiết lập trả lời tự động và giữ cho số doanh nghiệp của bạn luôn có uy tín tốt với Meta. Mọi chat gửi đến số WABA đều đổ về CRM Chat cùng với các kênh khác của bạn.
Trong cshub, một tài khoản WABA (WhatsApp Business Account) có thể chứa nhiều số điện thoại. Mỗi số được gọi là một thiết bị. Từ trang tài khoản, bạn quản lý bốn thứ: thiết bị, mẫu, phát sóng và chatbot.
Bạn cần WABA, hay chỉ quét QR là đủ?
WABA phù hợp nếu bạn cần lượng tin nhắn lớn, mẫu đã được Meta duyệt hoặc tích xanh. Để bắt đầu nhanh mà không cần Meta xác minh, hãy dùng WhatsApp (quét QR). Bảng so sánh có trong Về các kênh.
Trước khi bắt đầu
- Một tài khoản Meta Business (Business Manager) do bạn quản lý.
- Một số điện thoại chưa được đăng ký trên một thiết lập WhatsApp Business Platform khác — hoặc, nếu bạn muốn tiếp tục dùng số đó trong ứng dụng WhatsApp Business trên điện thoại, hãy chọn chế độ Coexistence khi kết nối.
- Với cách Thủ công: một Meta App có System User và access token dài hạn.
Danh sách tài khoản WABA
Mở Kết nối WhatsApp trên thanh bên, rồi chọn tab WhatsApp Business API chính thức.
Mỗi thẻ hiển thị tên tài khoản, WABA ID, cách kết nối (Đăng ký nhúng hoặc Thủ công), số thiết bị và số mẫu, cùng Meta App ID. Nút ⋮ trên thẻ mở một menu:
| Menu | Chức năng |
|---|---|
| Xem chi tiết | Mở trang tài khoản (giống như bấm vào thẻ) |
| Đồng bộ từ Meta | Lấy số điện thoại và mẫu mới nhất từ Meta rồi tóm tắt kết quả, chẳng hạn tìm thấy bao nhiêu thiết bị mới, hoặc báo không có thay đổi nào từ Meta |
| Chỉnh sửa thông tin xác thực | Thay App Secret và access token của tài khoản này |
| Xóa | Gỡ tài khoản WABA khỏi cshub (xem Xóa tài khoản WABA) |
Kết nối tài khoản WABA
Bấm Kết nối WABA. Có hai cách: Đăng ký nhúng (dễ nhất) hoặc Thủ công.
Cách 1 — Đăng ký nhúng (đăng nhập Facebook)
- Nếu số của bạn vẫn đang dùng trong ứng dụng WhatsApp Business trên điện thoại và bạn muốn giữ nguyên như vậy, hãy tích Mình cũng sử dụng ứng dụng WA Business trên điện thoại (Hòa hợp) (xem Coexistence).
- Bấm Kết Nối qua Facebook. Một cửa sổ Facebook sẽ mở ra.
- Đăng nhập, rồi chọn Business Manager → WhatsApp Business Account → số điện thoại.
- Khi hộp thoại hoàn tất, điền Tên hiển thị (tùy chọn) — tên giúp phân biệt các tài khoản trong bảng điều khiển, ví dụ WABA cửa hàng chính. Nếu để trống, WABA ID sẽ được dùng.
- Bấm Hoàn tất kết nối. Muốn chọn lại? Bấm Hủy & Chọn lại.
cshub tự động đổi quyền Facebook lấy một token dài hạn (60 ngày) và kết nối webhook, nên tin nhắn đến sẽ đổ thẳng vào CRM Chat.
Cửa sổ bật lên không hiện?
Trình chặn quảng cáo hoặc chặn cửa sổ bật lên có thể ngăn hộp thoại Facebook. Hãy cho phép cửa sổ bật lên với cshub rồi thử lại. Nếu vẫn thất bại, hãy dùng tab Thủ công.
Cách 2 — Thủ công (thông tin xác thực Cloud API)
Dành cho tài khoản WABA đã hoạt động và bạn có quyền truy cập Meta Developers Console.
Bạn tìm các giá trị này trong Meta Developers Console → Your App → WhatsApp → API Setup.
| Trường | Ghi chú |
|---|---|
| Meta App ID * | Dãy số 15–16 chữ số của Meta App |
| WABA ID * | ID của WhatsApp Business Account (chỉ gồm chữ số) |
| Mã bí mật của Meta App * | Ít nhất 10 ký tự. Được lưu ở dạng mã hóa |
| Mã truy cập người dùng hệ thống * | Token System User dài hạn, ít nhất 20 ký tự. Được kiểm tra với Meta khi bạn lưu |
| Tên hiển thị | Tên dùng trong bảng điều khiển. Mặc định là WABA ID nếu để trống |
| Đại lý xử lý * | Ít nhất 1 thành viên. Họ được tự động phân công cho mọi số được đồng bộ từ Meta |
Bấm Kết nối WABA.
Nếu kết nối thất bại
| Thông báo | Nguyên nhân & cách khắc phục |
|---|---|
| Token Meta không hợp lệ | Token đã hết hạn hoặc App Secret không khớp với App ID. Tạo token mới trong Meta Business Manager |
| Đăng ký webhook thất bại | Tài khoản đã kết nối nhưng webhook chưa hoạt động. Mở trang chi tiết tài khoản và bấm Kết nối lại |
| Không có số WhatsApp | WABA chưa có số điện thoại nào. Thêm số trong Meta Business Manager → WhatsApp Manager → Phone Numbers, rồi thử lại |
| Đăng ký nhúng thất bại | Mã Facebook đã hết hạn hoặc đã được dùng. Thử lại hộp thoại hoặc dùng Thủ công |
| WABA đã được kết nối | WABA ID này đang được dùng trong một tài khoản cshub khác. Gỡ nó ở đó trước hoặc liên hệ hỗ trợ |
| Đã đạt giới hạn gói | Gói của bạn đã chạm mức trần số tài khoản WABA. Xem Thanh toán & gói |
Chế độ Coexistence
Coexistence cho phép một số được dùng cùng lúc trong ứng dụng WhatsApp Business trên điện thoại và trong cshub:
- Tin nhắn của khách đến điện thoại và bảng điều khiển cshub.
- Tin nhắn bạn tự gửi từ điện thoại được ghi lại trong lịch sử trên bảng điều khiển, nên đội của bạn biết khách đã được xử lý.
- cshub vẫn có thể gửi phát sóng bằng mẫu và trả lời tự động.
Chế độ này phù hợp với doanh nghiệp nhỏ mà chủ hoặc CS vẫn hay trả lời từ điện thoại nhưng muốn bắt đầu dùng phát sóng và CRM. Tài khoản ở chế độ này có huy hiệu Coexistence trên trang chi tiết.
Trang chi tiết tài khoản
Bấm vào thẻ tài khoản (hoặc ⋮ → Xem chi tiết).
| Phần | Có gì bên trong |
|---|---|
| Trạng thái Webhook | Hộp màu xanh lá Webhook connected nghĩa là tin nhắn đến và trạng thái gửi từ Meta được chuyển tiếp tự động. Nếu bạn thấy Webhook not connected yet, hãy bấm Kết nối lại |
| Show manual webhook setup | Hiển thị URL webhook và Mã xác minh để bạn tự dán vào Meta Developers → App → WhatsApp → Configuration, phòng khi thiết lập tự động không thành công |
| Manage this account | Lối tắt đến Thiết bị, Mẫu, Phát sóng và Chatbot |
| Thông tin tài khoản | Meta App ID, WABA ID (có thể sao chép), cách kết nối, ngày tạo và ngày cập nhật cuối |
Webhook chưa kết nối = không có tin nhắn đến
Cho đến khi webhook được kết nối, chat của khách gửi đến số WABA sẽ không về cshub. Nếu Kết nối lại liên tục thất bại, hãy chắc chắn access token có quyền whatsapp_business_management và whatsapp_business_messaging.
Thiết bị (số điện thoại)
Thẻ Thiết bị mở danh sách các số trong tài khoản này.
Các số được thêm tự động trong quá trình Đăng ký nhúng, hoặc khi bạn bấm Đồng bộ Meta sau khi thêm số trong Meta Business Manager. Trạng thái thiết bị:
| Trạng thái | Ý nghĩa |
|---|---|
| Hoạt động | Số có thể gửi và nhận tin nhắn |
| Không hoạt động | Số chưa dùng được |
| Bị Chặn bởi Meta | Meta đã hạn chế số này. Hãy kiểm tra Đánh Giá Chất Lượng và cách bạn nhắn tin |
Bấm biểu tượng chi tiết trên hàng của một số để mở phần cài đặt. Có ba tab.
Tab Token & Thông tin
Trạng thái từ Meta được lấy ở lần đồng bộ gần nhất:
| Mục | Ý nghĩa |
|---|---|
| Hiển thị Số Điện Thoại | Số điện thoại như khách hàng nhìn thấy |
| Tên đã xác minh | Tên doanh nghiệp đã được Meta duyệt |
| Đánh Giá Chất Lượng | Sức khỏe của số: Xanh (khỏe mạnh), Vàng (cảnh báo) hoặc Đỏ (bị hạn chế). Mức này giảm khi nhiều khách chặn hoặc báo cáo tin nhắn của bạn |
| Giới Hạn Nhắn Tin | Số cuộc hội thoại Meta cho phép bạn bắt đầu mỗi ngày |
| Webhook | Đã đăng ký nghĩa là tin nhắn đến được chuyển tiếp về cshub |
| Platform Type / Verification | Loại nền tảng và trạng thái xác minh từ Meta |
Chỉ điền Ghi đè Token Truy cập nếu số này có System User riêng. Thông thường token được kế thừa từ tài khoản, nên hãy để trống.
Tab Phản hồi tự động
| Cài đặt | Ghi chú |
|---|---|
| Phương pháp tự động trả lời | Không trả lời tự động, Trả lời theo từ khóa, Đại lý AI hoặc Từ khóa trước, rồi AI. Với hai lựa chọn cuối, hãy chọn Đại lý AI |
| Đánh dấu trò chuyện là đã đọc trước khi phản hồi tự động | Khách thấy dấu tích xanh trước khi câu trả lời tự động đến |
| Chỉ kích hoạt tự động phản hồi vào những ngày nhất định | Chọn các ngày hoạt động |
| Chỉ kích hoạt tự động phản hồi vào những giờ nhất định | Đặt giờ Bắt đầu và Kết thúc (ví dụ 09:00) |
| Đại lý | Các thành viên CS nhận chat sau khi phần trả lời tự động kết thúc, kèm mức quyền của họ |
| Lời Nhắc Bổ Sung (tùy chọn) | Hướng dẫn thêm cho Đại lý AI, chỉ áp dụng cho số này |
| Leo thang (SLA) | Thông báo cho các đại lý khi một chat chờ quá lâu mà chưa có người trả lời |
| Phương pháp phân công đại lý | Cách giao chat mới cho đội của bạn (xem Về các kênh) |
Bấm Lưu Cấu Hình. Từ khóa cho số WABA được tạo trong Chatbot WABA.
Tab Lời chào
Lời chào là tin nhắn chào mừng tự động được gửi khi khách nhắn tin sau 24 giờ không có tương tác nào. Bật Kích hoạt phản hồi tự động chào mừng, rồi chọn Loại Tin Nhắn Chào Mừng:
- Văn bản tự do — tự viết, tối đa 1.024 ký tự.
- Mẫu WhatsApp — chọn một mẫu Đã phê duyệt.
Bấm Lưu Lời Chào.
Mẫu tin nhắn
Meta yêu cầu một mẫu đã được duyệt để bắt đầu cuộc hội thoại với khách (ví dụ khi phát sóng) hoặc để nhắn tin cho họ ngoài khung 24 giờ kể từ lần trả lời cuối của họ.
Bạn đã có mẫu trong Meta Business Manager? Bấm Đồng bộ từ Meta để kéo chúng về. Mẫu đã bị xóa phía Meta được đánh dấu Đã xóa.
| Trạng thái mẫu | Ý nghĩa |
|---|---|
| Đang chờ xem xét | Vừa gửi, Meta đang xét duyệt |
| Đã phê duyệt | Sẵn sàng cho phát sóng, chatbot và lời chào |
| Bị từ chối | Không qua được xét duyệt. Sửa nội dung và tạo mẫu mới |
| Đã xóa | Đã bị gỡ phía Meta |
Tạo mẫu
Bấm Thêm Mẫu. Phần Xem trước WhatsApp ở bên phải cập nhật ngay khi bạn gõ.
| Trường | Ghi chú |
|---|---|
| Tên Mẫu | Chữ thường, chữ số và dấu gạch dưới, ví dụ order_confirmation. Tối đa 100 ký tự |
| Ngôn ngữ | Ngôn ngữ của mẫu, ví dụ Indonesia (id) hoặc English (en) |
| Danh mục | Tiện ích (giao dịch) cho cập nhật đơn hàng/tài khoản, Tiếp thị (quảng cáo) cho khuyến mãi, Xác thực (OTP) cho mã xác minh |
| Loại Tiêu đề | Văn bản (không có tiêu đề), Hình ảnh (JPG/PNG tối đa 16MB), Video (MP4 tối đa 16MB) hoặc Tài liệu (PDF tối đa 100MB). Với tiêu đề dạng media, hãy tải tệp lên |
| Nội dung Thân | Nội dung tin nhắn, tối đa 1.098 ký tự. Dùng 1, 2 cho những phần thay đổi theo từng khách |
| Biến mẫu | Tự động xuất hiện cho mỗi |
| Chân trang (tùy chọn) | Chữ nhỏ dưới tin nhắn, tối đa 60 ký tự |
| Nút (tùy chọn, tối đa 10) | Phản hồi nhanh, URL, Điện thoại hoặc Sao chép mã |
Bấm Tạo Mẫu. Mẫu sẽ ở trạng thái Đang chờ xem xét cho đến khi Meta duyệt.
Không thể đổi tên và ngôn ngữ
Sau khi tạo, tên và ngôn ngữ của mẫu bị khóa. Nếu cần tên hoặc ngôn ngữ khác, hãy tạo mẫu mới.
Phát sóng WABA
Gửi một mẫu Đã phê duyệt đến nhiều liên hệ cùng lúc.
Bấm Tạo Broadcast:
| Trường | Ghi chú |
|---|---|
| Tên Chiến Dịch | Tên để nhận biết đợt phát sóng, ví dụ Khuyến mãi Lễ 2026 |
| Lịch Giao Hàng | Ngày & giờ gửi; phải là thời điểm trong tương lai |
| Mẫu (chỉ ĐƯỢC PHÊ DUYỆT) | Chỉ những mẫu Đã phê duyệt mới được liệt kê |
| Thiết bị gửi | Ít nhất 1 số WABA |
| Bộ Lọc Đối Tượng (tùy chọn) | Lọc liên hệ theo Danh mục, Thành phố và Quận. Để trống = tất cả liên hệ |
| Chế độ xoay vòng | Chuỗi (thứ tự thiết bị) — dùng số 1 đến hết, rồi sang số 2; Xoay vòng (round-robin) — luân phiên giữa các số; Ngẫu nhiên — mỗi liên hệ một số ngẫu nhiên |
| Độ trễ (giây) | Khoảng nghỉ giữa các tin nhắn |
| Ngưỡng nghỉ | Sau số tin nhắn này, việc gửi tạm dừng để nghỉ |
| Thời gian nghỉ (giây) | Thời gian nghỉ kéo dài bao lâu |
| Metadata JSON | Giá trị cho các biến {"1": "Hello "}. Nút JSON đẹp giúp sắp xếp lại cho gọn |
| Ghi đè Tiêu Đề Tệp (tùy chọn) | Chỉ dùng khi mẫu có tiêu đề media và bạn muốn thay tệp mặc định |
Bấm Lên lịch phát sóng. Các trạng thái phát sóng: Lịch trình đang chờ, Đang chạy, Hoàn thành hoặc Đã dừng. Đợt phát sóng chỉ chỉnh sửa được khi còn đang chờ. Trang chi tiết hiển thị thanh tiến độ (đang chờ / đã gửi / thất bại) và nút Làm mới tiến trình.
Với phát sóng qua WhatsApp quét QR, xem Phát sóng WhatsApp.
Chatbot WABA
Trả lời tự động theo từ khóa, chỉ dành cho các số trong tài khoản WABA này.
Bấm Thêm Chatbot:
| Trường | Ghi chú |
|---|---|
| Từ khóa * | Từ kích hoạt câu trả lời. Được so khớp chính xác với tin nhắn đến, không phân biệt chữ hoa chữ thường |
| Chế độ trả lời * | Văn bản tự do — gửi văn bản thường; Mẫu WhatsApp — gửi một mẫu Đã phê duyệt |
| Tin nhắn trả lời * | Với chế độ văn bản, tối đa 4.096 ký tự |
| Mẫu WABA | Với chế độ mẫu |
| Thiết bị WABA * | Ít nhất 1 số. Chatbot chỉ chạy trên những số được chọn |
| Metadata JSON / Tệp tiêu đề | Không bắt buộc, dùng để điền biến của mẫu và thay tệp tiêu đề media |
Để chatbot được sử dụng, hãy đặt Phương pháp tự động trả lời của số đó thành Trả lời theo từ khóa hoặc Từ khóa trước, rồi AI trong tab Phản hồi tự động.
Thay thông tin xác thực
Token hết hạn hoặc App Secret đã đổi? Mở Chỉnh sửa thông tin xác thực trên trang chi tiết.
Các trường được cố tình để trống — thông tin xác thực cũ không bao giờ được hiển thị. Nhập Mã bí mật của Meta App và Mã truy cập người dùng hệ thống mới, rồi bấm Lưu Thông tin xác thực Mới. cshub kiểm tra token với Meta và kết nối lại webhook.
Xóa tài khoản WABA
Chọn Xóa trên trang chi tiết hoặc trong menu của thẻ.
- Không có lịch sử chat: tài khoản bị xóa và webhook Meta được ngắt kết nối tự động.
- Có lịch sử: chọn Chuyển lịch sử đến tài khoản WABA khác (lịch sử và thiết bị được chuyển đi, rồi tài khoản bị xóa) hoặc Xóa cưỡng bức + lịch sử (vĩnh viễn, không thể khôi phục).
Mẹo
- Giữ Đánh Giá Chất Lượng ở mức xanh. Chỉ phát sóng đến những liên hệ muốn nghe từ bạn, và cho họ cách để từ chối nhận tin.
- Chọn danh mục mẫu trung thực. Mẫu khuyến mãi mà xếp vào Tiện ích thường bị Meta từ chối hoặc phân loại lại.
- Đồng bộ sau khi thay đổi bên Meta. Đã thêm số hoặc mẫu trong Business Manager? Bấm Đồng bộ Meta để cshub cập nhật theo.
Các vấn đề khác được đề cập trong Khắc phục sự cố.