Introduction
Ce guide décrit un flux WhatsApp sortant complet avec les API REST Buzzbip. Vous devez avoir l'accès API activé sur votre compte et au moins un modèle approuvé par Meta. Tous les appels ciblent https://app.buzzbip.com avec Authorization: Bearer <token>. En production, mettez les envois en file côté serveur et gérez explicitement les erreurs JSend.
Étapes
Suivez ces étapes pour terminer l'intégration.
- Authentifiez-vous avec POST /api/login_check et stockez le JWT.
- Vérifiez que votre modèle est APPROVED (GET /api/whatsapp/templates/{id} ou équivalent v2).
- Créez ou localisez un contact avec POST /api/contacts/ ou GET /api/contacts/.
- Envoyez avec POST /api/whatsapp/ en incluant template_id et contact_id.
- Vérifiez la livraison dans l'historique GET /api/whatsapp/.
Détails
Ce guide décrit un flux WhatsApp sortant complet avec les API REST Buzzbip. Vous devez avoir l'accès API activé et au moins un modèle Meta approuvé. Tous les appels ciblent https://app.buzzbip.com avec Authorization: Bearer. En production, mettez les envois en file côté serveur et gérez les erreurs JSend.
curl -X POST 'https://app.buzzbip.com/api/whatsapp/' \
-H 'Authorization: Bearer ${TOKEN}' \
-H 'Content-Type: application/json' \
-d '{"template_id": 42, "contact_id": 1}'Testez en staging avant les envois ou synchronisations en production.
Notes d'intégration
Lors de l'intégration de ce endpoint Buzzbip, utilisez https://app.buzzbip.com comme hôte de production. Obtenez un JWT via POST /api/login_check et envoyez Authorization: Bearer sur chaque requête. Vérifiez que User.hasApiAccess est activé dans l'admin Buzzbip. Analysez les réponses JSend (status, message, data). Pour les plugins e-commerce, envoyez aussi x-api-key, x-platform-type et x-base-uri. Respectez les slashs finaux sur POST /api/contacts/ et POST /api/whatsapp/. Implémentez des nouvelles tentatives avec backoff en cas de limite de débit. Stockez les identifiants côté serveur et réauthentifiez-vous avant l'expiration du JWT (3600 s).
Sécurité
Bonnes pratiques : credentials uniquement côté serveur, TLS obligatoire, surveillance des échecs d'authentification. Séparez comptes staging et production. Documentez modèles et automatisations déclenchés. Masquez numéros et contenus dans les journaux partagés.
Et ensuite ?
Pour aller plus loin : api/whatsapp-messaging/send-whatsapp-message guides/create-whatsapp-template api/contacts
