Skip to main content

WhatsApp Business-API

Koppel je WhatsApp-nummer aan BeeCastly om met klanten te chatten, AI voor je te laten antwoorden en broadcasts te versturen. Je kunt koppelen door een QR-code te scannen, of via de officiële Meta WhatsApp Cloud API.

Vereisten

Een BeeCastly-account (het gratis pakket volstaat)
Een Meta Business-account (business.facebook.com)
Voor de Cloud API-methode: een Meta Business-account (business.facebook.com) en een telefoonnummer om bij Meta te registreren

Twee manieren om te koppelen

Scan een QR-code

Koppel het nummer dat je al gebruikt, ook een nummer van de WhatsApp Business-app, net als WhatsApp Web. Het is gratis en heeft geen goedkeuring van Meta nodig. Het beste voor antwoorden en automatische antwoorden. Gebruik het niet voor massale broadcasts: WhatsApp kan het nummer blokkeren.

WhatsApp Cloud API (Meta)

De officiële manier van Meta. Heeft een Meta Business-account en goedgekeurde berichtsjablonen nodig. Dit is de methode voor broadcasts en campagnes.

Installatiehandleiding

1WhatsApp verbinden in BeeCastly

Ga naar Integraties → Kanalen → WhatsApp.
QR-code: kies WhatsApp QR. Open op je telefoon WhatsApp → Gekoppelde apparaten → Een apparaat koppelen en scan de code. Je telefoon blijft gewoon werken.
Cloud API: kies WhatsApp Cloud API (Meta) en klik op Verbinden met Facebook. Kies je Meta Business-account en telefoonnummer. Als je het liever met de hand doet, vraagt de Stapsgewijze wizard om je Meta App ID, WhatsApp Business Account ID, Phone Number ID en toegangstoken.

2Berichtsjablonen maken

Op de Cloud API kun je alleen vrije tekst versturen binnen 24 uur na het laatste bericht van de klant. Buiten dat venster heb je een sjabloon nodig dat door Meta is goedgekeurd.
Ga naar Campagnes → Sjablonen en maak een sjabloon.
Kies een categorie: Marketing, Utility of Authenticatie.
Voeg variabelen toe zoals {{1}} en {{2}} voor namen en andere gegevens.
Dien het in. Meta beoordeelt het en de status wordt bijgewerkt in BeeCastly.

3Een massacampagne versturen

Ga naar Campagnes → Massaberichten → Maken.
Selecteer WhatsApp als kanaal.
Kies je goedgekeurde sjabloon en je doelgroep (contacten, labels of segmenten).
Koppel de sjabloonvariabelen aan contactvelden (naam, telefoon, aangepaste velden).
Bekijk een voorbeeld van het bericht en klik daarna op Nu versturen of Inplannen.

4Gesprekken beheren

Binnenkomende WhatsApp-berichten komen terecht in Berichten → WhatsApp (en in Alle berichten).
Antwoord vanuit de inbox, gebruik Snelle antwoorden voor antwoorden die je vaak verstuurt en wijs chats toe aan teamleden.
Zet AI-antwoorden aan zodat je chatbot veelgestelde vragen beantwoordt vanuit je Kennisbank, en draag over aan een persoon wanneer nodig.

5Meer WhatsApp-tools

Berichten → Status Studio: plaats WhatsApp-statussen.
Berichten → wa.me-link: maak een klik-om-te-chatten-link of QR-code voor je website en posters.
Integraties → Kanalen → WhatsApp: bewerk je bedrijfsprofiel en productcatalogus (Cloud API).

Aanbevolen werkwijzen

Houd je kwaliteitsscore hoog

Houd je kwaliteitsscore voor berichten HOOG door spam te vermijden. Als gebruikers je blokkeren of berichten rapporteren, kan Meta je verzendlimieten beperken.

Verzamel opt-in-toestemming

Vraag duidelijke toestemming voordat je marketingberichten stuurt, bijvoorbeeld via een formulier, een websitechat of persoonlijk.

Gebruik AI-automatisch antwoord verstandig

AI-antwoorden werken het best wanneer je Kennisbank je prijzen, openingstijden en regels bevat. Laat klanten altijd een manier houden om een persoon te bereiken.

Belangrijk: het 24-uursvenster (Cloud API)

Op de WhatsApp Cloud API kun je alleen vrije tekst versturen binnen 24 uur na het laatste bericht van de klant. Buiten dit venster moet je een goedgekeurd sjabloon gebruiken.

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