← Retour Docs

Installation widget

Ajoutez le script avant </body> :

<script
  src="https://widget.setchat.co/setchat.iife.js"
  data-api-key="site_xxx"
  data-api-url="https://api.setchat.co"
  defer
></script>

React / Vite : placez-le dans index.html.
Astro : placez-le dans le layout global.
WordPress : plugin officiel ou extrait de code en pied de page.

Liste de contrôle d'installation

Créer un site SetChat dédié (clé API par site).
Installer le script sur l'environnement de test.
Vérifier ouverture widget desktop + mobile.
Valider envoi/réception message en conditions réelles.
Déployer ensuite sur production.

Multi-sites et bonnes pratiques

Utilisez une clé API différente par domaine/site.
Ne mélangez pas staging et production sur la même clé.
Versionnez vos snippets d'intégration côté frontend.
Documentez qui possède la clé et où elle est utilisée.

Dépannage rapide

Widget absent : vérifier que le script est bien chargé (réseau / console).
Erreur API : vérifier data-api-url et la clé site.
Pas de conversations : tester avec un navigateur privé sans bloqueur de publicités.
Comportement incohérent : vider le cache / le CDN puis recharger le script.