Démarrer

Komozu est un chat pour les utilisateurs connectés de votre site ou de votre application. Le tableau de bord règle les salons, l’apparence et la modération ; votre serveur identifie chaque utilisateur avec un jeton membre. Sans jeton, le chat n’affiche qu’une invitation à se connecter sur votre site : personne n’écrit anonymement.

1. Créer un projet

Un projet correspond à votre site ou à votre application. Cliquez sur Nouveau projet : le parcours de démarrage vous guide pour les étapes suivantes.

Les projets démarrent sur le plan Free (page Plan & usage). Un compte peut avoir jusqu’à 2 projets sur le plan Free ; les projets d’une offre payante ne comptent pas.
La clé publique (kz_live_…) peut figurer sans risque dans votre site. La clé secrète (kz_sec_…) n’est affichée qu’une fois, à la fin du parcours de démarrage : gardez-la sur votre serveur, elle crée vos membres et leurs jetons.

2. Créer un salon

Un salon est une conversation : le chat général de votre club, un groupe, un événement. Vous choisissez :

un nom (l’identifiant, par exemple general, en est tiré et ne change jamais) ;
un accès :
- Membres (par défaut) : tous les membres de votre projet, c’est-à-dire tous les utilisateurs connectés que votre serveur a identifiés ;
- Privé : uniquement les membres que vous ajoutez au salon.

Dans l’onglet Réglages du salon, vous pouvez aussi activer ou désactiver Images et vidéos (activé par défaut, 10 Mo maximum par fichier). Ce réglage appartient au salon : toutes les façons de l’afficher le respectent. Avec le plan Free, seules les images peuvent être partagées : les vidéos sont incluses dans les plans payants.

3. Ajouter une intégration

Une intégration est une façon d’afficher un salon sur un site, réglée dans le tableau de bord. Un salon peut en avoir plusieurs (par exemple une dans une page et une bulle flottante). Dans la page du salon → Intégrations → Nouvelle intégration, choisissez :

Réglage	Options
Mode	Intégré (dans votre page) ou Bulle (flottante, dans un coin en bas)
Surface	Carte (encadrée, par défaut) ou Fondu (se fond dans votre page)
Hauteur	Auto (s’agrandit jusqu’à un maximum, 600 px par défaut) ou Fixe, en mode intégré uniquement
Couleur	Couleur du projet (Réglages) ou une couleur personnalisée
Apparence	Auto (suit le système du visiteur), Clair, Sombre. Les visiteurs peuvent toujours changer depuis le chat
Où allez-vous l’ajouter ?	Facultatif : le domaine de votre site, ajouté aux domaines autorisés

L’aperçu à droite est le vrai chat, avec des messages d’exemple.

4. Coller le code et écrire le jeton

Enregistrez : le panneau du code affiche le script à coller là où le chat doit apparaître (une fois, n’importe où, pour la bulle) :

<script src="https://embed.komozu.com/komozu-embed.js" data-komozu-integration="int_…" data-komozu-token="MEMBER_TOKEN" defer></script>

Votre serveur remplace MEMBER_TOKEN par le jeton de l’utilisateur connecté (vide pour un visiteur non connecté) : voir Identifier vos utilisateurs. Le code ne contient que l’identifiant de l’intégration et le jeton : modifiez l’apparence dans le tableau de bord et votre site l’applique au prochain chargement de la page, sans redéploiement.

Les développeurs disposent aussi d’un onglet React (<KomozuChat clientId="kz_live_…" channel="general" token={user.komozuToken} />, avec la même apparence) et d’un onglet JavaScript (@komozu/core).

Copier les instructions pour une IA copie le code avec des instructions pas à pas (le jeton membre fourni par votre serveur, comment vérifier que tout fonctionne) : collez-les dans votre assistant IA.

Ouvrir une page de test (dernière étape du parcours de démarrage) affiche votre chat sur un site d’exemple, avec de vrais messages. Vous y écrivez en tant que membre de test du projet, Test (créé à la première utilisation, visible dans Membres).

5. Modérer, épingler et écrire

L’onglet Conversation du salon affiche le chat en direct, tel que vos membres le voient :

Écrire dans le chat : vos messages portent le nom de votre compte (ou le nom du projet si votre compte n’en a pas) et le badge Admin. Modifiez-les depuis leur menu ⋯.
Le menu ⋯ à côté de chaque message l’épingle ou le désépingle, le supprime, ou bannit son auteur de tout le projet.

Messages épinglés : le dernier reste visible en haut du chat ; un bouton à côté ouvre la liste de tous les messages épinglés (50 par salon au maximum), à l’intérieur du chat. Un clic sur l’un d’eux ramène à la conversation, sur ce message.

Admins du salon : dans l’onglet Membres du salon (Admins pour un salon Membres), nommez admin certains de vos membres. Dans le chat, un admin porte le badge Admin et, dans le menu ⋯ de chaque message : épingler / désépingler, supprimer et retirer un membre (salons privés). Un admin n’agit que sur ce salon. Sur un salon Membres, être admin ajoute des droits, jamais d’accès ; sur un salon Privé, nommer un membre admin l’y ajoute aussi. Bannir un membre de tout le projet reste votre décision.

Signalements : chaque membre peut signaler un message depuis le chat (motif facultatif), y compris ceux des admins et les vôtres. Vous recevez un email (un au plus toutes les 15 minutes par projet) et le message attend dans la page Signalements du projet, affiché comme dans le chat avec ses photos et vidéos : supprimez-le, bannissez son auteur, ou classez le signalement pour le garder. La Vue d’ensemble vous rappelle les signalements en attente. Votre serveur peut faire de même avec reports.list / reports.dismiss.

Langue

Le chat est en anglais ou en français : il suit la langue du navigateur du visiteur (anglais pour toute autre langue). Pour imposer une langue, voir Intégration avancée.

Étapes suivantes

Créer vos membres et écrire leurs jetons : Identifier vos utilisateurs.
Limiter le chat à vos sites : Domaines autorisés.
Un salon par événement, créé depuis votre serveur : API serveur et @komozu/react.
Gérer les membres bannis dans Membres → Bannis.
Nommer des admins depuis votre serveur : channels.setRole.
Ce que Komozu conserve, et ce qu’il faut ajouter à votre politique de confidentialité : Données personnelles (RGPD).