Skip to main content
DocsGuidesWhatsApp

WhatsApp

Connect your WhatsApp number to BeeCastly to chat with customers, let AI reply for you, and send broadcasts. You can connect by scanning a QR code, or through the official Meta WhatsApp Cloud API.

Prerequisites

A BeeCastly account (the Free plan works)
For the QR method: your phone with WhatsApp or the WhatsApp Business app on it
For the Cloud API method: a Meta Business account (business.facebook.com) and a phone number to register with Meta

Two ways to connect

Scan a QR code

Link the number you already use, including a WhatsApp Business App number, just like WhatsApp Web. It is free and needs no Meta approval. Best for replies and auto-replies. Do not use it for bulk broadcasts: WhatsApp may ban the number.

WhatsApp Cloud API (Meta)

The official way from Meta. Needs a Meta Business account and approved message templates. This is the method to use for broadcasts and campaigns.

Setup Guide

1Connect WhatsApp

Go to Integrations → Channels → WhatsApp.
QR code: choose WhatsApp QR. On your phone, open WhatsApp → Linked devices → Link a device and scan the code. Your phone keeps working as normal.
Cloud API: choose WhatsApp Cloud API (Meta) and click Connect with Facebook. Pick your Meta Business account and phone number. If you prefer to do it by hand, the Step-by-step Wizard asks for your Meta App ID, WhatsApp Business Account ID, Phone Number ID and access token.

2Create message templates (Cloud API)

On the Cloud API, you can only send free text within 24 hours of the customer's last message. Outside that window you need a template that Meta has approved.
Go to Campaigns → Templates and create a template.
Choose a category: Marketing, Utility or Authentication.
Add variables like {{1}} and {{2}} for names and other details.
Submit it. Meta reviews it and the status updates in BeeCastly.

3Send a broadcast

Go to Campaigns → Broadcasts and create a new broadcast.
Select WhatsApp as the channel.
Choose your template and audience (contacts, tags or segments).
Match the template variables to contact fields.
Preview the message, then send it now or schedule it.

4Reply to customers

Incoming WhatsApp messages land in Messages → WhatsApp (and in All Messages).
Reply from the inbox, use Quick Replies for answers you send often, and assign chats to team members.
Turn on AI replies to let your chatbot answer common questions from your Knowledge Base, and hand over to a person when needed.

5More WhatsApp tools

Messages → Status Studio: post WhatsApp statuses.
Messages → wa.me Link: make a click-to-chat link or QR code for your website and posters.
Integrations → Channels → WhatsApp: edit your business profile and product catalogue (Cloud API).

Best Practices

Keep your number in good standing

Only message people who expect to hear from you. If many people block or report your messages, Meta can limit or ban the number.

Get opt-in consent

Get clear permission before you send marketing messages, for example with a form, a website chat or in person.

Help your AI reply well

AI replies work best when your Knowledge Base has your prices, hours and policies. Always leave a way for customers to reach a person.

Important: the 24-hour window (Cloud API)

On the WhatsApp Cloud API you can only send free text within 24 hours of the customer's last message. Outside this window you must use an approved template.

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