Skip to main content

API WhatsApp Business

Connectez votre numéro WhatsApp à BeeCastly pour discuter avec vos clients, laisser l'IA répondre à votre place et envoyer des diffusions. Vous pouvez vous connecter en scannant un code QR, ou via l'API officielle Meta WhatsApp Cloud.

Prérequis

Un compte BeeCastly (l'offre gratuite suffit)
Un compte Meta Business (business.facebook.com)
Pour la méthode API Cloud : un compte Meta Business (business.facebook.com) et un numéro de téléphone à enregistrer auprès de Meta

Deux façons de se connecter

Scanner un code QR

Liez le numéro que vous utilisez déjà, y compris un numéro de l'application WhatsApp Business, exactement comme WhatsApp Web. C'est gratuit et ne nécessite aucune approbation de Meta. Idéal pour les réponses et les réponses automatiques. Ne l'utilisez pas pour des diffusions en masse : WhatsApp peut bannir le numéro.

WhatsApp Cloud API (Meta)

La méthode officielle de Meta. Elle nécessite un compte Meta Business et des modèles de messages approuvés. C'est la méthode à utiliser pour les diffusions et les campagnes.

Guide de configuration

1Connecter WhatsApp dans BeeCastly

Allez dans Intégrations → Canaux → WhatsApp.
Code QR : choisissez WhatsApp QR. Sur votre téléphone, ouvrez WhatsApp → Appareils connectés → Connecter un appareil et scannez le code. Votre téléphone continue de fonctionner normalement.
API Cloud : choisissez WhatsApp Cloud API (Meta) et cliquez sur Se connecter avec Facebook. Choisissez votre compte Meta Business et votre numéro de téléphone. Si vous préférez le faire à la main, l'assistant pas à pas demande votre Meta App ID, votre WhatsApp Business Account ID, votre Phone Number ID et votre jeton d'accès.

2Créer des modèles de message

Avec l'API Cloud, vous ne pouvez envoyer du texte libre que dans les 24 heures suivant le dernier message du client. En dehors de cette fenêtre, vous avez besoin d'un modèle approuvé par Meta.
Allez dans Campagnes → Modèles et créez un modèle.
Choisissez une catégorie : Marketing, Utilitaire ou Authentification.
Ajoutez des variables comme {{1}} et {{2}} pour les noms et autres détails.
Soumettez-le. Meta l'examine et le statut se met à jour dans BeeCastly.

3Envoyer une campagne de diffusion

Allez dans Campagnes → Diffusions → Créer.
Sélectionnez WhatsApp comme canal.
Choisissez votre modèle approuvé et votre audience (contacts, étiquettes ou segments).
Associez les variables du modèle aux champs de contact (nom, téléphone, champs personnalisés).
Prévisualisez le message, puis cliquez sur Envoyer maintenant ou Planifier.

4Gérer les conversations

Les messages WhatsApp entrants arrivent dans Messages → WhatsApp (et dans Tous les messages).
Répondez depuis la boîte de réception, utilisez les Réponses rapides pour les réponses que vous envoyez souvent, et attribuez des discussions aux membres de l'équipe.
Activez les réponses IA pour laisser votre chatbot répondre aux questions courantes à partir de votre base de connaissances, et passez la main à une personne en cas de besoin.

5Plus d'outils WhatsApp

Messages → Status Studio : publiez des statuts WhatsApp.
Messages → lien wa.me : créez un lien de discussion en un clic ou un code QR pour votre site web et vos affiches.
Intégrations → Canaux → WhatsApp : modifiez votre profil professionnel et votre catalogue de produits (API Cloud).

Bonnes pratiques

Maintenez une note de qualité élevée

Maintenez une note de qualité ÉLEVÉE en évitant le spam. Si des utilisateurs vous bloquent ou signalent vos messages, Meta peut restreindre vos limites d'envoi.

Recueillez le consentement préalable

Obtenez une autorisation claire avant d'envoyer des messages marketing, par exemple avec un formulaire, un chat sur votre site ou en personne.

Utilisez la réponse automatique par IA avec discernement

Les réponses IA fonctionnent mieux quand votre base de connaissances contient vos prix, vos horaires et vos règles. Laissez toujours aux clients un moyen de joindre une personne.

Important : la fenêtre de 24 heures (API Cloud)

Avec l'API WhatsApp Cloud, vous ne pouvez envoyer du texte libre que dans les 24 heures suivant le dernier message du client. En dehors de cette fenêtre, vous devez utiliser un modèle approuvé.

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