Skip to main content

API WhatsApp Business

Connectez-vous à l'API officielle Meta WhatsApp Business pour envoyer des campagnes personnalisées, automatiser les conversations et gérer l'engagement client à grande échelle.

Prérequis

Un compte BeeCastly (l'offre gratuite suffit)
Un compte Meta Business (business.facebook.com)
Un numéro de téléphone professionnel vérifié (pas déjà utilisé sur WhatsApp)
La vérification de l'entreprise finalisée dans Meta Business Manager

Guide de configuration

1Connecter WhatsApp dans BeeCastly

Rendez-vous dans Paramètres → Intégrations → WhatsApp depuis votre tableau de bord BeeCastly.
Cliquez sur « Connecter l'API WhatsApp Business ». Vous serez redirigé vers le parcours d'inscription intégré de Meta.
Suivez les instructions pour sélectionner votre compte Meta Business et votre numéro de téléphone.
Une fois la connexion établie, l'identifiant de votre compte WhatsApp Business, l'identifiant du numéro de téléphone et le jeton d'accès sont configurés automatiquement.

2Créer des modèles de message

WhatsApp exige des modèles pré-approuvés pour les messages sortants (vous ne pouvez pas envoyer de messages libres en dehors d'une fenêtre de 24 heures).
Allez dans Campagnes → Modèles et cliquez sur « Créer un modèle ».
Choisissez une catégorie : Marketing, Utilitaire ou Authentification.
Rédigez votre modèle avec des variables comme {{1}}, {{2}} pour la personnalisation.
Soumettez-le à la validation de Meta. L'approbation prend généralement de 1 à 24 heures.

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

Tous les messages WhatsApp entrants apparaissent dans Messages → WhatsApp.
Répondez à vos clients directement depuis la boîte de réception : pendant la fenêtre de 24 heures, vous pouvez envoyer des messages libres.
Activez la réponse automatique par IA pour laisser votre bot IA traiter automatiquement les questions courantes.
Attribuez les conversations à des membres de l'équipe pour un traitement manuel.

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 toujours un consentement explicite avant d'envoyer des messages marketing. Utilisez des formulaires, des widgets sur votre site ou un recueil de consentement en personne.

Utilisez la réponse automatique par IA avec discernement

La réponse automatique par IA fonctionne mieux lorsque votre bot a été entraîné avec des articles de base de connaissances pertinents. Prévoyez toujours un moyen de joindre un agent humain.

Important : fenêtre de messagerie de 24 heures

L'API WhatsApp Business impose une fenêtre de messagerie de 24 heures. Vous ne pouvez envoyer des messages libres que dans les 24 heures suivant le dernier message du client. En dehors de cette fenêtre, vous devez utiliser des modèles approuvés.

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.