Introduction
Il n'existe pas d'endpoint API broadcast unique Buzzbip. Les diffusions programmatiques envoient un modèle WhatsApp approuvé (ou SMS) à chaque contact. Chaque envoi v2 crée un whatsapp_bulk_group_id auditable dans l'historique.
Étapes
Utilisez ce modèle pour les diffusions WhatsApp ; adaptez POST /api/sms/ pour les SMS.
- Authentifiez-vous avec POST /api/login_check et Authorization: Bearer sur chaque appel API.
- Définissez l'audience : paginez GET /api/contacts/ ou synchronisez le CRM pour obtenir number et id.
- Déclenchez la diffusion : boucle POST /api/v2/whatsapp/templates/{TEMPLATE_ID}/send par destinataire (ou POST /api/sms/ pour SMS). Mettez en file côté serveur avec délais.
- Consultez les stats : GET /api/whatsapp/?whatsapp_bulk_group_id={id} par envoi, ou historique GET /api/sms/ pour SMS.
Exemple de code
Envoyez un modèle approuvé par contact. Répétez en boucle côté serveur pour toute l'audience. Conservez whatsapp_bulk_group_id de chaque réponse.
curl --request POST \
'https://app.buzzbip.com/api/v2/whatsapp/templates/1289/send' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_JWT' \
--data '{
"to": "21696816277",
"country_code": "TN",
"body_params": ["Sam"]
}'Astuce : mettez les envois en file côté serveur avec des délais entre lots. Pour SMS, utilisez POST /api/sms/ dans la même boucle.
Et ensuite ?
Pages liées : api/v2/whatsapp-templates/send-template guides/whatsapp-v2-use-cases api/contacts