mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
d42bd3f156
Generated-By: mintlify-agent Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
280 lines
12 KiB
Plaintext
280 lines
12 KiB
Plaintext
---
|
|
title: "Crear un centro de ayuda"
|
|
sidebarTitle: "Centro de ayuda"
|
|
description: "Crea un centro de ayuda de autoservicio en Mintlify que ayude a los clientes a encontrar respuestas, reduzca el volumen de tickets de soporte y escale con tu equipo."
|
|
keywords: ["support", "customer", "self-service", "FAQ"]
|
|
---
|
|
|
|
Un centro de soporte ayuda a los clientes a resolver problemas y encontrar información sobre tu producto. Cuando los clientes pueden encontrar respuestas por sí mismos, reciben ayuda más rápido y tu equipo de soporte puede centrarse en los problemas complejos que requieren su experiencia.
|
|
|
|
Mintlify proporciona la infraestructura para centros de soporte que escalan con tu base de clientes.
|
|
|
|
* **Búsqueda con IA**: El [assistant](/es/assistant/index) responde preguntas de los clientes usando tu contenido de soporte, para que puedan encontrar respuestas sin saber exactamente dónde buscar ni qué términos específicos usar.
|
|
* **Recopilación de comentarios**: Los [widgets de comentarios](/es/optimize/feedback) integrados permiten que los clientes califiquen artículos y reporten problemas para que puedas mejorar el contenido.
|
|
* **Analytics**: Haz un seguimiento de qué artículos reciben visitas, qué preguntas hacen los clientes y dónde tienen dificultades.
|
|
* **Autenticación**: Usa [SSO o OAuth](/es/deploy/authentication-setup) para mostrar contenido personalizado según los planes o tipos de cuenta de los clientes.
|
|
|
|
<div id="prerequisites">
|
|
## Requisitos previos
|
|
</div>
|
|
|
|
Si aún no has creado un proyecto de Mintlify, consulta la [Guía de inicio rápido](/es/quickstart) para desplegar tu sitio.
|
|
|
|
* Contenido para tus temas de soporte más habituales
|
|
* Acceso de administrador a tu organización de Mintlify
|
|
* Un domain para alojar tu centro de soporte
|
|
|
|
<div id="migrate-existing-content">
|
|
## Migra el contenido existente
|
|
</div>
|
|
|
|
Si estás creando un centro de soporte desde cero, pasa a [Planifica la estructura de tu centro de soporte](#plan-your-support-center-structure).
|
|
|
|
<div id="audit-existing-content">
|
|
### Audita el contenido existente
|
|
</div>
|
|
|
|
Revisa tus recursos de soporte actuales para comprender qué migrar.
|
|
|
|
* **Artículos de ayuda**: ¿Qué temas abordas? ¿Qué artículos reciben más visitas?
|
|
* **Preguntas frecuentes (FAQs)**: ¿Tienes preguntas frecuentes que deberían convertirse en artículos?
|
|
* **Tickets de soporte**: ¿Qué preguntas te hacen los clientes de forma reiterada? Estas deberían convertirse en contenido de autoservicio.
|
|
* **Documentación del producto**: ¿Hay superposición entre el contenido de soporte y la documentación del producto?
|
|
|
|
<div id="export-your-existing-content">
|
|
### Exporta tu contenido existente
|
|
</div>
|
|
|
|
* Exporta a **Markdown** para realizar la migración más sencilla a Mintlify.
|
|
* Exporta a **HTML** si Markdown no está disponible y luego conviértelo a Markdown.
|
|
* Exporta los **datos de tickets de soporte** para identificar las preguntas más habituales que necesitan documentación.
|
|
|
|
<div id="plan-your-support-center-structure">
|
|
## Planifica la estructura de tu centro de soporte
|
|
</div>
|
|
|
|
Organiza tu centro de soporte en torno a los problemas de los clientes, no a las funciones del producto. Los clientes llegan con preguntas y objetivos, así que estructura el contenido de forma que se alinee con su manera de pensar sobre tu producto y las tareas habituales.
|
|
|
|
<Tip>
|
|
Revisa tus tickets de soporte para entender qué es lo que realmente preguntan los clientes. Esto te ayuda a priorizar el contenido y a estructurar la navigation en torno a problemas reales.
|
|
</Tip>
|
|
|
|
```json
|
|
{
|
|
"navigation": {
|
|
"groups": [
|
|
{
|
|
"group": "Get Started",
|
|
"pages": [
|
|
"getting-started/quick-setup",
|
|
"getting-started/first-steps"
|
|
]
|
|
},
|
|
{
|
|
"group": "Account",
|
|
"pages": [
|
|
"account/billing",
|
|
"account/plans",
|
|
"account/team-management",
|
|
"account/security"
|
|
]
|
|
},
|
|
{
|
|
"group": "Using the Product",
|
|
"pages": [
|
|
"product/feature-one",
|
|
"product/feature-two",
|
|
"product/integrations"
|
|
]
|
|
},
|
|
{
|
|
"group": "Solución de problemas",
|
|
"pages": [
|
|
"troubleshooting/common-errors",
|
|
"troubleshooting/connectivity",
|
|
"troubleshooting/performance"
|
|
]
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
Consulta [Navegación](/es/organize/navigation) para obtener más opciones de configuración.
|
|
|
|
<div id="write-effective-support-content">
|
|
## Redacta contenido de soporte eficaz
|
|
</div>
|
|
|
|
El contenido de soporte debe ayudar a los clientes a resolver problemas rápidamente. Cada artículo debe responder a una pregunta específica o resolver un problema concreto. Organiza el contenido relacionado en grupos en lugar de crear páginas demasiado largas con demasiada información.
|
|
|
|
<div id="structure-articles-for-scanning">
|
|
### Estructura los artículos para que se puedan escanear rápidamente
|
|
</div>
|
|
|
|
Los clientes recorren las páginas de soporte en busca de su problema específico. Usa encabezados claros y párrafos breves.
|
|
|
|
```mdx Example support page
|
|
---
|
|
title: "Fix login issues"
|
|
description: "Troubleshoot common problems signing in to your account"
|
|
---
|
|
|
|
## Reset your password
|
|
|
|
If you forgot your password, request a reset link from the login page.
|
|
|
|
1. Go to the login page.
|
|
2. Select **Forgot password**.
|
|
3. Enter your email address.
|
|
4. Check your inbox for the reset link.
|
|
|
|
## Clear browser cache
|
|
|
|
Old cached data can cause login problems. Clear your browser cache and try again.
|
|
|
|
## Verificar el estado de la cuenta
|
|
|
|
Si tu cuenta está suspendida o desactivada, verás un error al iniciar sesión.
|
|
Contacta a soporte si crees que esto es un error.
|
|
```
|
|
|
|
<div id="include-step-by-step-instructions">
|
|
### Incluye instrucciones paso a paso
|
|
</div>
|
|
|
|
Al explicar cómo hacer algo, utiliza pasos numerados.
|
|
|
|
<Steps>
|
|
<Step title="Ir a Configuración">
|
|
Haz clic en el icono de engranaje en la barra de herramientas.
|
|
</Step>
|
|
|
|
<Step title="Seleccionar Facturación">
|
|
Haz clic en **Billing** en el menú de navegación.
|
|
</Step>
|
|
|
|
<Step title="Actualizar método de pago">
|
|
Haz clic en **Update** junto a tu método de pago actual e introduce los nuevos datos.
|
|
</Step>
|
|
</Steps>
|
|
|
|
<div id="add-visual-aids">
|
|
### Añade recursos visuales
|
|
</div>
|
|
|
|
Las capturas de pantalla y los diagramas ayudan a los usuarios a comprobar que están en la sección correcta.
|
|
|
|
```mdx Example screenshot
|
|
|
|
```
|
|
|
|
<div id="set-up-the-assistant">
|
|
## Configura el assistant
|
|
</div>
|
|
|
|
El assistant responde a las preguntas de los clientes utilizando tu contenido de soporte. Configúralo desde tu [dashboard](https://dashboard.mintlify.com/products/assistant/settings).
|
|
|
|
<Steps>
|
|
<Step title="Añade preguntas de ejemplo">
|
|
Añade preguntas frecuentes que hacen los clientes, como:
|
|
|
|
* "¿Cómo cancelo mi suscripción?"
|
|
* "¿Por qué se rechazó mi pago?"
|
|
* "¿Cómo agrego miembros del equipo?"
|
|
|
|
Las preguntas de ejemplo aparecen como botones de acceso rápido, lo que ayuda a los clientes a obtener respuestas con un solo clic.
|
|
</Step>
|
|
|
|
<Step title="Configura un correo de derivación">
|
|
Configura un correo de soporte para las preguntas que el assistant no pueda responder. Esto garantiza que los clientes aún puedan contactar a tu equipo cuando el autoservicio no sea suficiente.
|
|
</Step>
|
|
|
|
<Step title="Revisa las conversaciones">
|
|
Revisa regularmente las conversaciones del assistant para identificar:
|
|
|
|
* Preguntas que el assistant no puede responder (brechas de contenido)
|
|
* Respuestas incorrectas o incompletas (contenido a mejorar)
|
|
* Patrones de preguntas frecuentes (contenido a priorizar)
|
|
</Step>
|
|
</Steps>
|
|
|
|
<div id="enable-feedback-collection">
|
|
## Activar la recopilación de comentarios
|
|
</div>
|
|
|
|
Los comentarios te ayudan a entender qué páginas son útiles y cuáles necesitan mejoras. Revisa los [comentarios](/es/optimize/feedback) para ver qué páginas los clientes consideran útiles y cuáles requieren mejoras. Lee todos los comentarios y actualiza las páginas en función de los comentarios válidos.
|
|
|
|
<div id="set-up-analytics">
|
|
## Configura Analytics
|
|
</div>
|
|
|
|
Supervisa cómo los clientes usan tu centro de soporte para mejorar el contenido a lo largo del tiempo.
|
|
|
|
* **Artículos populares**: ¿Qué artículos reciben más visitas? Manténlos precisos y bien actualizados.
|
|
* **Consultas de búsqueda**: ¿Qué buscan los clientes? Crea contenido para las búsquedas comunes que no devuelven resultados.
|
|
* **Conversaciones con el assistant**: ¿Qué preguntas recibe el assistant? Usa esta información para identificar lagunas de contenido.
|
|
|
|
<div id="restrict-content-by-customer-segment">
|
|
## Restringe el contenido por segmento de clientes
|
|
</div>
|
|
|
|
Si tienes diferentes niveles de cliente o planes de producto, muestra contenido relevante para cada segmento usando control de acceso basado en grupos.
|
|
|
|
<Steps>
|
|
<Step title="Configura la autenticación">
|
|
Configura la [autenticación](/es/deploy/authentication-setup) para identificar a los clientes cuando visiten tu centro de ayuda.
|
|
</Step>
|
|
|
|
<Step title="Configura grupos de usuarios">
|
|
Devuelve la información de grupos en los datos de tus usuarios para definir segmentos de clientes según el tipo de plan, el estado de la cuenta u otros atributos. Consulta [Formato de datos de usuario](/es/deploy/authentication-setup#user-data-format) para más detalles.
|
|
</Step>
|
|
|
|
<Step title="Etiqueta el contenido por grupo">
|
|
Usa frontmatter para especificar qué grupos pueden ver cada artículo.
|
|
|
|
```mdx
|
|
---
|
|
title: "Enterprise SSO setup"
|
|
groups: ["enterprise"]
|
|
---
|
|
```
|
|
</Step>
|
|
</Steps>
|
|
|
|
<div id="maintain-your-support-center">
|
|
## Mantén tu centro de soporte
|
|
</div>
|
|
|
|
El contenido de soporte se vuelve obsoleto a medida que tu producto cambia. Establece procesos para mantener el contenido actualizado y preciso.
|
|
|
|
<Steps>
|
|
<Step title="Actualiza con los lanzamientos de producto">
|
|
Cuando publiques cambios en el producto, actualiza los artículos de soporte afectados. Incluye las actualizaciones de documentación en tu proceso de lanzamiento.
|
|
</Step>
|
|
|
|
<Step title="Revisa los comentarios con regularidad">
|
|
Revisa semanalmente las valoraciones de los artículos y los comentarios de los clientes. Atiende los comentarios negativos con prontitud. A menudo indican contenido confuso o incorrecto.
|
|
</Step>
|
|
|
|
<Step title="Supervisa los tickets de soporte">
|
|
Si los clientes envían tickets sobre problemas cubiertos en tu centro de soporte, investiga por qué el autoservicio no funcionó. Es posible que el artículo sea difícil de encontrar, poco claro o incompleto.
|
|
</Step>
|
|
|
|
<Step title="Archiva el contenido obsoleto">
|
|
Elimina o archiva los artículos sobre funciones en desuso. El contenido obsoleto confunde a los clientes y reduce la confianza en tu centro de soporte.
|
|
</Step>
|
|
</Steps>
|
|
|
|
<div id="next-steps">
|
|
## Próximos pasos
|
|
</div>
|
|
|
|
Tu centro de soporte está listo para su lanzamiento. Después de desplegarlo:
|
|
|
|
1. Vincula tu centro de soporte desde tu producto y tu sitio web.
|
|
2. Supervisa las conversaciones del assistant y las consultas de búsqueda para detectar brechas de contenido.
|
|
3. Revisa semanalmente las valoraciones y mejora los artículos con baja calificación.
|
|
4. Haz un seguimiento del volumen de tickets para medir la efectividad del autoservicio.
|
|
|
|
Un buen centro de soporte reduce los costos de soporte y, al mismo tiempo, mejora la satisfacción del cliente. Invierte en contenido que responda de forma eficaz a las preguntas más comunes. |