Introduzione
La live chat Buzzbip si integra tramite uno snippet widget ospitato documentato nelle impostazioni account. API di sessione programmatiche esistono sotto /api/chat per integrazioni chatbot, ma non c'è un SDK JavaScript pubblico per il widget. Usa questa guida per l'embed nello storefront e la pagina Chat API per il controllo sessione lato server.
Passaggi
Segui questi passaggi per completare l'integrazione.
- Genera chiave API chatbot nelle impostazioni Buzzbip.
- Recupera config widget con GET /api/chat/config/{key}.
- Incorpora lo snippet script fornito nelle pagine del negozio.
- Avvia sessioni con POST /api/chat/start usando Bearer buz-cb-{uuid} da /integration.
- Instrada risposte agenti tramite inbox Buzzbip — nessuna API JS widget pubblica.
Dettagli
La live chat Buzzbip si integra tramite snippet widget ospitato documentato nelle impostazioni account. API di sessione sotto /api/chat, ma nessun SDK JavaScript pubblico per il widget.
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/chat api/contacts getting-started/introduction
