Panoramica
Buzzbip applica limiti di frequenza per proteggere la piattaforma e rispettare le policy Meta e degli operatori. In caso di superamento, viene restituito un errore JSend. Implementa backoff esponenziale e accoda invii massivi lato server.
Best practice
Metti in cache letture pesanti dove sicuro (lista template, profilo). Usa paginazione (cursor/page). Evita loop stretti su invii WhatsApp/SMS.
Accoda invii WhatsApp e SMS lato server con ritardi tra i batch.
Gestione del throttling
Con errori di rate limit, pausa il worker, attendi e riprova con jitter. Non iterare subito — peggiori il throttling.
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
Argomenti correlati: getting-started/errors api/whatsapp-messaging api/sms