Vous devez être connecté à votre espace de travail Ferndesk avant de connecter une intégration. Vérifiez que vous êtes connecté et que vous êtes 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 les conversations d’assistance et de créer des tâches de documentation à partir des 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 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.
Analyse de l’assistance : Fern importe les fils 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 l’approbation avant que l’intégration soit terminée.
Connecter Slack
Accédez à la page Intégrations dans votre tableau de bord Ferndesk.
Repérez 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 aux éléments suivants :
Lire l’historique des canaux et afficher le contexte des fils
Rejoindre des canaux et envoyer des messages
Afficher les informations utilisateur
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 retournerez dans Ferndesk avec votre espace de travail Slack connecté. La page de l’intégration affichera Connecté, ainsi que l’heure de la dernière synchronisation.
Sélectionnez l’espace de travail Slack connecté pour ouvrir sa page de détails.
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. Continuez avec Configurer les règles de rejoindre automatiquement ou Gérer l’accès aux canaux pour ajouter des canaux.
Résoudre les problèmes de connexion
Je vois « Authentification requise pour connecter Slack »
Je vois « L’organisation OAuth Slack ne correspond pas à la session active »
L’espace de travail Slack que vous autorisez appartient à une autre organisation que celle à laquelle vous êtes connecté dans 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 que l’approbation d’un administrateur est requise
Certains espaces de travail Slack exigent que les administrateurs de l’espace de travail approuvent les nouvelles installations d’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 rejoindre automatiquement — Fern rejoindra automatiquement les canaux dont le nom correspond à certains modèles. Consultez la section Configurer les règles de rejoindre automatiquement 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 rejoindre automatiquement
Les règles de rejoindre automatiquement indiquent à Fern quels canaux rejoindre automatiquement. Les règles correspondent aux modèles de noms de canaux, afin que Fern reste présente dans les canaux où ont lieu 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 les noms de canaux doivent commencer ou se terminer par un modèle, puis saisissez ce modèle (par exemple,
support-ou-customers).Activez Rejoindre maintenant 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 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. Vous pouvez actualiser la liste et contrôler depuis cette section quels canaux contribuent à l’analyse de l’assistance.
Actualiser — Synchroniser les dernières informations d’appartenance aux canaux depuis Slack. La page indique quand les canaux ont été actualisés pour la dernière fois.
Interrupteur d’analyse de l’assistance — Activez Utiliser pour l’analyse de l’assistance pour un canal afin d’inclure ses fils 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 page 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 page 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, elle doit être membre du canal concerné. Envoyer à Fern fonctionne avec tous les messages que vous pouvez voir.
Mentionner Fern dans un fil
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 requis, 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 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, afin 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 dans la boîte de dialogue.
Si vous avez installé l’application Slack avant l’ajout de l’ingestion de l’assistance, reconnectez-vous pour accorder les autorisations supplémentaires.