Panoramica
Crea un singolo record contatto. Tutti e tre i campi del body sono obbligatori. I numeri di telefono dovrebbero includere il prefisso internazionale senza il segno più in molte integrazioni — valida secondo le regole locali. Dopo la creazione, usa l'id contatto negli invii WhatsApp tramite contact_id.
POST /api/contacts/
Chiama questo endpoint con POST e un bearer token valido.
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"}'Note d'uso
Crea un contatto. I tre campi body sono obbligatori. I numeri devono includere il prefisso paese. Dopo la creazione usa contact_id negli invii WhatsApp.
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/list-contacts api/whatsapp-messaging/send-whatsapp-message guides/sync-contacts-from-crm