Kết nối số WhatsApp Business, nhận tin nhắn và dùng mẫu được phê duyệt để gửi lời nhắc. Thông tin và thiết lập Meta cần có.
Trên trang này
Kết nối số WhatsApp Business để bot trả lời tin nhắn theo các phản ứng của bạn và nhân viên có thể tiếp tục trò chuyện trong GetMyBot. Nền tảng dùng WhatsApp Cloud API, giao diện nhắn tin chính thức của Meta. Bạn cần thông tin từ ứng dụng Meta như dưới đây.
WhatsApp chỉ cho gửi câu trả lời thông thường trong 24 giờ kể từ tin nhắn của khách. Để nhắc họ sau đó, bạn cần mẫu tin nhắn đã được phê duyệt. Xem Kênh để hiểu cách bot hoạt động với nhiều ứng dụng nhắn tin.
Kết nối kênh WhatsApp
Để kết nối, cần năm thông tin xác thực từ ứng dụng Meta của bạn (WhatsApp Cloud API). Tất cả đều bắt buộc:
- Phone number ID — mã định danh số WhatsApp Business.
- WABA ID — mã định danh WhatsApp Business Account.
- Access token — token truy cập của ứng dụng Meta.
- Verify token — một chuỗi tùy ý do chính bạn đặt ra. Nó được dùng khi xác minh webhook trong Meta (xem bên dưới).
- App secret — bí mật ứng dụng Meta. Cần để kiểm tra chữ ký HMAC của các webhook đến (header
X-Hub-Signature-256).
Các bước trong giao diện:
- Mở Dự án, tìm dự án cần dùng, nhấn Thêm kênh và chọn WhatsApp.
- Điền năm trường ở trên và, nếu muốn, tên kênh (không bắt buộc).
- Nhấn "Kiểm tra" — GetMyBot xác thực thông tin qua Meta.
- Nhấn "Kết nối".
Cấu hình webhook trong Meta
Sau khi kết nối, kênh sẽ có một Callback URL dạng {địa chỉ}/ch/{channelID} (trong giao diện — biểu tượng webhook 🔗). URL này cùng với Verify token của bạn cần được khai báo trong ứng dụng Meta: WhatsApp → Configuration → Webhook.
Cách hoạt động:
- Meta gửi tới Callback URL một yêu cầu xác minh và đối chiếu
verify_tokenđược truyền với Verify token của bạn. Nếu trùng khớp, webhook được coi là đã xác nhận. - Sau đó Meta gửi tới địa chỉ này các sự kiện (tin nhắn đến, trạng thái giao, kết quả kiểm duyệt template).
- Mỗi yêu cầu đến được ký bằng header
X-Hub-Signature-256; GetMyBot kiểm tra chữ ký bằng App secret — vì thế thông tin này được yêu cầu khi kết nối.
Cửa sổ phiên 24 giờ
WhatsApp giới hạn việc chủ động nhắn tin: tin nhắn tự do chỉ có thể gửi cho người dùng trong vòng 24 giờ sau tin nhắn đến gần nhất của họ. Mỗi tin nhắn đến mới từ người dùng sẽ làm mới cửa sổ.
Ví dụ, khách nhắn vào thứ Hai lúc 15:00. Nếu họ không viết thêm, bot có thể trả lời bình thường đến thứ Ba lúc 15:00. Sau đó, tin nhắn cần mẫu đã được phê duyệt. Mỗi tin đến mới từ khách mở lại cửa sổ 24 giờ.
Template tin nhắn
Template (message template) là tin nhắn đã được Meta phê duyệt trước, có thể gửi ngoài cửa sổ phiên. Việc quản lý template nằm trong giao diện GetMyBot.
Quản lý template ở đâu
Trên trang Dự án, nhấn Mẫu tin nhắn (biểu tượng 📄) ở kênh WhatsApp để mở hộp thoại quản lý mẫu. Trong đó có:
- "Tạo template" — dựng một template mới.
- "Đồng bộ" — kéo danh mục template từ Meta (cập nhật trạng thái và danh sách).
Danh mục template
- MARKETING (Tiếp thị) — khuyến mãi, thông báo, phát đi.
- UTILITY (Tiện ích/Dịch vụ) — thông báo theo hành động của người dùng (trạng thái đơn hàng, nhắc nhở).
- AUTHENTICATION (Xác thực) — mã xác nhận.
Các trường của template
- Tên — chữ latin thường, chữ số và
_, tối đa 512 ký tự. - Ngôn ngữ — locale của Meta.
- Danh mục — một trong ba loại ở trên.
Đối với danh mục Tiếp thị và Tiện ích, bổ sung thêm:
- Header — không / văn bản / hình ảnh / video / tài liệu. Với header dạng media, cần tải lên một tệp mẫu.
- Body — bắt buộc, tối đa 1024 ký tự. Biến được ký hiệu bằng
{{1}},{{2}}, … theo thứ tự nghiêm ngặt từ 1 đến N, không bỏ trống. - Footer — tối đa 60 ký tự.
- Nút — tối đa 10: trả lời nhanh, liên kết (tối đa 2), điện thoại (1), sao chép mã (1).
- Với mỗi biến
{{n}}cần đặt một giá trị mẫu — đây là yêu cầu của Meta cho kiểm duyệt.
Đối với danh mục Xác thực, phần body do chính Meta cố định; có thể cấu hình: thời hạn của mã (1–90 phút), khuyến nghị bảo mật và văn bản nút sao chép mã.
Kiểm duyệt
Nút "Tạo" gửi ngay template sang kiểm duyệt của Meta — không có bước riêng "gửi đi kiểm tra". Kết quả đến một cách bất đồng bộ (qua webhook), danh sách template tự động cập nhật. Trạng thái:
- PENDING (Đang kiểm tra)
- APPROVED (Đã phê duyệt)
- REJECTED (Bị từ chối) — kèm lý do
- cũng như PAUSED, DISABLED, IN_APPEAL, PENDING_DELETION.
Có thể chỉnh sửa các template ở trạng thái APPROVED, REJECTED, PAUSED. Không thể đổi tên và ngôn ngữ; ở template đã phê duyệt, danh mục cũng bị khóa.
Sử dụng template trong phản ứng
Gửi template là một hành động của phản ứng:
- Trong trình tạo phản ứng, mở "Hành động" → "Thêm hành động" → "Gửi template WhatsApp".
- Hành động chỉ khả dụng nếu bot có kênh WhatsApp hỗ trợ template.
- Chỉ có thể chọn template đã phê duyệt (APPROVED).
- Điền các tham số: giá trị biến
{{n}}trong body, header văn bản, header media theo liên kết, tham số nút URL. Trong tham số có thể dùng biến thay thế.
Kênh gửi thực tế được xác định bởi kênh của sự kiện: nếu sự kiện đến từ WhatsApp, template sẽ được gửi tới WhatsApp.
Hội thoại và tệp đính kèm
Nhân viên có thể trả lời trong hội thoại WhatsApp và gửi tệp đính kèm — hình ảnh, video hoặc tài liệu — trong giới hạn cửa sổ 24 giờ (ngoài cửa sổ, trò chuyện tự do không khả dụng). Media đến từ người đăng ký được kéo qua proxy và hiển thị trong hội thoại.
Tính phí
GetMyBot ghi nhận các cuộc hội thoại WhatsApp (conversations) theo danh mục — marketing / utility / authentication / service. Ở phiên bản hiện tại, đây chỉ là ghi nhận để quan sát (record-only): số dư không bị trừ cho các cuộc hội thoại.
Tiếp theo
- Kênh — đa kênh và ma trận khả năng.
- Phản ứng: cơ bản — cách dựng hành vi của bot.
- Phát đi — gửi hàng loạt (ở WhatsApp — qua template đã phê duyệt).