Skip to main content

API doanh nghiệp WhatsApp

Kết nối số WhatsApp của bạn với BeeCastly để trò chuyện với khách hàng, để AI trả lời thay bạn và gửi tin hàng loạt. Bạn có thể kết nối bằng cách quét mã QR, hoặc qua Meta WhatsApp Cloud API chính thức.

Điều kiện tiên quyết

Một tài khoản BeeCastly (gói miễn phí vẫn dùng được)
Một tài khoản Meta Business (business.facebook.com)
Với phương thức Cloud API: một tài khoản Meta Business (business.facebook.com) và một số điện thoại để đăng ký với Meta

Hai cách kết nối

Quét mã QR

Liên kết số bạn đang dùng, kể cả số WhatsApp Business App, giống như WhatsApp Web. Miễn phí và không cần Meta duyệt. Phù hợp nhất để trả lời và tự động trả lời. Không dùng để gửi hàng loạt: WhatsApp có thể khóa số.

WhatsApp Cloud API (Meta)

Cách chính thức từ Meta. Cần tài khoản Meta Business và các mẫu tin nhắn đã được duyệt. Đây là phương thức nên dùng cho tin hàng loạt và chiến dịch.

Hướng dẫn thiết lập

1Kết nối WhatsApp trong BeeCastly

Vào Tích hợp → Kênh → WhatsApp.
Mã QR: chọn WhatsApp QR. Trên điện thoại, mở WhatsApp → Thiết bị đã liên kết → Liên kết thiết bị và quét mã. Điện thoại của bạn vẫn hoạt động bình thường.
Cloud API: chọn WhatsApp Cloud API (Meta) và nhấp Kết nối với Facebook. Chọn tài khoản Meta Business và số điện thoại của bạn. Nếu bạn muốn làm thủ công, Trình hướng dẫn từng bước sẽ hỏi Meta App ID, WhatsApp Business Account ID, Phone Number ID và mã truy cập của bạn.

2Tạo mẫu tin nhắn

Trên Cloud API, bạn chỉ có thể gửi văn bản tự do trong vòng 24 giờ kể từ tin nhắn cuối của khách hàng. Ngoài khung thời gian đó, bạn cần một mẫu tin đã được Meta duyệt.
Vào Chiến dịch → Mẫu tin và tạo một mẫu.
Chọn một danh mục: Marketing, Utility hoặc Authentication.
Thêm các biến như {{1}} và {{2}} cho tên và các chi tiết khác.
Gửi duyệt. Meta sẽ xem xét và trạng thái được cập nhật trong BeeCastly.

3Gửi một chiến dịch hàng loạt

Vào Chiến dịch → Gửi hàng loạt → Tạo mới.
Chọn WhatsApp làm kênh gửi.
Chọn mẫu tin đã được duyệt và tệp đối tượng (liên hệ, thẻ hoặc phân khúc).
Ánh xạ các biến của mẫu tin với trường thông tin liên hệ (tên, số điện thoại, trường tùy chỉnh).
Xem trước tin nhắn, rồi nhấp Gửi ngay hoặc Lên lịch.

4Quản lý hội thoại

Tin nhắn WhatsApp đến sẽ nằm trong Tin nhắn → WhatsApp (và trong Tất cả tin nhắn).
Trả lời từ hộp thư, dùng Trả lời nhanh cho những câu bạn hay gửi, và giao cuộc trò chuyện cho các thành viên nhóm.
Bật phản hồi AI để chatbot trả lời các câu hỏi thường gặp dựa trên Cơ sở kiến thức của bạn, và chuyển cho người thật khi cần.

5Thêm công cụ WhatsApp

Tin nhắn → Status Studio: đăng trạng thái WhatsApp.
Tin nhắn → Liên kết wa.me: tạo liên kết nhấp để trò chuyện hoặc mã QR cho website và poster của bạn.
Tích hợp → Kênh → WhatsApp: chỉnh sửa hồ sơ doanh nghiệp và danh mục sản phẩm (Cloud API).

Kinh nghiệm nên áp dụng

Duy trì điểm chất lượng cao

Hãy giữ điểm chất lượng tin nhắn ở mức CAO bằng cách tránh gửi tin rác. Nếu người dùng chặn bạn hoặc báo cáo tin nhắn, Meta có thể siết giới hạn gửi của bạn.

Xin sự đồng ý nhận tin

Hãy được sự đồng ý rõ ràng trước khi gửi tin nhắn tiếp thị, ví dụ qua biểu mẫu, chat trên website hoặc trực tiếp.

Dùng trả lời tự động bằng AI một cách khôn ngoan

Phản hồi AI hiệu quả nhất khi Cơ sở kiến thức của bạn có giá, giờ mở cửa và chính sách. Luôn để lại cách cho khách hàng liên hệ với người thật.

Quan trọng: khung 24 giờ (Cloud API)

Trên WhatsApp Cloud API, bạn chỉ có thể gửi văn bản tự do trong vòng 24 giờ kể từ tin nhắn cuối của khách hàng. Ngoài khung này bạn phải dùng mẫu tin đã được duyệt.

API Examples

Send a WhatsApp message from your own software with an API key. See the Messages API for details.

bash
curl -X POST https://beecastly.com/api/v1/messages/send \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channel":"WHATSAPP","to":"+919876543210","content":"Hello from BeeCastly!"}'
javascript·send-message.js
const response = await fetch('https://beecastly.com/api/v1/messages/send', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    channel: 'WHATSAPP',
    to: '+919876543210',
    content: 'Hello from BeeCastly!',
  }),
});

const data = await response.json(); // { success: true, data: { messageId, status: "queued" } }

Troubleshooting

Template not approved

If your template is rejected by Meta, check that it follows WhatsApp's guidelines: no promotional content in utility templates, proper formatting, and clear call-to-action buttons.

Messages not delivering

QR method: check that your phone is online and still shows BeeCastly under Linked devices. Cloud API: check that the customer has opted in and that your number's status is healthy in Meta Business Manager.

Rate limits

Meta limits how many people a new Cloud API number can message per day, and the limit grows as you send good-quality messages. Start with small broadcasts and schedule larger ones in Campaigns → Broadcasts.

Frequently Asked Questions

Can I use my WhatsApp Business App number?
Yes. With the QR method you link the number you already use, the same way WhatsApp Web works, and you keep using the app on your phone. For the Cloud API, you connect a number through Meta's sign-up steps.
Do I need Meta approval?
Not for the QR method. The Cloud API needs a Meta Business account, and Meta must approve your message templates before you can use them.
Which method should I use for broadcasts?
The Cloud API. Sending bulk messages over the QR method can get your number banned by WhatsApp, so use QR for replies and auto-replies to people who message you.
WhatsApp Guide - BeeCastly Documentation | BeeCastly