Vous devez être connecté à votre espace de travail Ferndesk avant de connecter une intégration. Vérifiez que vous êtes connecté et que vous vous trouvez dans la bonne organisation. Si vous avez accès à plusieurs espaces de travail Ferndesk, sélectionnez celui auquel vous souhaitez ajouter la connexion Slack.
Intégration Slack
Connectez Slack pour permettre à Fern de rejoindre vos canaux, d’importer des conversations d’assistance et de créer des tâches de documentation à partir de fils 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épond avec un lien permettant d’ouvrir la tâche dans Ferndesk.
Analyser l’assistance : Fern importe les fils de discussion des canaux sélectionnés comme signaux d’assistance et apprend des questions réelles des clients pour améliorer votre documentation.
Avant de commencer
Vous devez disposer de l’autorisation d’installer des applications dans votre espace de travail Slack. Si vous ne savez pas si vous disposez de cette autorisation, essayez de lancer la connexion. Slack vous indiquera si l’approbation d’un administrateur est nécessaire.
Si votre espace de travail Slack exige l’approbation d’un administrateur pour l’installation d’applications, Slack enverra une demande aux administrateurs de votre espace de travail. Vous devrez attendre leur approbation avant que l’intégration soit terminée.
Connecter Slack
Accédez à la page Intégrations dans votre tableau de bord Ferndesk.
Trouvez la carte Slack et cliquez sur Connecter.
Une page Slack s’ouvre et vous demande de sélectionner votre espace de travail et d’approuver les autorisations. Cette étape se déroule dans Slack, et non dans Ferndesk. Vous verrez que Ferndesk demande l’accès à ce qui suit :
Lire l’historique des canaux et afficher le contexte des fils de discussion
Rejoindre des canaux et envoyer des messages
Afficher les informations sur les utilisateurs
Cliquez sur Autoriser pour accorder ces autorisations. Slack vous redirigera automatiquement vers Ferndesk.
Si la page d’autorisation Slack ne s’affiche pas, vérifiez si votre navigateur a bloqué la fenêtre pop-up. La page d’autorisation doit se charger pour que la connexion puisse être établie.
Après l’autorisation, vous reviendrez dans Ferndesk avec votre espace de travail Slack connecté. La page d’intégration affichera Connecté, ainsi que l’heure de la dernière synchronisation.
Une fois la connexion établie, la carte Slack affiche un bouton Gérer.
Si 0 canaux s’affiche sous Accès aux canaux, c’est normal juste après la connexion. Fern n’a encore rejoint aucun canal. Consultez les sections Configurer les règles de jonction automatique ou Gérer l’accès aux canaux pour ajouter des canaux.
Résoudre les problèmes de connexion
Le message « Authentification requise pour connecter Slack » s’affiche
Le message « L’organisation OAuth Slack ne correspond pas à la session active » s’affiche
L’espace de travail Slack que vous autorisez appartient à une organisation différente de celle dans laquelle vous êtes connecté à Ferndesk. Vérifiez que vous :
êtes connecté au bon espace de travail Ferndesk
autorisez l’espace de travail Slack correspondant à cette organisation Ferndesk
Si vous devez connecter un autre espace de travail Slack à une autre organisation Ferndesk, sélectionnez d’abord cette organisation dans Ferndesk, puis connectez Slack.
J’ai cliqué sur Connecter, mais aucune page d’autorisation Slack ne s’est affichée
L’autorisation Slack s’ouvre via une redirection du navigateur vers Slack. Si la page d’autorisation Slack ne s’est pas affichée, cliquez sur Reconnecter pour réessayer.
Slack indique qu’une approbation d’administrateur est nécessaire
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 faire approuver la demande, puis revenez dans Ferndesk et cliquez sur Reconnecter pour terminer la connexion.
La connexion s’affiche, mais Accès aux canaux indique 0 canal
C’est normal après une nouvelle connexion. Fern n’a encore rejoint aucun canal. Vous pouvez :
Ajouter des règles de jonction automatique — Fern rejoindra automatiquement les canaux dont le nom correspond aux modèles définis. Consultez la section Configurer les règles de jonction automatique ci-dessous.
Inviter Fern manuellement dans des canaux — Dans Slack, invitez Fern dans des canaux spécifiques à l’aide de
/invite @Fernou en ajoutant Fern depuis 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 de l’intégration Slack. Si le problème persiste, déconnectez puis reconnectez l’intégration depuis le début.
Configurer les règles de jonction automatique
Les règles de jonction automatique indiquent à Fern quels canaux rejoindre automatiquement. Les règles s’appliquent aux modèles de noms de canaux, afin que Fern reste présente dans les canaux où se déroulent les conversations d’assistance.
Depuis la page Intégrations, cliquez sur votre espace de travail Slack connecté pour ouvrir la page de détails.
Dans la section Canaux à rejoindre automatiquement, cliquez sur Ajouter une règle. Choisissez si le nom du canal doit commencer ou se terminer par un modèle, puis saisissez ce modèle (par exemple,
support-ou-customers).Activez Rejoindre immédiatement les canaux correspondants pour que Fern rejoigne immédiatement les canaux existants qui correspondent à la règle. Activez Utiliser les canaux correspondants pour l’analyse de l’assistance pour inclure les conversations de ces canaux dans les signaux d’assistance de Fern.
Les règles s’appliquent automatiquement aux nouveaux canaux. Lorsque vous créez un canal correspondant à 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. Vous pouvez actualiser la liste et contrôler depuis cette section les canaux qui contribuent à l’analyse de l’assistance.
Actualiser — Synchroniser les membres les plus récents des canaux depuis Slack. La page indique la date de la dernière actualisation des canaux.
Interrupteur d’analyse de l’assistance — Activez Utiliser pour l’analyse de l’assistance pour un canal afin d’inclure ses fils de discussion dans les signaux d’assistance de Fern.
Fern ne voit que les canaux dont elle est membre. Pour les canaux privés, invitez d’abord Fern dans le canal depuis Slack, puis actualisez la liste dans Ferndesk.
Visibilité des canaux
Public — Visible par tous les membres de l’espace de travail. Fern peut le rejoindre automatiquement en fonction des règles.
Privé — Visible uniquement par les membres invités. Invitez Fern dans le canal depuis Slack à l’aide de
/invite @Fernou des paramètres du canal, puis actualisez la liste dans Ferndesk.
Créer des tâches depuis Slack
Une fois la connexion établie, vous pouvez créer des tâches Ferndesk directement depuis les conversations Slack.
Tout membre de votre espace de travail Slack peut mentionner Fern ou utiliser Envoyer à Fern ; aucun rôle Ferndesk n’est requis. Fern doit être connectée à l’espace de travail et, pour les mentions, être membre du canal concerné. Envoyer à Fern fonctionne pour tout message que vous pouvez voir.
Mentionner Fern dans un fil de discussion
Mentionnez Fern dans n’importe quel fil Slack pour créer une tâche de documentation. Fern ajoute une réaction mémo pour confirmer la mention, puis répond dans le fil avec un lien permettant d’ouvrir la tâche dans Ferndesk. Cette réponse est visible par tous les participants du fil.
Si le contexte du fil n’indique pas clairement le travail de documentation nécessaire, Fern vous demandera de préciser la tâche.
Utiliser le raccourci de message
Sélectionnez un message Slack et utilisez le raccourci Envoyer à Fern pour créer une tâche à partir de ce message. Fern crée la tâche sans publier de réponse dans le fil, de sorte que l’interaction reste privée. Vous recevrez un lien direct 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 — Supprimer l’intégration Slack de votre espace de travail Ferndesk. Vous pouvez confirmer ou annuler l’action dans la boîte de dialogue.
Si vous avez installé l’application Slack avant l’ajout de l’ingestion de l’assistance, reconnectez-la pour accorder les autorisations supplémentaires.