Introduction
Gardez les contacts Buzzbip alignés avec votre CRM pour que les campagnes ciblent les bons identifiants. Exécutez les jobs de synchronisation côté serveur selon un planning ou un webhook. Recherchez par numéro avant la création pour éviter les doublons.
Étapes
Suivez ces étapes pour terminer l'intégration.
- Exportez ou paginez les contacts depuis votre CRM.
- Mappez les champs vers firstname, lastname et number.
- Upsert via POST /api/contacts/ (gérez les doublons selon votre politique).
- Réconciliez avec GET /api/contacts/?number= pour obtenir l'id.
- Utilisez contact_id dans les envois WhatsApp et SMS.
Détails
Gardez les contacts Buzzbip alignés avec votre CRM pour cibler les bonnes campagnes. Exécutez la synchronisation côté serveur avec gestion des doublons et reprise sur erreur.
curl -X POST 'https://app.buzzbip.com/api/contacts/' \
-H 'Authorization: Bearer ${TOKEN}' \
-H 'Content-Type: application/json' \
-d '{"firstname": "Jane", "lastname": "Doe", "number": "21690123456"}'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/contacts/list-contacts api/contacts/create-contact guides/send-whatsapp-message