Connexion de sources de connaissances externes à votre compte Zendesk

Suite, toutes les versions

Team, Growth, Professional, Enterprise ou Enterprise Plus

Support avec

Connaissances Professional ou Enterprise

Résumé ◀▼

Connectez des sources de contenu externe pour que ce contenu soit disponible pour les recherches et puisse être utilisé dans l’ensemble des expériences de connaissances. Vous pouvez ajouter jusqu’à 50 sources, puis gérer la synchronisation, les permissions et l’authentification pour les connecteurs, comme Box, Confluence, Google Drive, Jira, Notion, SharePoint, etc. Un administrateur de Connaissances peut configurer les sources et les mises à jour sont importées lors de la synchronisation suivante.

Vous pouvez connecter votre contenu externe à votre compte Zendesk, quelle que soit votre édition. Cependant, les limites de stockage des données externes varient selon l’édition. Consultez Gestion du stockage des données dans votre compte Zendesk.

Vous pouvez connecter jusqu’à 50 sources de contenu externe à votre compte Zendesk et rendre le contenu disponible partout où du contenu externe est utilisé.

Cet article aborde les sujets suivants :

Connexion du contenu externe avec un connecteur de connaissances
Référence pour l’authentification des connecteurs de connaissances

Connexion du contenu externe avec un connecteur de connaissances

Vous pouvez connecter une source de contenu externe à votre compte Zendesk pour rendre le contenu disponible partout où du contenu externe est utilisé. Chaque connecteur de connaissances a une page d’authentification spécifique que vous pouvez configurer avant de la connecter. Une fois la connexion établie, vous pouvez utiliser la page Connexion pour gérer la connexion. Les mises à jour ou les ajouts apportés à ces éléments sont ingérés dans Zendesk lors de la synchronisation suivante.

Quand vous connectez des sources de connaissances externes à Zendesk, elles apparaissent comme sources de connaissances externes dans l’administrateur de Connaissances.

Vous devez être un administrateur Connaissances pour configurer et gérer les connexions de contenu externe.

Pour connecter du contenu externe avec un connecteur de connaissances

Dans l’administrateur 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 source de connaissances que vous voulez connecter.
Lisez le message et cliquez sur Continuer pour commencer la configuration de la connexion.
Saisissez les informations d’authentification requises pour accorder à Zendesk la permission d’accéder au contenu de la source de connaissances.
Les détails d’authentification dépendent de chaque connecteur. Consultez Référence pour l’authentification des connecteurs de connaissances pour les informations spécifiques au connecteur que vous voulez configurer.
Cliquez sur Synchroniser.
Le connecteur de connaissances est ajouté à la page Connexions et la synchronisation commence. Pour gérer les connexions existantes, consultez Gestion des connexions de sources de connaissances externes.

Référence pour l’authentification des connecteurs de connaissances

Le tableau suivant répertorie les champs d’authentification requis pour chaque connecteur. Quand vous vous connectez à un système, connectez-vous avec un compte utilisateur disposant des permissions adéquates pour le contenu que vous voulez synchroniser avec Zendesk.

