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.
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.
Go to Integrations
Depuis votre tableau de bord Ferndesk, cliquez sur Intégrations dans la barre latérale.
Click Connect
Recherchez Slack dans le catalogue d'intégrations et cliquez sur Connecter. Cela ouvre une page d'autorisation Slack.
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.
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 »
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 @Fernou 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.
Open the Slack integration
Depuis Intégrations, cliquez sur votre espace de travail Slack connecté pour ouvrir la page de détails.
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).
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 @Fernou 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.