Résumé ◀▼
Vous pouvez connecter Guru comme source de connaissances externe pour synchroniser le contenu publié de collections spécifiées. Gérez les permissions en configurant les permissions des lecteurs, en resynchronisant le contenu manuellement ou en supprimant des connexions. La synchronisation met le contenu à jour toutes les 24 heures, pour refléter les modifications du contenu. Cette intégration nécessite des permissions d’administrateur et utilise l’e-mail et les tokens API pour un accès sécurisé au contenu autorisé uniquement.
Vous pouvez connecter Guru à votre compte Zendesk pour rendre le contenu disponible partout où le contenu externe est utilisé. Quand vous connectez Guru comme source de connaissances externe, vous pouvez ingérer le contenu des fiches publiées des collections que vous spécifiez pendant la configuration.
Vous devez être un administrateur Connaissances pour configurer et gérer les connexions de contenu externe dans Zendesk. Vous devez être un administrateur pour créer la clé API nécessaire pour autoriser le contenu synchronisé dans Guru. Le connecteur Guru est authentifié avec votre e-mail et votre clé API, ce qui garantit que vous pouvez uniquement synchroniser le contenu auquel vous avez accès dans Guru.
Configuration d’une connexion Guru
Vous pouvez configurer une connexion Guru pour connecter et synchroniser le contenu de vos collections Guru. Une fois que vous avez connecté une collection Guru, vous pouvez configurer vos workflows pour qu’ils utilisent ce contenu externe. Quand vous synchronisez une collection Guru, les fiches publiées avec du contenu sont automatiquement synchronisées.
- Dans l’Administrateur de Connaissances, cliquez sur Gérer les articles (
) dans la barre latérale. - Cliquez sur Contenu externe > Connexions.
- Dans la section Sources disponibles, cliquez sur Connecter pour la fiche Guru.
- Cliquez sur Continuer.
- Dans l’onglet Authentification, saisissez les identifiants ci-dessous pour vous connecter à Guru, puis cliquez sur Continuer :
- E-mail : l’adresse e-mail que vous utilisez pour accéder à votre compte Guru. Vous devez être un administrateur Guru pour créer une connexion et vous pouvez uniquement synchroniser le contenu auquel vous pouvez accéder dans Guru.
- Token API : le token utilisateur associé à votre adresse e-mail dans Guru. Ce token vous fournit un accès en lecture/écriture dans Guru basé sur vos permissions de compte existantes. Cliquez sur Gérer > Accès à l’API au-dessus de ce champ pour accéder à la page dans Guru sur laquelle vous pouvez générer le token utilisateur. Pour en savoir plus, consultez la section sur l’utilisation de l’API Guru du centre d’aide Guru.
- Dans l’onglet Définir la portée, dans le champ Collection, sélectionnez la collection Guru qui contient le contenu publié que vous voulez publier, puis cliquer sur Synchroniser.
-
Guru est ajouté à votre page Connexions et la connexion de votre site commence.
Ajout ou suppression de contenu de votre connexion Guru
Quand vous configurez la connexion Guru, vous spécifiez les collections auxquelles vous voulez vous connecter. Vous pouvez créer plusieurs connexions Guru, mais chaque connexion ne contient qu’une seule collection. Toutes les fiches publiées avec du contenu dans la collection sont synchronisées avec la connexion.
Gestion des sites Guru connectés à votre compte Zendesk
Une fois que vous avez créé une connexion Guru, vous pouvez consulter les informations sur cette connexion, configurer les permissions des lecteurs pour le contenu et resynchroniser ou supprimer la connexion manuellement.
Consultation des détails de votre connexion Guru
Vous pouvez utiliser le volet d’informations pour consulter les informations sur votre connexion Guru, sa date de création et son créateur, ainsi que la date de sa dernière synchronisation.
- Dans l’Administrateur de Connaissances, cliquez sur Gérer les articles () dans la barre latérale.
- Cliquez sur Contenu externe > Connexions.
- Cliquez sur le menu des options (
) sur la ligne de la connexion que vous voulez gérer, puis sélectionnez Gérer.
- Consultez les détails de la connexion :
- Créé : la date de création de la connexion
- Connecté par : le nom de l’administrateur Connaissances qui a créé la connexion
- Éléments : le nombre de pages connectées sur le site
- Statut : le statut de synchronisation
- Dernière synchronisation : l’heure de la dernière synchronisation (les synchronisations s’exécutent automatiquement toutes les 24 heures, mais vous pouvez aussi les initier manuellement).
Gestion des permissions des lecteurs pour le contenu Guru
Vous pouvez configurer les permissions de lecteur pour définir qui peut voir votre contenu Guru connecté dans vos workflows Zendesk.
- Dans l’Administrateur de Connaissances, cliquez sur Gérer les articles () dans la barre latérale.
- Cliquez sur Contenu externe > Connexions.
- Cliquez sur le menu des options () sur la ligne de la connexion que vous voulez gérer, puis sélectionnez Gérer.
- Sous Permissions de consultation, sélectionnez l’une des options suivantes pour définir quels segments d’utilisateurs peuvent consulter le contenu de cet article :
-
Visible uniquement par les segments d’utilisateurs sélectionnés : sélectionnez l’un des segments d’utilisateurs ci-dessous. Avec les éditions Enterprise, vous pouvez en sélectionner jusqu’à 10 :
- Utilisateurs connectés : inclut les utilisateurs internes et externes qui créent un compte et se connectent à votre centre d’aide.
-
Agents et administrateurs : inclut uniquement les membres de l’équipe pour vous permettre de créer du contenu réservé à une utilisation interne. Remarque – Les agents light sont inclus à ce segment. Pour une liste des permissions des agents light, consultez Configuration des permissions des agents light.
- Segment d’utilisateurs personnalisé : vous permet de restreindre l’accès en fonction de marqueurs, d’organisations ou de groupes en appliquant des segments d’utilisateurs. Consultez Création de segments d’utilisateurs pour restreindre l’accès).
- Visible par tous : inclut tous les utilisateurs qui visitent votre centre d’aide et ne nécessite pas de connexion.
-
Visible uniquement par les segments d’utilisateurs sélectionnés : sélectionnez l’un des segments d’utilisateurs ci-dessous. Avec les éditions Enterprise, vous pouvez en sélectionner jusqu’à 10 :
- Cliquez sur Enregistrer.
Resynchronisation manuelle du contenu Guru
Quand vous connectez Guru comme source de contenu externe, un processus de synchronisation s’exécute toutes les 24 heures pour mettre à jour le contenu nouveau ou modifié au sein du site. Vous pouvez effectuer une resynchronisation manuelle quand vous le souhaitez pour initier une autre synchronisation, mais cela peut prendre 24 heures.
- Sur la page Connexions, cliquez sur le menu des options () pour la connexion que vous voulez synchroniser.
- Sélectionnez Synchroniser à nouveau.
La connexion Guru se synchronise immédiatement et la colonne Dernière synchronisation est mise à jour pour refléter l’heure de la synchronisation la plus récente.
Déconnexion d’une connexion Guru
Vous pouvez supprimer la connexion à Guru si vous ne voulez plus en synchroniser le contenu. Si vous supprimez la connexion, tout le contenu du site dans cette connexion est supprimé.
Quand vous supprimez une connexion, le contenu connexe n’est plus disponible là où du contenu externe est utilisé.
- Sur la page Connexions, cliquez sur le menu des options () pour la connexion Guru que vous voulez déconnecter.
- Sélectionnez Supprimer la connexion.
- Lisez le message, puis cliquez sur Supprimer la connexion.
La connexion Guru est supprimée de la liste des connexions et n’est plus disponible comme source de contenu externe.