Panoramica
Recupera un elenco paginato di contatti. Usa il parametro number per cercare un numero specifico. I risultati sono limitati all'utente autenticato. Combina con job di sincronizzazione CRM per riconciliare gli ID esterni con gli id contatto Buzzbip usati negli invii WhatsApp.
GET /api/contacts/
Chiama questo endpoint con GET e un bearer token valido.
curl -X GET 'https://app.buzzbip.com/api/contacts/?currentPage=1&limit=20&number=' \
-H 'Authorization: Bearer ${TOKEN}' \
-H 'Content-Type: application/json'Note d'uso
Recupera elenco paginato di contatti. Usa il parametro number per cercare un numero. Rispetta i parametri di paginazione documentati.
Usa paginazione e filtri per ridurre la dimensione del payload.
Note di integrazione
Integrando questo endpoint Buzzbip, usa https://app.buzzbip.com come host di produzione. Ottieni un JWT da POST /api/login_check e invia Authorization: Bearer su ogni richiesta. Verifica che User.hasApiAccess sia abilitato nell'admin Buzzbip. Analizza le risposte JSend (status, message, data). Per i plugin e-commerce, invia anche x-api-key, x-platform-type e x-base-uri. Rispetta gli slash finali su POST /api/contacts/ e POST /api/whatsapp/. Implementa retry con backoff in caso di rate limit. Conserva le credenziali lato server e riautenticati prima della scadenza JWT (3600 s).
Sicurezza
Best practice: credenziali solo lato server, TLS obbligatorio, monitoraggio autenticazioni fallite. Separa account staging e produzione. Documenta template e automazioni. Redigi numeri e contenuti nei log condivisi.
Prossimi passi
Pagine correlate: api/contacts/create-contact api/whatsapp-messaging/send-whatsapp-message guides/sync-contacts-from-crm