Ajouter un chat d'aide à votre app avec Mon Aide Celestory

Dernière mise à jour le 22 novembre 2026

Mis à jour pour la version 6.0.30

Mon Aide Celestory est le service d'aide de Celestory, bâti sur Chatwoot. Dans votre projet, la carte Mon Aide Celestory (Chatwoot) affiche la bulle de chat de votre équipe dans l'application publiée, pour que vos utilisateurs vous écrivent sans quitter l'app. Elle peut aussi protéger par un mot de passe ou une liste d'adresses la documentation de votre équipe. Tout est facultatif : sans réglage, rien ne change.

[Capture : une application publiée avec la bulle de chat de l'équipe ouverte en bas à droite]

Ce que voit l'utilisateur

Dans votre application publiée

  • Une bulle de chat apparaît dans l'app exportée (HTML5, lien direct, mobile). Le visiteur clique dessus pour écrire à votre équipe.
  • La bulle s'affiche dans la langue de l'app, celle de la traduction du projet.
  • Le visiteur est anonyme pour votre équipe : l'app publiée n'a pas d'utilisateur Celestory connecté.
  • Celestory n'affiche pas de bandeau de cookies dans l'application publiée (voir « Vie privée et cookies » plus bas).
  • Dans l'aperçu intégré à l'éditeur, la bulle de votre équipe n'apparaît pas.
  • Une page ne charge qu'une seule bulle. Si la page charge déjà celle du support de Celestory, c'est elle qui reste.

Sur la page de jeu publique

La page de jeu publique propose un bouton Discuter avec le support (en anglais « Chat with support »). Il ouvre le chat du support de Celestory, pas celui de votre équipe. Rien n'est chargé tant que le visiteur n'a pas cliqué sur ce bouton. Voir La page de jeu publique : QR code, installation et formats d'affichage.

Dans l'éditeur Celestory

L'éditeur affiche lui aussi une bulle d'aide, celle du support de Celestory, avec le pictogramme Celestory. Elle apparaît seulement si vous avez accepté les cookies (voir plus bas). Elle s'ouvre dans votre langue. Si vous êtes connecté, l'équipe de support voit votre nom, votre e-mail et votre avatar Celestory ; à la déconnexion, la conversation est retirée du navigateur. Cette bulle n'est pas réglable par projet : celle de votre équipe n'apparaît que dans l'application publiée.

Deux états de l'éditeur Celestory. En haut, à la première visite : le bandeau de cookies en bas de la page avec les boutons Accepter les cookies et Refuser les cookies, sans bulle d'aide. En bas, après Accepter les cookies : le bandeau a disparu et la bulle d'aide, avec le pictogramme Celestory, est en bas à droite le bandeau de cookies à la première visite, puis la bulle d'aide en bas à droite une fois les cookies acceptés (les deux ne s'affichent jamais ensemble)

Où trouver le réglage

Ouvrez la fenêtre Intégrations du projet : entrée Intégrations du menu général du projet, ou raccourci Cmd + Maj + I (Mac) ou Ctrl + Maj + I (Windows, Linux). La carte Mon Aide Celestory (Chatwoot) est située après les cartes Baserow, Airtable et Make, avant Voltask. Elle s'ouvre toute seule quand la bulle est activée.

Fenêtre Intégrations du projet : cartes Identifiants Celestory, Baserow, Airtable et Make repliées, carte Mon Aide Celestory (Chatwoot) dépliée avec l'interrupteur de la bulle, le jeton du widget, l'adresse du serveur et le secret de validation d'identité la fenêtre Intégrations avec la carte Mon Aide Celestory (Chatwoot) ouverte

Afficher la bulle de votre équipe

  1. Dans Mon Aide Celestory, créez une boîte de réception de type site web pour votre équipe. Si vous renseignez la liste des domaines autorisés de cette boîte, ajoutez-y le domaine de votre application publiée.
  2. Ouvrez les réglages : Paramètres, Boîtes de réception, votre boîte, Configuration. Copiez le jeton du widget (website token) dans le code du widget.
  3. Dans Celestory, ouvrez Intégrations, carte Mon Aide Celestory (Chatwoot), et activez Afficher la bulle de chat dans l'application publiée.
  4. Collez le jeton dans Jeton du widget (website token) : lettres et chiffres seulement, de 16 à 64 caractères.
  5. Laissez Adresse du serveur Mon Aide Celestory telle quelle, ou saisissez l'adresse https de votre propre serveur Chatwoot, sans chemin (par exemple https://aide.exemple.com). Vider le champ rétablit l'adresse par défaut.
  6. Enregistrez le projet puis exportez de nouveau l'application : le réglage est copié dans l'export, un projet déjà exporté doit l'être une seconde fois.

La carte avec l'interrupteur activé, le jeton collé et l'adresse du serveur La carte avec l'interrupteur activé, le jeton collé et l'adresse du serveur.

⚠ Attention : la bulle ne s'affiche que si l'interrupteur est activé et que le jeton est valide. Si l'un des deux manque, l'application publiée n'affiche rien, sans message d'erreur.

Identifier vos utilisateurs (facultatif)

Dans votre boîte Mon Aide Celestory, vous pouvez exiger que l'identité des utilisateurs soit signée (Configuration, Sécurité). Collez alors le secret dans Secret de validation d'identité (HMAC), puis cliquez sur Enregistrer. Le secret doit contenir au moins 8 caractères. Il est conservé côté serveur, n'est jamais réaffiché, et ne figure ni dans le projet ni dans les exports. Le champ indique « Un secret est défini » ou « Aucun secret défini », et le bouton Retirer le supprime.

🔺 À savoir : les visiteurs d'une application publiée n'ont pas de compte Celestory : ils restent anonymes pour votre équipe, même avec un secret.

Protéger l'accès à votre documentation

Si votre documentation est un centre d'aide Mon Aide Celestory, la section Accès à la documentation peut la protéger. Elle n'apparaît que si le service de protection est configuré sur votre instance de Celestory : sinon, elle est absente de la carte.

  1. Saisissez l'Identifiant du centre d'aide (slug du portail) : lettres minuscules, chiffres et tirets, 64 caractères au plus.
  2. Enregistrez le projet : tant que ce n'est pas fait, les réglages d'accès restent masqués.
  3. Choisissez le Mode d'accès :
Mode Qui entre
Publique, sans protection Tout le monde
Mot de passe Qui connaît le mot de passe
Adresses e-mail autorisées Les adresses ou domaines listés
Mot de passe ou adresse e-mail autorisée L'un ou l'autre suffit
Mot de passe et adresse e-mail autorisée Les deux sont demandés
  1. Selon le mode, saisissez le mot de passe (de 8 à 128 caractères, jamais réaffiché ; laissez vide pour garder l'actuel), les adresses (une par ligne, 500 au plus) et les domaines (un par ligne, 50 au plus, par exemple exemple.fr ou *.exemple.fr).
  2. Cliquez sur Enregistrer l'accès. Retirer la protection rend la documentation publique.

Les modes avec adresse e-mail sont grisés si le service ne sait pas envoyer d'e-mails. Un centre d'aide n'est géré que par un seul projet : pour le confier à un autre, retirez d'abord sa protection.

Vie privée et cookies

  • Votre application publiée : la bulle dépose des cookies chez vos utilisateurs. Celestory n'affiche pas de bandeau de consentement dans l'app publiée : c'est à vous d'informer vos utilisateurs.
  • L'éditeur : la bulle d'aide de Celestory ne se charge qu'après un clic sur Accepter les cookies. Le bandeau dit : « Celestory utilise des cookies d'analytics et nous aide à mieux comprendre comment est utilisée notre solution. » Si vous cliquez sur Refuser les cookies, la bulle ne se charge pas ; ce choix s'applique aussi aux mesures d'audience. Le choix est mémorisé dans votre navigateur ; l'éditeur ne propose pas de réglage pour le changer ensuite : pour revoir le bandeau, effacez les données du site Celestory dans votre navigateur.
  • Sur la page de jeu publique, le chat du support ne se charge qu'au clic sur le bouton.
  • Le secret d'identité et le mot de passe de la documentation ne sont jamais renvoyés à votre navigateur.

Dépannage

Problème Solution
La bulle n'apparaît pas dans l'application Vérifiez l'interrupteur et le jeton, enregistrez, puis exportez de nouveau l'application
La bulle n'apparaît pas dans l'aperçu de l'éditeur C'est normal : elle n'apparaît que dans l'application publiée
Le jeton est refusé Il ne contient que des lettres et des chiffres (16 à 64 caractères) : recopiez-le depuis le code du widget
L'adresse du serveur est refusée Saisissez l'adresse https du serveur, sans chemin
La bulle reste vide ou refuse de s'afficher Si la boîte a une liste de domaines autorisés, vérifiez que le domaine de l'application y figure
Je ne vois pas la bulle d'aide dans l'éditeur Vous avez refusé les cookies, ou elle n'est pas activée sur votre instance
Ce centre d'aide est déjà géré par un autre projet Retirez la protection dans l'autre projet
Enregistrez le projet pour activer les réglages d'accès Enregistrez le projet, puis revenez à la carte
Le service d'accès à la documentation ne répond pas Réessayez plus tard ; si cela persiste, contactez le support

Voir aussi