Intégration Plain

Connectez Plain à Ferndesk afin que Fern puisse analyser vos conversations d'assistance terminées et identifier les lacunes dans votre documentation. Cette intégration vous aide à prioriser les articles en fonction des questions réelles de vos clients.

Comment l'intégration vous aide

Lorsque les clients contactent l'assistance, ils révèlent ce qui est confus ou manquant dans votre documentation. En connectant Plain, Fern peut lire vos fils de discussion d'assistance résolus et faire ressortir des tendances dans les questions des clients.

Fern utilise les fils de discussion Plain comme un signal d'assistance pour identifier les sujets nécessitant une documentation. Par exemple, si plusieurs clients posent des questions sur le même problème de facturation, Fern peut recommander la création d'un article traitant ce sujet, réduisant ainsi le volume de demandes futures.

Ce qui est importé

Ferndesk importe uniquement les fils de discussion d'assistance terminés. Cela inclut :

• Les fils de discussion marqués comme Done, qu'ils soient fermés manuellement ou automatiquement

• L'historique complet des messages pour chaque fil de discussion terminé

Les fils de discussion suivants ne sont pas importés :

• Les fils de discussion actifs avec le statut Todo ou Snoozed

• Les fils de discussion marqués comme Ignored

Cela garantit que Fern analyse les problèmes résolus plutôt que les conversations en cours, vous offrant une vision claire de ce pour quoi les clients avaient besoin d'aide une fois leurs problèmes clôturés.

Avant de commencer

• Vous avez besoin d'un compte Plain avec accès à votre espace de travail d'assistance

• Vous avez besoin d'une clé API d'utilisateur-machine Plain, et non d'une clé API personnelle

Permissions requises

Votre clé API Plain a besoin de ces permissions :

• thread:read — permet à Ferndesk de lire les fils de discussion d'assistance

• timeline:read — permet à Ferndesk de lire l'historique des messages au sein de chaque fil de discussion

Configuration de l'intégration

1

Open the Integrations page

Accédez à Integrations dans la barre latérale de votre tableau de bord Ferndesk. Vous verrez les intégrations regroupées par catégorie sous Support tooling, Product context, Workflow et Codebase.

2

Find Plain and click Connect

Dans la section Support tooling, localisez Plain et cliquez sur le bouton Connect. Cela ouvre la fenêtre de connexion où vous saisirez votre clé API.

3

Enter your Plain API key

Dans la fenêtre de connexion, collez votre clé API d'utilisateur-machine Plain dans le champ API Key.

Ferndesk valide vos identifiants et vérifie que votre clé API possède les permissions thread:read et timeline:read requises avant d'enregistrer la connexion.

4

Start using Plain as a support signal

Une fois connecté, Fern peut lire vos fils de discussion Plain terminés. L'intégration apparaît dans votre liste d'intégrations connectées, et les données Plain deviennent disponibles en tant que signal d'assistance pour les tâches de documentation et les audits.

Déconnecter Plain

Pour déconnecter l'intégration :

1. Allez sur la page Integrations de votre tableau de bord Ferndesk.

2. Trouvez l'intégration Plain et cliquez sur Disconnect.

Après la déconnexion, Ferndesk cesse d'accéder à vos données Plain. Les données des fils de discussion précédemment importées restent dans les signaux d'assistance de Ferndesk pour l'analyse historique.