

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Intégration à la base de connaissances Atlassian Confluence Cloud
<a name="confluence-knowledge-base"></a>

Utilisez l'intégration de la base de connaissances Atlassian Confluence Cloud pour indexer le contenu Confluence afin que les agents Amazon Quick puissent effectuer des recherches et répondre à des questions à ce sujet.

## Avant de commencer
<a name="confluence-kb-prerequisites"></a>

Assurez-vous de disposer des éléments suivants avant de configurer l'intégration.
+ Cloud Atlassian Confluence.
+ Pour les conditions d'abonnement, voir[Configuration des intégrations dans la console](integration-console-setup-process.md).

## Authentification
<a name="confluence-kb-auth-setup"></a>

Pour les intégrations de bases de connaissances, Amazon Quick gère l'authentification par le biais d'un flux contextuel lors de la configuration. Procédez comme suit :

1. Complétez la fenêtre contextuelle d'authentification Confluence Cloud qui s'affiche.

1. Autorisez Amazon Quick à accéder à votre contenu Confluence.

1. Passez en revue et terminez le processus d'authentification.

## Configuration de l'intégration de la base de connaissances
<a name="confluence-kb-setup"></a>

1. Dans la console Amazon Quick, choisissez **Integrations.**

1. Choisissez **Atlassian Confluence Cloud et cliquez sur** le bouton Ajouter (plus « \$1 »).

1. Dans la boîte de dialogue **Créer une base de connaissances Confluence**, sous **Compte connecté**, renseignez les champs suivants :
   + **Nom : nom** descriptif de votre intégration d'accès aux données.
   + URL de **confluence : URL** de votre site Atlassian (par exemple,). `your-site.atlassian.net`

1. Choisissez **Se connecter** et terminez le flux d'authentification Confluence Cloud dans la fenêtre contextuelle.

1. Sous **Créer une base de connaissances**, renseignez les champs suivants :
   + **Nom** : nom de votre base de connaissances.
   + **Description** (facultatif) — Remarques sur la manière dont la base de connaissances sera utilisée.

1. Sous **Contenu**, collez URLs les espaces, blogs ou pages Confluence que vous souhaitez inclure. Choisissez **Ajouter** après chaque URL.
**Note**  
URLs qui suivent la structure `https://company.atlassian.net/wiki/spaces/space-key/overview` sont traitées comme des pages URLs.

1. Choisissez **Créer**.

## Types de contenu pris en charge
<a name="confluence-kb-content-types"></a>
+ Pages et articles de blog de Confluence
+ Contenu des espaces
+ Pièces jointes à des pages et à des blogs

## Contrôles d’accès
<a name="confluence-kb-access-controls"></a>

**Important**  
Amazon Quick ne synchronise pas les listes de contrôle d'accès (ACLs) issues des sources de données. Lorsque vous créez une base de connaissances dans Amazon Quick, par défaut, vous êtes le seul à pouvoir obtenir des informations à partir de cette base de connaissances. Pour le contenu partagé, vous pouvez donner accès à différents utilisateurs et groupes en mettant à jour les autorisations de la base de connaissances.

## Gérer les bases de connaissances
<a name="confluence-kb-management"></a>

### Modifier les bases de connaissances existantes
<a name="confluence-kb-edit"></a>

1. Dans la console Amazon Quick, sélectionnez **Knowledge bases**.

1. Sélectionnez votre base de connaissances Confluence Cloud dans la liste.

1. Cliquez sur l'icône à trois points sous **Actions**, puis sélectionnez **Modifier la base de connaissances**.

1. Mettez à jour vos paramètres de configuration selon vos besoins et choisissez **Enregistrer**.

## Dépannage
<a name="confluence-kb-troubleshooting"></a>

