Skip to main content

WhatsApp Business-API

Maak verbinding met de officiële Meta WhatsApp Business API om gepersonaliseerde campagnes te versturen, gesprekken te automatiseren en klantcontact op schaal te beheren.

Vereisten

Een BeeCastly-account (het gratis pakket volstaat)
Een Meta Business-account (business.facebook.com)
Een geverifieerd zakelijk telefoonnummer (nog niet in gebruik op WhatsApp)
Bedrijfsverificatie voltooid in Meta Business Manager

Installatiehandleiding

1WhatsApp verbinden in BeeCastly

Ga naar Instellingen → Integraties → WhatsApp in je BeeCastly-dashboard.
Klik op "WhatsApp Business API verbinden". Je wordt doorgestuurd naar het ingebouwde aanmeldproces van Meta.
Volg de stappen om je Meta Business-account en telefoonnummer te selecteren.
Zodra de verbinding tot stand is gebracht, worden je WhatsApp Business Account-ID, telefoonnummer-ID en toegangstoken automatisch ingesteld.

2Berichtsjablonen maken

WhatsApp vereist vooraf goedgekeurde sjablonen voor uitgaande berichten (buiten het venster van 24 uur kun je geen vrije berichten sturen).
Ga naar Campagnes → Sjablonen en klik op "Sjabloon maken".
Kies een categorie: Marketing, Service of Authenticatie.
Schrijf je sjabloon met variabelen zoals {{1}}, {{2}} voor personalisatie.
Dien het in ter beoordeling bij Meta. Goedkeuring duurt doorgaans 1-24 uur.

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

Alle inkomende WhatsApp-berichten verschijnen in Berichten → WhatsApp.
Beantwoord klanten rechtstreeks vanuit de inbox — binnen het venster van 24 uur kun je vrije berichten sturen.
Schakel AI-automatisch antwoord in en laat je AI-bot veelgestelde vragen automatisch afhandelen.
Wijs gesprekken toe aan teamleden voor handmatige afhandeling.

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 altijd expliciete toestemming voordat je marketingberichten verstuurt. Gebruik formulieren, websitewidgets of persoonlijk verzamelde toestemming.

Gebruik AI-automatisch antwoord verstandig

Automatisch antwoorden met AI werkt het best als je je bot hebt getraind met relevante kennisbankartikelen. Bied klanten altijd een manier om een medewerker te bereiken.

Belangrijk: berichtenvenster van 24 uur

De WhatsApp Business API kent een berichtenvenster van 24 uur. Je kunt alleen vrije berichten sturen binnen 24 uur na het laatste bericht van de klant. Daarbuiten moet je goedgekeurde sjablonen gebruiken.

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.