Introduction
Le SMS complète WhatsApp pour les marchés avec une moindre pénétration WhatsApp ou des alertes urgentes. L'API SMS Buzzbip accepte des numéros directs ou des références de contact. Respectez les limites de débit et les réglementations locales d'opt-in.
Étapes
Suivez ces étapes pour terminer l'intégration.
- Obtenez un JWT via POST /api/login_check.
- Optionnel : créez un contact avec POST /api/contacts/.
- Envoyez un SMS avec POST /api/sms/ incluant number et message.
- Vérifiez l'état de livraison dans l'historique GET /api/sms/.
Détails
Envoyez des SMS transactionnels via POST /api/sms/ avec JWT. Incluez le numéro complet avec indicatif pays et un corps de message concis conforme aux règles opérateur.
curl -X POST 'https://app.buzzbip.com/api/sms/' \
-H 'Authorization: Bearer ${TOKEN}' \
-H 'Content-Type: application/json' \
-d '{"number": "21690123456", "message": "Your order shipped!"}'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/sms api/contacts getting-started/rate-limits