Vue d'ensemble
Récupérez une liste paginée de contacts. Utilisez le paramètre number pour rechercher un numéro précis. Les résultats sont limités à l'utilisateur authentifié. Combinez avec des jobs de synchronisation CRM pour réconcilier les identifiants externes avec les id de contact Buzzbip utilisés dans les envois WhatsApp.
GET /api/contacts/
Appelez ce endpoint avec GET et un token bearer valide.
curl -X GET 'https://app.buzzbip.com/api/contacts/?currentPage=1&limit=20&number=' \
-H 'Authorization: Bearer ${TOKEN}' \
-H 'Content-Type: application/json'Notes d'utilisation
Récupérez une liste paginée de contacts. Utilisez le paramètre number pour rechercher un numéro précis. Respectez les paramètres de pagination documentés.
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/create-contact api/whatsapp-messaging/send-whatsapp-message guides/sync-contacts-from-crm
