Centre d'aide · Guide des accès

Donnez à chaque client les bonnes réponses

Montrez chaque contenu aux personnes concernées. Utilisez les audiences de base pour les visiteurs et les clients connectés, ou créez des groupes à partir d'attributs vérifiés comme le forfait ou le rôle.

1. Connecter la connexion des clients vérifiés

Un propriétaire ou un admin configure l'accès sous Canaux → votre canal → Centre d'aide. Le développeur de votre application connecte une seule fois l'identité client. Pour un contenu réservé aux visiteurs, vous pouvez choisir Visiteurs sans créer de processus de connexion.

Ouvrez l'onglet Chat en direct du canal. Connectez un site web si le canal n'en a pas, puis repérez Identité visiteur sécurisée.
Choisissez Vérification facultative ou Exiger une preuve pour l'identification, sélectionnez Générer un secret de signature et conservez-le uniquement sur votre backend. Si un secret est déjà configuré, choisissez Facultatif : vérifier lorsqu'un JWT est présent ou Obligatoire pour identify et les attributs sous Mode de vérification. Exiger une preuve pour l'identification autorise toujours le chat anonyme ; c'est l'audience du centre d'aide qui contrôle l'accès au contenu.
Une fois qu'un client est authentifié par votre application, votre serveur signe un jeton d'identité de courte durée (JWT) contenant user_id, email, iat, exp et des attributs fiables. Lisez le forfait et le rôle depuis votre propre base de données. Les attributs non signés du navigateur et les champs de contact ne peuvent pas accorder d'accès.
Transmettez le JWT au widget, et connectez une action de connexion au centre d'aide pour les personnes qui ouvrent les pages hébergées ou votre domaine personnalisé. Utilisez le tutoriel développeur ci-dessous pour le code exact.

Générer et envoyer une identité vérifiée

Pour l'exemple ci-dessous, les attributs signés sont :

JSON · attributs dans le JWT signé

{"plan":"pro","role":"admin"}

2. Créer une audience Clients Pro

Revenez au Centre d'aide. Dans Audiences, sélectionnez Nouvelle audience (le bouton plus), ou Créer une audience s'il s'agit de votre premier groupe.
Saisissez Clients Pro comme nom. Laissez Correspondance sur Toutes les règles.
Pour Attribut, saisissez plan. Réglez Condition sur fait partie de et Type de valeur sur Texte.
Saisissez pro et business sur des lignes séparées dans Valeurs · une par ligne. Sélectionnez Enregistrer l'audience.
Pour créer un groupe Admins, recommencez avec l'attribut role, la condition est, le type de valeur Texte et la valeur admin.

Comment les règles s'appliquent : Toutes les règles exige que chaque condition de cette audience soit remplie ; Au moins une règle en exige au moins une. Vous pouvez ajouter jusqu'à 10 règles. Toutes les audiences héritées doivent quand même correspondre, même si une audience donnée utilise Au moins une règle.

Le texte est sensible à la casse. Le nombre 5 diffère du texte « 5 » ; choisissez Nombre pour des comparaisons comme est au moins. Un attribut manquant ne satisfait jamais une comparaison, y compris n'est pas. a une valeur exclut null ; n'a pas de valeur correspond à un attribut manquant ou null. Les clés d'attribut commencent par une lettre et utilisent des lettres, des chiffres ou des tirets bas, jusqu'à 64 caractères ; les clés d'identité réservées comme email ne sont pas des attributs.

3. Appliquer l'audience là où vous en avez besoin

Un article

Ouvrez l'article, réglez Qui peut lire ceci ? sur Clients vérifiés, puis choisissez Clients Pro sous Audience client. Sélectionnez Publier pour un nouvel article ou Enregistrer les modifications pour un article en ligne. Si l'accès de base est hérité, il est en lecture seule ; vous pouvez tout de même choisir une audience client supplémentaire.

Toute une catégorie

Sélectionnez le crayon à côté de la catégorie sous Catégories. Choisissez Clients vérifiés et une audience client, puis Enregistrer. Chaque article de cette catégorie doit satisfaire cette restriction en plus de la sienne.

Un centre d'aide privé

Dans Accès au centre d'aide, choisissez Clients vérifiés. Laissez Audience client sur Tous les clients vérifiés, ou choisissez Clients Pro pour réserver tout le centre à ce groupe.
Saisissez la page de connexion de votre application comme URL de connexion client, par exemple https://app.example.com/login. Il s'agit de la page de connexion de votre application, pas de la connexion du personnel Sonny.
Après la connexion, votre application doit envoyer le client vers le point de terminaison d'authentification du centre d'aide avec un JWT signé récent. L'URL de connexion seule ne suffit pas à établir cette connexion.
Sélectionnez Enregistrer l'accès. Laissez le centre en ligne pour que les clients autorisés puissent l'ouvrir.

Connecter la connexion hébergée et sur domaine personnalisé

