Vue d'ensemble
Créez un enregistrement de contact unique. Les trois champs du corps sont obligatoires. Les numéros doivent inclure l'indicatif pays sans signe plus dans de nombreuses intégrations — validez selon vos règles locales. Après création, utilisez l'id du contact dans les envois WhatsApp via contact_id.
POST /api/contacts/
Appelez ce endpoint avec POST et un token bearer valide.
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"}'Notes d'utilisation
Créez un contact. Les trois champs du corps sont obligatoires. Les numéros doivent inclure l'indicatif pays — validez selon vos règles locales. Après création, utilisez l'id du contact dans les envois WhatsApp via contact_id.
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/contacts/list-contacts api/whatsapp-messaging/send-whatsapp-message guides/sync-contacts-from-crm