Pour modifier, partager ou supprimer votre intégration, consultez[Gestion des intégrations existantes](integration-workflows.md#managing-existing-integrations).

Pour la résolution des problèmes généraux liés à la base de connaissances, notamment les problèmes de synchronisation et les documents manquants, consultez[Bases de connaissances sur le dépannage](troubleshooting-knowledge-bases.md).

### Autorisation des OAuth applications bloquées
<a name="confluence-kb-troubleshooting-blocked-oauth"></a>

**Symptômes :**
+ Message d'erreur : « L'administrateur de votre site doit autoriser cette application pour le site *instance-name* .atlassian.net avant que l'application puisse accéder à votre compte. »
+ Le fait de cliquer sur **Accepter** dans la boîte de dialogue de consentement n'a aucun effet.

**Cause** :

L'administrateur de votre site Atlassian a bloqué les applications installées par les utilisateurs OAuth . Lorsque ce paramètre est activé, seul un administrateur de site ou d'organisation peut autoriser de nouvelles applications tierces.

**Étapes de résolution :**

Utilisez l'une des options suivantes pour résoudre ce problème.
+ **Option 1 (recommandée) : l'administrateur autorise directement l'application**

  1. Un administrateur de site Atlassian accède à Amazon Quick et lance une nouvelle configuration de base de connaissances avec Confluence Cloud.

  1. Étant donné que l'administrateur dispose d'autorisations au niveau du site, un écran de consentement clair s'affiche sans le message d'erreur.

  1. L'administrateur choisit **Accepter** pour installer l'application.

  Une fois que l'administrateur a autorisé l'application, tous les autres utilisateurs du site peuvent se connecter sans problème.
+ **Option 2 : autoriser temporairement les applications installées par l'utilisateur** : un administrateur accède à **Apps`admin.atlassian.com`, Atlassian Apps****, puis choisit le lien vers les applications** tierces et Marketplace. Sous **Paramètres**, recherchez **Applications installées par l'utilisateur** et activez l'option Autoriser les applications utilisateur. Une fois que l'utilisateur a autorisé Amazon Quick, rétablissez le paramètre pour bloquer les applications utilisateur.

**Important**  
L'autorisation d'administrateur s'applique par site Atlassian, et non par organisation. Si votre entreprise possède plusieurs sites (par exemple, `team-a.atlassian.net` et`team-b.atlassian.net`), chaque site nécessite une autorisation distincte.

**Note**  
Lorsque les applications installées par l'utilisateur sont débloquées (option 2), tout utilisateur du site peut autoriser n'importe quelle OAuth application. Réactivez le blocage rapidement une fois que l'utilisateur s'est connecté.

### La fenêtre contextuelle d'authentification échoue
<a name="confluence-kb-troubleshooting-auth-popup"></a>

**Symptômes :**
+ La fenêtre contextuelle d'authentification ne s'affiche pas ou se ferme immédiatement.
+ Une fenêtre contextuelle apparaît mais ne parvient pas à terminer le OAuth flux.

**Étapes de résolution :**

1. Vérifiez que votre navigateur autorise les fenêtres contextuelles provenant du domaine de la console Amazon Quick.

1. Vérifiez que votre instance Confluence Cloud est accessible depuis votre réseau.

1. Essayez d'utiliser un autre navigateur ou de vider le cache de votre navigateur.

### Contenu manquant dans la base de connaissances
<a name="confluence-kb-troubleshooting-missing-content"></a>

**Symptômes :**
+ La synchronisation de la base de connaissances est terminée mais le contenu attendu n'est pas indexé.
+ Les résultats de recherche n'incluent pas le contenu provenant d'espaces ou de pages spécifiques.
+ Un seul document est indexé pour un espace entier.

**Étapes de résolution :**

1. Vérifiez que l'utilisateur de Confluence Cloud qui s'est authentifié a accès aux espaces et aux pages que vous avez sélectionnés lors de la configuration.

1. Vérifiez que les types de contenu sélectionnés sont pris en charge (pages, articles de blog et pièces jointes).

1. Passez en revue la sélection de contenu dans la configuration de votre base de connaissances pour vous assurer que les espaces et les pages appropriés sont inclus.

1. Vérifiez la présence du `/overview` suffixe dans votre Confluence URLs . URLs qui se terminent par `/wiki/spaces/space-key/overview` sont traités comme une URL de page unique, et non comme un espace complet. Si vous aviez l'intention d'indexer la totalité de l'espace, utilisez l'URL de l'espace sans `/overview` (par exemple,`https://company.atlassian.net/wiki/spaces/space-key`).