Ferndesk
Intégrations

Intégration Slack

Connectez Slack pour permettre à Fern de rejoindre vos canaux, d'importer les conversations de support et de créer des tâches de documentation à partir des fils de discussion Slack. L'intégration synchronise le contexte des fils de discussion de votre espace de travail et l'utilise pour améliorer le contenu de votre centre d'aide.

Ce que vous pouvez faire avec Slack

  • Créer des tâches depuis Slack — Mentionnez Fern dans un fil de discussion ou utilisez le raccourci de message pour créer une tâche de documentation. Fern répondra avec un lien pour ouvrir la tâche dans Ferndesk.

  • Analyse du support — Fern importe les fils de discussion des canaux sélectionnés en tant que signaux de support, apprenant des questions réelles des clients pour améliorer votre documentation.

Avant de commencer

Vous devez avoir l'autorisation d'installer des applications dans votre espace de travail Slack. Si vous n'êtes pas certain de disposer de cette autorisation, essayez le processus de connexion — Slack vous indiquera si l'approbation d'un administrateur est requise.

Si votre espace de travail Slack nécessite l'approbation d'un administrateur pour l'installation d'applications, Slack enverra une demande aux administrateurs de votre espace de travail. Vous devrez attendre l'approbation avant que l'intégration ne soit finalisée.

Connecter Slack

La connexion se déroule en deux parties : d'abord dans Ferndesk, puis dans Slack.

Assurez-vous d'être connecté au bon espace de travail Ferndesk avant de procéder à la connexion. L'intégration se connectera à l'organisation que vous consultez actuellement.

1

Go to Integrations

Depuis votre tableau de bord Ferndesk, cliquez sur Intégrations dans la barre latérale.

Page Intégrations affichant la carte de l'intégration Slack
2

Click Connect

Recherchez Slack dans le catalogue d'intégrations et cliquez sur Connecter. Cela ouvre une page d'autorisation Slack.

Boîte de dialogue de connexion Slack avec le bouton Connecter Slack
3

Authorize in Slack

Une page Slack s'ouvre pour vous demander de sélectionner votre espace de travail et d'approuver les autorisations. Cela se passe dans Slack, pas dans Ferndesk. Vous verrez que Ferndesk demande l'accès pour :

  • Lire l'historique des canaux et afficher le contexte des fils de discussion

  • Rejoindre des canaux et envoyer des messages

  • Consulter les informations des utilisateurs

Cliquez sur Autoriser pour accorder ces autorisations. Slack vous redirigera automatiquement vers Ferndesk.

Si vous ne voyez pas la page d'autorisation Slack, vérifiez si votre navigateur a bloqué la fenêtre contextuelle. La page d'autorisation doit se charger pour que la connexion aboutisse.

4

Confirm the connection

Après l'autorisation, vous retournerez dans Ferndesk avec votre espace de travail Slack connecté. La page d'intégration affichera Connecté avec l'heure de la dernière synchronisation.

Si vous voyez 0 canaux sous Accès aux canaux, c'est normal juste après la connexion — Fern n'a encore rejoint aucun canal. Continuez vers Configurer les règles d'adhésion automatique ou Gérer l'accès aux canaux pour ajouter des canaux.

Dépannage de la connexion

Je vois « Authentication required to connect Slack »

Vous devez être connecté à votre espace de travail Ferndesk avant de connecter une intégration. Assurez-vous d'être connecté et de vous trouver dans la bonne organisation. Si vous avez accès à plusieurs espaces de travail Ferndesk, passez à celui où vous souhaitez ajouter la connexion Slack.

Je vois « Slack OAuth organization does not match the active session »

L'espace de travail Slack que vous autorisez appartient à une organisation différente de celle à laquelle vous êtes connecté dans Ferndesk. Assurez-vous de :

  • Être connecté au bon espace de travail Ferndesk

  • Autoriser l'espace de travail Slack qui correspond à cette organisation Ferndesk

Si vous devez connecter un espace de travail Slack différent à une organisation Ferndesk différente, basculez d'abord vers cette organisation dans Ferndesk, puis connectez Slack.

J'ai cliqué sur Connecter mais je n'ai pas vu de page d'autorisation Slack

Vérifiez si votre navigateur a bloqué la fenêtre contextuelle. Recherchez une notification dans la barre d'adresse de votre navigateur et autorisez les fenêtres contextuelles de Ferndesk. Cliquez ensuite sur Reconnecter pour réessayer.

Slack indique que j'ai besoin de l'approbation d'un administrateur