Les restrictions s'additionnent. Si le centre d'aide exige Clients Pro et qu'une catégorie exige Admins, ses articles exigent les deux. Choisir Tout le monde sur un article ne passe pas outre la catégorie. Visiteurs et Clients vérifiés sont des audiences de base mutuellement exclusives.

4. Prévisualiser, puis vérifier une vraie session client

En haut du Centre d'aide, changez Afficher en tant que en Visiteur, Client vérifié ou Client avec attributs….
Pour Client avec attributs…, saisissez l'exemple JSON ci-dessus. Les lignes grisées sont masquées pour ce lecteur ; le décompte tient compte du statut de publication et de toutes les restrictions héritées. Tous les articles ramène à la liste de rédaction complète.
Utilisez le tableau ci-dessous pour tester un centre d'aide réservé aux clients Pro contenant une catégorie réservée aux admins. Modifiez le forfait et le rôle d'exemple pour vérifier chaque résultat.
Ouvrez un vrai navigateur déconnecté, puis connectez-vous avec chaque client de test. Vérifiez la navigation, la recherche, une URL d'article directe et l'onglet Aide du widget. La prévisualisation des attributs ne vous connecte pas et ne modifie pas l'accès d'un client.

Accès attendus pour un centre réservé aux clients Pro et une catégorie réservée aux admins
Lecteur	Centre d'aide	Article de la catégorie Admin
Visiteur déconnecté	Page de connexion	Masqué
Client Pro, admin	Peut lire	Peut lire
Client Pro, membre	Peut lire	Masqué
Client gratuit, admin	Message d'accès	Masqué

Les articles refusés sont exclus des résultats et leurs URL directes renvoient « introuvable ». Un centre d'aide privé affiche une page de connexion ou un message d'accès à vos couleurs au lieu de son contenu. Son sitemap est vide et l'indexation est interdite ; les articles réservés aux visiteurs sont aussi exclus des sitemaps publics. Les réponses de l'IA et la recherche de Copilot appliquent les mêmes règles à l'identité client vérifiée de la conversation.

Les URL des images importées sont publiques. Restreindre un article ne protège pas ses images si quelqu'un dispose déjà de leur URL.

Modifier ou supprimer une audience

Modifiez une audience avec son bouton crayon, puis sélectionnez Enregistrer l'audience. Les changements de règles s'appliquent dès la requête suivante. Des attributs client mis à jour nécessitent un nouveau JWT ou une nouvelle connexion au centre d'aide ; les sessions lecteur signées existantes conservent leurs attributs jusqu'à expiration.

Pour retirer une restriction nommée à un seul endroit, sélectionnez Tous les clients vérifiés (ou Tout le monde dans l'audience héritée) sous Audience client, puis enregistrez. Pour rendre ce contenu public, choisissez aussi Tout le monde sous Qui peut lire ceci ? et vérifiez que ses parents autorisent l'accès public.

Le bouton de suppression de l'audience indique combien d'articles, de catégories et de centres d'aide l'utilisent. La suppression retire les règles d'attributs de ce groupe ; le contenu lié reste réservé aux clients vérifiés et conserve les autres restrictions héritées. Les clients qui ne satisfaisaient pas la règle supprimée peuvent alors obtenir l'accès. Vérifiez ces attributions avant de confirmer.

Dépanner les accès

Un client vérifié voit la page de connexion: Vérifiez le mode de vérification dans l'onglet Chat en direct de ce canal, l'expiration du JWT, le secret de signature et l'URL de connexion du centre d'aide. La connexion du personnel au tableau de bord est distincte de la connexion client.
Le client est connecté mais ne peut pas lire une réponse: Vérifiez chaque audience héritée ainsi que les noms, types et valeurs exacts des attributs signés. Un client Pro peut tout de même échouer à la règle Admin d'une catégorie.
Qui peut lire ceci ? est désactivé: Le centre d'aide ou la catégorie définit l'audience de base. Modifiez ce parent pour la changer ; utilisez Audience client pour restreindre davantage l'accès vérifié.
Aucun lecteur correspondant s'affiche: Les restrictions réservées aux visiteurs et celles réservées aux clients vérifiés sont incompatibles. Utilisez l'accès hérité lorsqu'il est proposé, ou corrigez d'abord les paramètres du centre d'aide ou de la catégorie.
Un changement de forfait n'a pas encore modifié l'accès: Émettez un nouveau JWT avec les attributs à jour et identifiez de nouveau le client dans le widget. Pour les pages hébergées ou sur domaine personnalisé, refaites la connexion au centre d'aide. Les cookies existants conservent leurs attributs signés jusqu'à expiration.
Un article est absent de la recherche ou du widget: Vérifiez qu'il est publié, que le centre est en ligne, que la Recherche est activée pour les résultats de recherche et que le lecteur satisfait toutes les restrictions. Un onglet Aide vide est masqué.