← 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 snippet footer.

Checklist 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é (network/console).
Erreur API: vérifier data-api-url et la clé site.
Pas de conversations: tester avec un navigateur privé sans adblock.
Comportement incohérent: vider cache/CDN puis recharger le script.