Ferndesk
Integraciones

Integración con Plain

Conecta Plain a Ferndesk para que Fern pueda analizar tus conversaciones de soporte finalizadas e identificar vacíos en la documentación. Esta integración te ayuda a priorizar artículos basándote en lo que tus clientes realmente preguntan.

Cómo ayuda la integración

Cuando los clientes contactan al soporte, revelan qué es confuso o qué falta en tu documentación. Al conectar Plain, Fern puede leer tus hilos de soporte resueltos y detectar patrones en las preguntas de los clientes.

Fern utiliza los hilos de Plain como una señal de soporte para identificar temas que necesitan documentación. Por ejemplo, si varios clientes preguntan sobre el mismo problema de facturación, Fern puede recomendar la creación de un artículo que lo aborde, reduciendo el volumen de soporte futuro.

Qué se importa

Ferndesk importa solo hilos de soporte finalizados. Esto incluye:

  • Hilos marcados como Done, ya sean cerrados de forma manual o automática

  • El historial completo de mensajes de cada hilo finalizado

Los siguientes hilos no se importan:

  • Hilos activos con estado Todo o Snoozed

  • Hilos marcados como Ignored

Esto asegura que Fern analice problemas resueltos en lugar de conversaciones en curso, ofreciéndote una imagen clara de aquello en lo que los clientes necesitaron ayuda después de que se cerraran sus casos.

Antes de empezar

  • Necesitas una cuenta de Plain con acceso a tu espacio de trabajo de soporte

  • Necesitas una clave API de usuario-máquina de Plain, no una clave API personal

Las claves de usuario-máquina están diseñadas para integraciones y tienen permisos limitados. Puedes crear una en la configuración de tu espacio de trabajo de Plain, en la sección de claves API.

Permisos requeridos

Tu clave API de Plain necesita estos permisos:

  • thread:read — permite que Ferndesk lea los hilos de soporte

  • timeline:read — permite que Ferndesk lea el historial de mensajes dentro de cada hilo

No se requiere permiso de escritura. Ferndesk solo lee las conversaciones finalizadas y nunca modifica tus datos de Plain.

Configuración de la integración

1

Open the Integrations page

Ve a Integrations en la barra lateral de tu panel de Ferndesk. Verás las integraciones agrupadas por categorías bajo Support tooling, Product context, Workflow y Codebase.

2

Find Plain and click Connect

En la sección Support tooling, busca Plain y haz clic en el botón Connect. Esto abrirá la ventana modal de conexión donde introducirás tu clave API.

3

Enter your Plain API key

En la ventana modal de conexión, pega tu clave API de usuario-máquina de Plain en el campo API Key.

Ventana modal de conexión de Plain con el campo de entrada para la clave API

Ferndesk valida tus credenciales y comprueba que tu clave API tenga los permisos thread:read y timeline:read necesarios antes de guardar la conexión.

4

Start using Plain as a support signal

Una vez conectada, Fern podrá leer tus hilos finalizados de Plain. La integración aparecerá en tu lista de integraciones conectadas y los datos de Plain estarán disponibles como señal de soporte para tareas y auditorías de documentación.

Desconectar Plain

Para desconectar la integración:

  1. Dirígete a la página de Integrations en tu panel de Ferndesk.

  2. Busca la integración de Plain y haz clic en Disconnect.

Tras la desconexión, Ferndesk dejará de acceder a tus datos de Plain. Los datos de los hilos importados previamente permanecerán en las señales de soporte de Ferndesk para el análisis histórico.

¿Te fue útil?