Certains espaces de travail Slack exigent que les administrateurs approuvent l'installation de nouvelles applications. Lorsque vous cliquez sur Autoriser, Slack indique que la demande a été envoyée pour approbation. Contactez votre administrateur Slack pour approuver la demande, puis revenez dans Ferndesk et cliquez sur Reconnecter pour finaliser la connexion.

La connexion s'affiche mais Accès aux canaux indique 0 canaux

C'est normal après une nouvelle connexion. Fern n'a pas encore rejoint de canaux. Vous pouvez :

  • Ajouter des règles d'adhésion automatique — Fern rejoindra automatiquement les canaux correspondant à des modèles de noms. Voir Configurer les règles d'adhésion automatique.

  • Inviter manuellement Fern à des canaux — Dans Slack, invitez Fern à des canaux spécifiques en utilisant /invite @Fern ou en ajoutant Fern via les détails du canal. Cliquez ensuite sur Actualiser dans Ferndesk pour synchroniser.

J'ai autorisé Slack mais Ferndesk affiche toujours une erreur

Essayez de cliquer sur Reconnecter sur la page d'intégration Slack. Si le problème persiste, déconnectez et reconnectez l'intégration depuis le début.

Configurer les règles d'adhésion automatique

Les règles d'adhésion automatique indiquent à Fern quels canaux rejoindre automatiquement. Les règles se basent sur des modèles de noms de canaux, afin que Fern soit présent dans les canaux où se déroulent les conversations de support.

1

Open the Slack integration

Depuis Intégrations, cliquez sur votre espace de travail Slack connecté pour ouvrir la page de détails.

2

Add a rule

Dans la section Auto-join channels, cliquez sur Add rule. Choisissez si les noms de canaux doivent commencer ou se terminer par un modèle, puis saisissez le modèle (par exemple, support- ou -customers).

3

Choose options

Activez Join matching channels now pour que Fern rejoigne immédiatement tous les canaux existants qui correspondent à la règle. Activez Use matching channels for support analysis pour inclure les conversations de ces canaux dans les signaux de support de Fern.

Les règles s'appliquent automatiquement aux nouveaux canaux. Lorsque vous créez un canal qui correspond à une règle, Fern le rejoint.

Gérer l'accès aux canaux

La section Accès aux canaux affiche tous les canaux que Fern peut voir dans votre espace de travail. De là, vous pouvez actualiser la liste et contrôler quels canaux contribuent à l'analyse du support.

  • Actualiser — Synchronise les dernières adhésions aux canaux depuis Slack. La page indique quand les canaux ont été actualisés pour la dernière fois.

  • Bouton d'analyse du support — Activez Utiliser pour l'analyse du support pour n'importe quel canal afin d'inclure ses fils de discussion dans les signaux de support de Fern.

Fern ne voit que les canaux dont il est membre. Pour les canaux privés, invitez d'abord Fern au canal dans Slack, puis actualisez dans Ferndesk.

Visibilité des canaux

  • Public — Visible par tout le monde dans l'espace de travail. Fern peut rejoindre automatiquement selon les règles.

  • Privé — Visible uniquement par les membres invités. Invitez Fern au canal dans Slack en utilisant /invite @Fern ou via les paramètres du canal, puis actualisez dans Ferndesk.

Créer des tâches depuis Slack

Une fois connecté, vous pouvez créer des tâches Ferndesk directement à partir des conversations Slack.

Mentionner Fern dans un fil de discussion

Mentionnez Fern dans n'importe quel fil de discussion Slack pour créer une tâche de documentation. Fern ajoute une réaction memo pour confirmer la mention, puis répond avec un lien pour ouvrir la tâche dans Ferndesk.

Si le contexte du fil de discussion n'indique pas clairement quel travail de documentation est nécessaire, Fern vous demandera de préciser la tâche.

Utiliser le raccourci de message

Sélectionnez n'importe quel message Slack et utilisez le raccourci Send to Fern pour créer une tâche à partir de ce message. Fern répond avec un lien vers la nouvelle tâche.

Reconnecter ou déconnecter

Depuis la page de détails de l'intégration Slack :

  • Reconnecter — Si la connexion perd l'accès ou nécessite des autorisations mises à jour, cliquez sur Reconnecter pour actualiser le jeton OAuth.

  • Déconnecter — Supprimez l'intégration Slack de votre espace de travail Ferndesk. Vous pouvez confirmer ou annuler dans la boîte de dialogue.

Si vous avez installé l'application Slack avant l'ajout de l'ingestion du support, reconnectez-vous pour accorder les autorisations supplémentaires.

Cela vous a-t-il été utile ?