Introduzione
Mantieni i contatti Buzzbip allineati al CRM così le campagne puntano agli id corretti. Esegui job di sincronizzazione lato server su schedule o webhook. Cerca per numero prima della creazione per evitare duplicati.
Passaggi
Segui questi passaggi per completare l'integrazione.
- Esporta o pagina contatti dal CRM.
- Mappa campi su firstname, lastname e number.
- Upsert via POST /api/contacts/ (gestisci duplicati secondo policy).
- Riconcilia con GET /api/contacts/?number= per lookup id.
- Usa contact_id negli invii WhatsApp e SMS.
Dettagli
Allinea i contatti Buzzbip al CRM per campagne corrette. Esegui sync lato server con gestione duplicati e retry.
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"}'Testa in staging prima degli invii in produzione.
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
Continua a imparare: api/contacts/list-contacts api/contacts/create-contact guides/send-whatsapp-message