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
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
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
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
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
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 → 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.
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!"}'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" } }