Connecteur	Détails d’authentification et de connexion
Amazon S3	Dans l’onglet Authentification, configurez ce qui suit : Identifiant de la clé d’accès et Clé d’accès secrète : identifiants AWS IAM permettant d’accéder par programmation au compartiment Amazon S3 que vous souhaitez synchroniser. Les clés d’accès AWS sont générées via la console AWS Identity and Access Management (IAM). Consultez AWS Developer Guide pour en savoir plus. Région AWS : région AWS où est stocké votre compartiment. Dans l’onglet Définir la portée, configurez ce qui suit : Nom du compartiment : le nom du compartiment Amazon S3 que vous voulez synchroniser. Le connecteur synchronisera tous les types de fichiers pris en charge (.docx, .xlsx et .md), ainsi que les dossiers et sous-dossiers contenus dans un compartiment.
Box	Connectez-vous à Box avec un compte utilisateur disposant des permissions adéquates pour le contenu que vous voulez synchroniser avec Zendesk. Configurez ce qui suit : Dossiers racine : le dossier racine que vous voulez synchroniser avec votre compte Zendesk. Vous pouvez uniquement sélectionner les dossiers de haut niveau dans le répertoire racine, pas les sous-dossiers ni des fichiers individuels dans le répertoire racine. Quand vous sélectionnez un répertoire racine, la synchronisation inclut automatiquement tous les sous-dossiers et types de fichiers prises en charge (docx, .xlsx, .html, and .md) qui se trouvent dans ce dossier. Quand vous configurez une connexion Box, vous devez sélectionner des dossiers parents qui résident dans le répertoire racine de votre base de connaissances Box. Quand le connecteur effectue la synchronisation, tout le contenu pris en charge au sein de ce dossier parent (y compris les sous-dossiers et les fichiers pris en charge) est synchronisé avec votre compte Zendesk.
Confluence	Connectez-vous à Confluence avec un compte utilisateur disposant des permissions adéquates pour le contenu que vous voulez synchroniser avec Zendesk. Configurez ce qui suit : Site Confluence : le site Confluence que vous voulez connecter. Espaces : les espaces que vous voulez connecter. Seuls les 20 premiers espaces s’affichent dans le menu déroulant (par ordre alphabétique). Pour sélectionner un espace qui n’est pas affiché dans le menu, commencez à saisir son nom dans le champ de recherche, puis sélectionnez-le quand il s’affiche. Pour supprimer un espace, cliquez sur la croix (X) sur le marqueur de l’espace. Les connexions à des espaces personnels dans Confluence ne sont pas autorisées.
Contentful	Dans l’onglet Authentification, configurez ce qui suit : Identifiant de l’espace Contentful : l’identifiant de l’espace Contentful que vous voulez connecter à Zendesk. Pour savoir comment trouver l’identifiant de l’espace Contentful, consultez le centre d’aide Contentful. Clé API : (Content Delivery API - access token dans Contentful) identifiant qui accorde un accès programmatique pour la lecture du contenu stocké dans votre espace Contentful. Dans l’onglet Ajouter une URL publique, configurez ce qui suit : *Format d’URL (obligatoire)** : le format d’URL pour la page publique qui héberge votre contenu Contentful. Le format d’URL peut être : un champ contenant l’URL complète, par exemple `fields.url` une chaîne d’URL avec une ou plusieurs balises, par exemple `https://zendesk.com/{fields.slug}` Les balises peuvent référencer les champs de saisie (`fields.<fieldId>`) et les métadonnées de saisie (`sys.<key>`), comme `sys.id`. Le connecteur de connaissances ingère uniquement le contenu qui peut être associé à une URL. S’il est impossible de créer l’URL à partir du format d’URL, car il manque des champs obligatoires, l’enregistrement est ignoré pendant la synchronisation du contenu.
Document360	Dans l’onglet Authentification, configurez ce qui suit : Sélectionner un serveur : sélectionnez la région du serveur sur lequel est hébergé votre compte Document360 (UE, US ou Privé). Si vous sélectionnez Privé, vous serez aussi invité à saisir le sous-domaine pour votre compte privé Document360. Token API : saisissez le token API que vous avez créé dans votre compte Document360 pour cette connexion. Dans l’onglet Définir la portée, configurez ce qui suit : Espace de travail : sélectionnez un espace de travail public que vous voulez synchroniser. Langues : sélectionnez la langue pour la base de connaissances que vous voulez synchroniser. Cette connexion connectera le contenu Document360 dans la langue que vous spécifiez ici uniquement. Vous devez créer une nouvelle connexion pour chaque langue. Catégories : sélectionnez les catégories que vous voulez synchroniser. Chaque catégorie ou sous-catégorie que vous sélectionnez s’affiche sous la forme d’un marqueur dans le champ Catégories. Quand vous sélectionnez une catégorie, vous ne synchronisez que le contenu au niveau de la catégorie, pas ses sous-catégories. Vous devez sélectionner les catégories ET les sous-catégories qui contiennent le contenu que vous voulez synchroniser. Chaque fois que vous créez une connexion, vous devez fournir un token API unique. Quand vous créez des tokens API dans Document360 pour les utiliser avec Zendesk, n’oubliez pas de spécifier GET comme méthode HTTP autorisée. Pour en savoir plus, consultez la documentation de Document360.
Dropbox	Connectez-vous à Dropbox avec un compte utilisateur disposant des permissions adéquates pour le contenu que vous voulez synchroniser avec Zendesk (.docx, .xlsx, .html, and .md). Sélectionnez le dossier racine que vous voulez synchroniser avec votre compte Zendesk. Vous pouvez uniquement sélectionner les dossiers de haut niveau dans le répertoire racine, pas les sous-dossiers ni des fichiers individuels dans le répertoire racine. Quand vous sélectionnez un répertoire racine, la synchronisation inclut automatiquement tous les sous-dossiers et types de fichiers pris en charge qui se trouvent dans ce dossier.
Freshdesk	Configurez ce qui suit : Domaine : le domaine Freshdesk actuel. Il s’agit du sous-domaine que vous avez choisi quand vous avez créé votre compte (par exemple, votre_compagnie.freshdesk.com). Clé API : la clé API Freshdesk qui permet à Zendesk de communiquer directement avec votre compte Freshdesk. Zendesk ingère uniquement le contenu de la langue par défaut.
Google Drive	Connectez-vous à Google avec un compte utilisateur disposant des permissions appropriées pour le contenu que vous voulez synchroniser avec Zendesk et autorisez Zendesk à accéder à vos fichiers Google Drive. Sélectionnez les dossiers Google Drive que vous voulez synchroniser. Le connecteur Google Drive prend en charge Google Docs et Google Sheets. Il synchronise également le contenu de vos dossiers Google Drive partagés. Par contre, le contenu des dossiers Google Drive privés n’est pas synchronisé. Vous pouvez vous inscrire au programme d’accès anticipé Importation de PDF pour activer la synchronisation de vos documents PDF.
Guru	Dans l’onglet Authentification, configurez ce qui suit : 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, configurez ce qui suit : Collection : la collection Guru qui contient le contenu publié que vous voulez synchroniser.
Jira	Sélectionnez le compte Jira que vous voulez synchroniser avec votre compte Zendesk. Saisissez les informations suivantes : Site Jira : saisissez le site Jira que vous voulez synchroniser. Ce champ affiche tous les sites Jira auxquels vous avez accès. Chaque site Jira est mappé avec une seule connexion Jira. Si vous voulez synchroniser plusieurs sites, vous devez créer une nouvelle connexion pour chaque site. Sélectionner des espaces : saisissez l’espace Jira que vous voulez synchroniser. Ce champ affiche tous les espaces du site Jira que vous avez sélectionné auxquels vous avez accès. Chaque espace que vous sélectionnez s’affiche sous la forme d’un marqueur dans le champ Espaces/ Vous pouvez supprimer les espaces que vous avez sélectionnés par erreur en cliquant sur la croix (X) du marqueur de l’espace concerné. Le contenu synchronisé inclut ce qui suit : Clé du problème Résumé Description Statut Priorité Type Libellés Commentaires
Notion	Sélectionnez votre espace d’équipe Notion dans la liste déroulante en haut à droite. Sélectionnez les pages de votre espace d’équipe que vous voulez synchroniser, puis autorisez l’accès à ces pages. à cause des limitations de Notion, vous ne pouvez configurer qu’une seule connexion Notion dans votre compte Zendesk. Pour savoir comment ajouter ou supprimer du contenu de cette connexion, consultez Ajout ou suppression de contenu de votre connexion Notion. Pour que des pages soient synchronisées avec votre compte Zendesk, il doit y avoir du contenu dans le corps de la page.
SharePoint	Connectez-vous à Microsoft avec un compte utilisateur disposant des permissions adéquates pour le contenu que vous voulez synchroniser avec Zendesk. Sélectionnez votre site SharePoint dans la liste déroulante. Les types de fichiers pris en charge sont docx, .xlsx, et .md. Vous pouvez vous inscrire au programme d’accès anticipé Importation de PDF pour activer la synchronisation de vos documents PDF.
Zendesk	Saisissez les informations requises pour toutes les connexions (publiques et privées). URL Zendesk : l’URL de votre compte Zendesk. Si vous voulez synchroniser du contenu privé qui nécessite que les utilisateurs se connectent, cliquez sur Activer, puis saisissez les informations requises : E-mail : l’adresse e-mail associée à votre compte Zendesk. Ces informations sont associées au token API pour l’accès et la synchronisation de votre contenu externe. Token API : un token API que vous pouvez utiliser pour synchroniser des articles privés avec votre compte Zendesk. Si vous ne remplissez pas ce champ, seul le contenu visible par les utilisateurs anonymes sera synchronisé. Sélectionnez la langue (facultatif) pour les articles que vous voulez synchroniser. la langue pour les articles que vous voulez synchroniser. Si vous ne remplissez pas ce champ, les articles associés à toutes les langues seront synchronisés. Si vous ne spécifiez pas de token API avec e-mail et une langue, chaque connexion contient le contenu disponible publiquement dans toutes les langues pour ce sous-domaine. Tous les articles publiés qui satisfont à ces critères sont synchronisés avec la connexion. Si vous voulez synchroniser le contenu d’un autre sous-domaine Zendesk, vous devez ajouter une nouvelle connexion pour ce sous-domaine.