# Canaux
{% hint style="warning" %}
#### Les canaux sont actuellement en accès anticipé
Nous déployons progressivement l’accès aux canaux. Restez à l’écoute pour suivre les prochaines avancées sur les fonctionnalités ci-dessous.
{% endhint %}
Les canaux apportent [GitBook Assistant](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/fr/ia-et-recherche/gitbook-ai-assistant) et [GitBook Agent](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/fr/gitbook-agent/what-is-gitbook-agent) dans les outils où le travail se fait déjà.
Les canaux apportent [GitBook Assistant](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/fr/ia-et-recherche/gitbook-ai-assistant) et [GitBook Agent](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/fr/gitbook-agent/what-is-gitbook-agent) dans les outils que votre équipe utilise déjà. Une fois connecté, votre équipe peut mentionner `@GitBook` dans Slack, GitHub ou Linear pour poser des questions, ouvrir des demandes de modification et maintenir vos docs à jour — sans quitter leur flux de travail habituel.
Les canaux apportent [GitBook Assistant](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/fr/ia-et-recherche/gitbook-ai-assistant) et [GitBook Agent](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/fr/gitbook-agent/what-is-gitbook-agent) dans les outils que votre équipe utilise déjà. Une fois connecté, votre équipe peut mentionner `@GitBook` dans Slack, GitHub ou Linear pour poser des questions, ouvrir des demandes de modification et maintenir vos docs à jour — sans quitter leur flux de travail habituel.
Lorsque vous ajoutez un canal, vous choisissez comment GitBook apparaît dans cet outil. Chaque configuration fonctionne dans l’un de deux modes :
**Agent de support :** GitBook Assistant répond aux questions de votre équipe ou des visiteurs directement dans le canal. Posez une question, obtenez une réponse extraite de vos docs. Dans Slack, les citations de ces réponses renvoient vers l’URL du site publié des docs qu’elles mentionnent. Par exemple, une réponse citée renvoie vers votre site de documentation, pas `app.gitbook.com`.
**Collaborateur :** GitBook Agent rejoint l’équipe en tant que coéquipier. Mentionnez `@GitBook` pour ouvrir des demandes de modification, demander des corrections ou maintenir vos docs synchronisées avec ce qui se passe dans cet outil. Dans Slack, les messages peuvent renvoyer vers `app.gitbook.com` lorsqu’ils font référence au contexte interne du workflow, comme une demande de modification ou un contenu de brouillon. Lorsque Agent crée une demande de modification à partir d’un canal, il l’associe automatiquement au fil de discussion, à l’issue ou à la pull request d’origine.
Vous pouvez exécuter plusieurs configurations par canal — par exemple, le mode Agent de support pour un canal Slack en contact avec les clients, et le mode Collaborateur dans un autre canal pour votre équipe docs.
Pour ajouter un canal, ouvrez **Paramètres** de votre site et cliquez sur **Canaux**.
Utilisez les canaux lorsque les questions d’assistance, les signalements de bugs ou les retours produit commencent dans Slack, GitHub ou Linear et que vous souhaitez que GitBook réponde directement à cet endroit.
{% hint style="info" %}
#### Vous souhaitez intégrer GitBook Assistant à votre site web ou à votre produit ?
Rendez-vous sur [embedding](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/fr/docs-site/embedding "mention") pour découvrir comment intégrer GitBook Assistant.
{% endhint %}
### Canaux disponibles
### Vue d’ensemble
Les canaux relient GitBook à des flux de travail externes.
Ils vous permettent de :
* Répondre aux questions sans quitter la conversation source.
* Intégrer le contexte des docs existantes dans les flux de support et de produit.
* Transformer les conversations importantes en mises à jour de la documentation avec [GitBook Agent](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/fr/gitbook-agent/what-is-gitbook-agent).
Utilisez les canaux lorsque la conversation commence en dehors de GitBook, mais que la réponse ou le suivi doit s’intégrer à votre processus de documentation.
### Plateformes prises en charge
Les canaux prennent actuellement en charge ces plateformes :
* **Slack** pour les conversations et les fils de support.
* **GitHub** pour les issues, le contexte des pull requests et les flux de discussion.
* **Linear** pour le suivi des issues et les flux de retours produit.
Chaque plateforme utilise le même modèle de base.
GitBook reçoit les événements pris en charge depuis la plateforme connectée, rassemble le contexte depuis vos connaissances, et répond via [GitBook Assistant](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/fr/ia-et-recherche/gitbook-ai-assistant) ou [GitBook Agent](https://gitbook-v2-lrp5kto0w-gitbook.vercel.app/url/gitbook.com/docs/documentation/fr/gitbook-agent/what-is-gitbook-agent).
### Rôles et autorisations
Les canaux prennent en charge deux rôles :
* **Collaborateur** — peut effectuer des modifications.
* **Agent de support** — fournit des informations en lecture seule.
Choisissez le rôle en fonction de ce que le canal doit faire.
#### Collaborateur
Utilisez **Collaborateur** lorsque le canal doit aider à transformer les conversations en travail de documentation.
Un canal en mode collaborateur peut utiliser GitBook Agent pour aider à créer ou mettre à jour le travail de documentation dans GitBook, comme ouvrir ou faire progresser une demande de modification.
#### Agent de support
Utilisez **Agent de support** lorsque le canal doit seulement répondre aux questions.
Un canal d’agent de support utilise les docs existantes et les connaissances connectées pour répondre avec un contexte en lecture seule. Il ne modifie pas le contenu.
### Fonctionnement
Les canaux gèrent les événements entrants provenant de votre plateforme connectée.
Un événement entrant peut être un nouveau message, une mention, une mise à jour d’issue ou toute autre activité prise en charge depuis Slack, GitHub ou Linear.
GitBook traite ces événements en quatre étapes :
{% stepper %}
{% step %}
### Recevoir un événement
La plateforme connectée envoie un événement pris en charge à GitBook via le canal que vous avez installé.
{% endstep %}
{% step %}
### Rassembler le contexte
GitBook recherche le contexte pertinent des docs et toute autre connaissance disponible pour le site.
{% endstep %}
{% step %}
### Appliquer le rôle du canal
Si le canal est un **Agent de support**, GitBook renvoie des informations en lecture seule.
Si le canal est un **Collaborateur**, GitBook peut également transformer la conversation en travail de documentation grâce à GitBook Agent.
{% endstep %}
{% step %}
### Répondre dans l’outil source
La réponse réapparaît dans Slack, GitHub ou Linear, de sorte que le flux de travail reste au même endroit.
{% endstep %}
{% endstepper %}
{% hint style="info" %}
La couverture exacte des événements dépend de la plateforme et de votre déploiement en accès anticipé. Si un déclencheur n’est pas encore disponible dans votre espace de travail, il n’a pas été documenté publiquement.
{% endhint %}
### Installation et autorisation
Pour installer un canal, ouvrez le tableau de bord de votre site et choisissez **Paramètres** → **Canaux**.
Puis choisissez la plateforme que vous souhaitez connecter.
Chaque plateforme utilise un flux OAuth ou d’installation d’application. GitBook vous redirige vers la plateforme, vous approuvez l’accès, puis vous revenez dans GitBook pour terminer la configuration.
{% hint style="warning" %}
Les périmètres d’autorisation et les exigences d’administration propres à chaque plateforme ne sont pas encore entièrement documentés.
Examinez attentivement l’écran d’autorisation avant d’approuver l’accès.
{% endhint %}
{% tabs %}
{% tab title="Slack" %}
{% stepper %}
{% step %}
### Lancer l’installation
Dans **Paramètres** → **Canaux**, sélectionnez **Slack**.
{% endstep %}
{% step %}
### Autoriser Slack
Connectez-vous à Slack si nécessaire.
Puis choisissez l’espace de travail Slack où vous souhaitez installer le canal et approuvez l’accès demandé.
{% endstep %}
{% step %}
### Terminer la configuration dans GitBook
Après votre redirection depuis Slack, terminez la configuration du canal dans GitBook.
Choisissez le rôle que le canal doit utiliser et enregistrez la configuration.
{% endstep %}
{% endstepper %}
{% endtab %}
{% tab title="GitHub" %}
{% stepper %}
{% step %}
### Lancer l’installation
Dans **Paramètres** → **Canaux**, sélectionnez **GitHub**.
{% endstep %}
{% step %}
### Autoriser GitHub
Connectez-vous à GitHub si nécessaire.
Puis choisissez le compte personnel ou l’organisation où vous souhaitez installer l’application GitBook et approuvez l’accès demandé.
{% endstep %}
{% step %}
### Terminer la configuration dans GitBook
Après votre redirection depuis GitHub, terminez la configuration du canal dans GitBook.
Choisissez le rôle que le canal doit utiliser et enregistrez la configuration.
{% endstep %}
{% endstepper %}
{% endtab %}
{% tab title="Linear" %}
{% stepper %}
{% step %}
### Lancer l’installation
Dans **Paramètres** → **Canaux**, sélectionnez **Linear**.
{% endstep %}
{% step %}
### Autoriser Linear
Connectez-vous à Linear si nécessaire.
Puis choisissez l’espace de travail Linear que vous souhaitez connecter et approuvez l’accès demandé.
{% endstep %}
{% step %}
### Terminer la configuration dans GitBook
Après votre redirection depuis Linear, terminez la configuration du canal dans GitBook.
Choisissez le rôle que le canal doit utiliser et enregistrez la configuration.
{% endstep %}
{% endstepper %}
{% endtab %}
{% endtabs %}
### Retour et réactions
Les réactions permettent à votre équipe de donner rapidement son avis sur les réponses du canal.
Utilisez les réactions lorsque vous souhaitez indiquer si une réponse a été utile.
Ce retour aide GitBook à comprendre quelles réponses fonctionnent bien dans de vrais flux de travail.
{% hint style="info" %}
Le mappage exact des réactions n’est pas encore documenté et peut varier selon la plateforme pendant l’accès anticipé.
{% endhint %}
