Vue d'ensemble
Envoyez un message WhatsApp avec un modèle approuvé. Fournissez template_id et soit contact_id soit phone_number (avec country_code si nécessaire). L'API accepte le message de façon asynchrone ; consultez l'historique pour l'état de livraison.
POST /api/whatsapp/
Appelez ce endpoint avec POST et un token bearer valide.
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}'Notes d'utilisation
L'API WhatsApp gère l'envoi de modèles approuvés et l'historique des messages via /api/whatsapp/. Send a WhatsApp message using an approved template. Provide template_id and either contact_id or phone_number (with country_code as needed). The API accepts the message asynchronously; check history for delivery state.
Utilisez pagination et filtres pour réduire la taille des réponses.
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 ?
Pages liées : api/whatsapp-templates/send-template api/contacts guides/send-whatsapp-message