WhatsApp

GetMyBot kết nối WhatsApp qua WhatsApp Cloud API (Meta Graph API). Sau khi kết nối, bot nhận tin nhắn đến từ WhatsApp và áp dụng các phản ứng của bạn cho chúng, còn nhân viên có thể trò chuyện trong các hội thoại. Tổng quan về đa kênh có ở trang Kênh.

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:

  1. Mở Bot → "Thêm kênh" → WhatsApp.
  2. Điền năm trường ở trên và, nếu muốn, tên kênh (không bắt buộc).
  3. Nhấn "Kiểm tra" — GetMyBot xác thực thông tin qua Meta.
  4. 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:

  1. 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.
  2. 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).
  3. 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ổ.

Ngoài cửa sổ 24 giờ, không thể gửi tin nhắn tự do — cách duy nhất để nhắn lại cho người dùng (re-engage) là một template tin nhắn đã được phê duyệt. Vì vậy template là công cụ then chốt cho phát đi và nhắc nhở trong WhatsApp.

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

Bot → trên kênh WhatsApp có biểu tượng "Template tin nhắn" (📄) → hộp thoại "Template của kênh WhatsApp". Trong hộp thoại có các nút:

  • "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:

  1. Trong trình tạo phản ứng, mở "Hành động" → "Thêm hành động" → "Gửi template WhatsApp".
  2. Hành động chỉ khả dụng nếu bot có kênh WhatsApp hỗ trợ template.
  3. Chỉ có thể chọn template đã phê duyệt (APPROVED).
  4. Đ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).