Démarrer
Documentation de Zean
Tout pour ajouter le chat de Zean à votre site ou à votre application mobile, et le relier à votre serveur.
Mis à jour le 28 octobre 2026
Le chat de Zean se place dans votre site ou votre application. Vos Contacts y écrivent, et les membres de votre équipe leur répondent depuis la boîte de réception de votre App.
Choisir votre installation
Un site peut coller le code d’installation, ou installer le SDK de son framework. Les deux chargent le même chat : ses mises à jour arrivent sans rien changer de votre côté.
| Votre site ou application | Paquet | Page |
|---|---|---|
| Tout site HTML | code d’installation | Installer sur un site web |
| Next.js, React Router, TanStack Start, React | @zean-chat/react | Installer avec React |
| Nuxt, Vue | @zean-chat/vue | Installer avec Vue |
| Expo, React Native CLI | @zean-chat/react-native | Installer avec React Native |
| WordPress, Shopify | code d’installation | Installer sur WordPress ou Shopify |
| Tout site, sans framework | @zean-chat/js | Référence du site web et de @zean-chat/js |
Le même chat partout
Chaque SDK donne les mêmes possibilités, avec les noms de votre framework :
- Ouvrir et fermer le chat depuis vos boutons : Ouvrir le chat.
- Afficher le nombre de réponses non lues : Réponses non lues.
- Passer l’ID de la personne connectée, pour qu’elle retrouve sa Conversation sur chacun de ses appareils : Identifier vos Contacts.
- Envoyer des attributs, comme une ville ou un nombre de commandes : Attributs.
- Choisir la langue du chat, français ou anglais : Langue.
La clé de votre App
Chaque App a une clé publique, par exemple app_your_app_key. Elle désigne votre App dans le code et peut apparaître sans risque dans votre site ou votre application. Elle se trouve, avec le code prêt à copier, dans Paramètres de l’App > Développeurs > Démarrage.
Ouverts depuis Paramètres de l’App > Développeurs > Démarrage, les exemples de cette documentation affichent la clé de votre App. Le secret de signature du webhook, lui, reste sur votre serveur et n’apparaît jamais ici : voir Clés et secrets.
Où le chat s’affiche
Sur un site, le chat ne s’affiche que sur le domaine de votre App, www. compris, et toujours sur localhost : vous testez sur votre ordinateur sans rien régler. Dans une application, il ne s’affiche que dans l’application iOS et l’application Android de votre App, et toujours dans Expo Go. Saisissez-les en premier, dans Paramètres de l’App > Développeurs > Domaine, apps et pages : sans eux, le chat reste caché, et votre clé copiée ailleurs n’affiche rien.
Comment lire cette documentation
- Démarrer : Démarrage rapide, le chat en un prompt pour votre assistant IA, ou en trois étapes.
- Installer : une page par type de site ou d’application.
- Guides : une tâche par page, avec un onglet par SDK. L’onglet choisi vous suit de page en page.
- Votre serveur : webhooks, leur signature, leurs tests sur votre ordinateur avec la CLI Zean, et les clés, avec des exemples en Node.js, PHP et Python.
- Référence : chaque option et chaque méthode de chaque SDK.
- Aide : Dépannage quand le chat ne s’affiche pas.