Skip to main content

API doanh nghiệp WhatsApp

Kết nối với WhatsApp Business API chính thức của Meta để gửi chiến dịch cá nhân hóa, tự động hóa hội thoại và quản lý tương tác khách hàng ở quy mô lớn.

Đ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)
Một số điện thoại doanh nghiệp đã xác minh (chưa đăng ký WhatsApp)
Đã hoàn tất xác minh doanh nghiệp trong Meta Business Manager

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

1Kết nối WhatsApp trong BeeCastly

Đi tới Cài đặt → Tích hợp → WhatsApp trong bảng điều khiển BeeCastly của bạn.
Nhấp vào "Kết nối WhatsApp Business API". Bạn sẽ được chuyển tới luồng đăng ký nhúng của Meta.
Làm theo hướng dẫn để chọn tài khoản Meta Business và số điện thoại của bạn.
Sau khi kết nối, ID Tài khoản WhatsApp Business, ID Số điện thoại và mã truy cập của bạn sẽ được cấu hình tự động.

2Tạo mẫu tin nhắn

WhatsApp yêu cầu mẫu tin được phê duyệt trước cho tin nhắn gửi đi (bạn không thể gửi tin nhắn tự do ngoài khung 24 giờ).
Vào Chiến dịch → Mẫu tin rồi nhấp "Tạo mẫu tin".
Chọn một danh mục: Tiếp thị, Tiện ích, hoặc Xác thực.
Soạn mẫu tin của bạn với các biến như {{1}}, {{2}} để cá nhân hóa.
Gửi cho Meta duyệt. Việc phê duyệt thường mất từ 1 đến 24 giờ.

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

Mọi tin nhắn WhatsApp đến đều hiển thị trong Tin nhắn → WhatsApp.
Trả lời khách hàng ngay từ hộp thư đến — trong khung 24 giờ, bạn có thể gửi tin nhắn tự do.
Bật Trả lời tự động bằng AI để bot AI của bạn tự xử lý các câu hỏi thường gặp.
Giao hội thoại cho thành viên trong nhóm để xử lý thủ công.

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

Luôn xin sự đồng ý rõ ràng trước khi gửi tin nhắn tiếp thị. Hãy dùng biểu mẫu, tiện ích trên website hoặc thu thập đồng ý trực tiếp.

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

Trả lời tự động bằng AI hiệu quả nhất khi bạn đã huấn luyện bot bằng các bài viết kho kiến thức phù hợp. Hãy luôn có cách để khách hàng gặp được nhân viên hỗ trợ thật.

Quan trọng: Khung nhắn tin 24 giờ

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

API Examples

Use the BeeCastly REST API to send WhatsApp messages programmatically.

bash
curl -X POST https://api.beecastly.com/api/whatsapp/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+1234567890",
    "message": "Hello from BeeCastly!"
  }
javascript·send-message.js
const response = await fetch('https://api.beecastly.com/api/whatsapp/send', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    phone: '+1234567890',
    message: 'Hello from BeeCastly!',
  }),
});

const data = await response.json();
console.log(data);

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

Ensure the recipient has opted in to receive messages. Check your WhatsApp Business Account health status in the Meta Business Manager.

Rate limits

WhatsApp Cloud API has rate limits. Start with small batches and scale gradually. Use the BeeCastly campaign scheduler to manage sending rates.

Frequently Asked Questions

How long does Meta verification take?
Meta Business verification typically takes 2-5 business days. Ensure your business documents are clear and match your Business Manager details.
Can I use my personal WhatsApp number?
No, you need a dedicated WhatsApp Business API number. This cannot be a personal WhatsApp or WhatsApp Business App number.
What is the cost per message?
WhatsApp charges per conversation (24-hour window), not per message. The first message in a conversation is charged; all subsequent messages within 24 hours are free.