Ferndesk
Intégrations

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 depuis 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 du message pour créer une tâche de documentation. Fern répond avec un lien pour ouvrir la tâche dans Ferndesk.

  • Analyse du support : Fern importe les fils des canaux sélectionnés comme signaux de support, en apprenant des vraies questions 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 ne savez pas si vous disposez de cette autorisation, essayez le processus de connexion. Slack vous indiquera si une validation par un administrateur est nécessaire.

Si votre espace de travail Slack exige une validation par un administrateur pour les installations d’applications, Slack enverra une demande aux administrateurs de votre espace de travail. Vous devrez attendre la validation avant que l’intégration ne se termine.

Connecter Slack

  1. Accédez à la page Intégrations dans votre tableau de bord Ferndesk.

    Page Intégrations affichant la grille des cartes d’intégration disponibles
  2. Trouvez la carte Slack et cliquez sur Connecter.

    Carte d’intégration Slack avec le bouton Connecter mis en évidence
  3. Une page Slack s’ouvre pour vous demander de sélectionner votre espace de travail et d’approuver les autorisations. Cela se fait dans Slack, et non dans Ferndesk. Vous verrez que Ferndesk demande l’accès à :

    • 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 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 puisse être finalisée.

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

Une fois la connexion établie, la carte Slack affiche un bouton Gérer les connexions.

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 de jonction automatique ou Gérer l’accès aux canaux pour ajouter des canaux.

Dépannage de la connexion

Je vois « Une authentification est requise pour connecter Slack »

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

Je vois « L’organisation OAuth Slack ne correspond pas à la session active »

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

  • D’être connecté au bon espace de travail Ferndesk

  • D’autoriser l’espace de travail Slack correspondant à cette organisation Ferndesk

Si vous devez connecter un autre espace de travail Slack à une autre organisation Ferndesk, commencez par basculer 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 d’une validation d’administrateur

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 validation. Contactez votre administrateur Slack pour approuver la demande, puis revenez dans Ferndesk et cliquez sur Reconnecter pour terminer la connexion.

La connexion s’affiche, mais l’accès aux canaux indique 0 canaux

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 correspondant aux modèles de nom. Voir ci-dessous Configurer les règles de jonction automatique.

  • Inviter manuellement Fern dans des canaux — Dans Slack, invitez Fern à des canaux spécifiques à l’aide de /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 dans la page d’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 correspondent à des modèles de noms de canaux, afin que Fern reste présent dans les canaux où ont lieu les conversations d’assistance.

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

  2. 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 le modèle (par exemple, support- ou -customers).

  3. Activez Rejoindre maintenant les canaux correspondants pour que Fern rejoigne immédiatement tous les canaux existants correspondant à la règle. Activez Utiliser les canaux correspondants pour l’analyse du support 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. Depuis cet endroit, vous pouvez actualiser la liste et contrôler quels canaux contribuent à l’analyse du support.

  • Actualiser — Synchronisez les dernières appartenances aux canaux depuis Slack. La page indique la date de la dernière actualisation des canaux.

  • Bascule d’analyse du support — Activez Utiliser pour l’analyse du support pour n’importe quel canal afin d’inclure ses fils 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 dans le canal dans Slack, puis actualisez dans Ferndesk.

Visibilité des canaux

  • Public — Visible par tous dans l’espace de travail. Fern peut rejoindre automatiquement les canaux selon les règles.

  • Privé — Visible uniquement par les membres invités. Invitez Fern dans le canal dans Slack à l’aide de /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 depuis les conversations Slack.

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 memo pour accuser réception de la mention, puis répond dans le fil avec un lien pour ouvrir la tâche dans Ferndesk. Cette réponse est visible par tous les participants au fil.

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

Utiliser le raccourci du 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 crée la tâche sans publier de réponse dans le fil, afin que l’échange reste privé. Vous recevrez un lien direct vers la nouvelle tâche.

Reconnecter ou déconnecter

Depuis la page de détail 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 — Supprime 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 ?