Introduction
Le chat en direct Buzzbip s'intègre via un extrait de widget hébergé documenté dans les paramètres de votre compte. Des API de session programmatiques existent sous /api/chat pour les intégrations chatbot, mais il n'y a pas de SDK JavaScript public pour le widget. Utilisez ce guide pour l'intégration boutique et la page Chat API pour le contrôle de session côté serveur.
Étapes
Suivez ces étapes pour terminer l'intégration.
- Générez une clé API chatbot dans les paramètres Buzzbip.
- Récupérez la config widget avec GET /api/chat/config/{key}.
- Intégrez l'extrait script fourni sur vos pages boutique.
- Démarrez les sessions avec POST /api/chat/start en Bearer buz-cb-{uuid} depuis /integration.
- Routez les réponses agents via l'inbox Buzzbip — pas d'API JS widget publique.
Détails
Le chat en direct Buzzbip s'intègre via un extrait de widget hébergé documenté dans vos paramètres. Des API de session existent sous /api/chat, mais il n'y a pas de SDK JavaScript public pour le widget.
Testez en staging avant les envois ou synchronisations en production.
Notes d'intégration
Lors de l'intégration de ce endpoint Buzzbip, utilisez https://app.buzzbip.com comme hôte de production. Obtenez un JWT via POST /api/login_check et envoyez Authorization: Bearer sur chaque requête. Vérifiez que User.hasApiAccess est activé dans l'admin Buzzbip. Analysez les réponses JSend (status, message, data). Pour les plugins e-commerce, envoyez aussi x-api-key, x-platform-type et x-base-uri. Respectez les slashs finaux sur POST /api/contacts/ et POST /api/whatsapp/. Implémentez des nouvelles tentatives avec backoff en cas de limite de débit. Stockez les identifiants côté serveur et réauthentifiez-vous avant l'expiration du JWT (3600 s).
Sécurité
Bonnes pratiques : credentials uniquement côté serveur, TLS obligatoire, surveillance des échecs d'authentification. Séparez comptes staging et production. Documentez modèles et automatisations déclenchés. Masquez numéros et contenus dans les journaux partagés.
Et ensuite ?
Pour aller plus loin : api/chat api/contacts getting-started/introduction