Crear un centro de ayuda

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 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 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 para mostrar contenido personalizado según los planes o tipos de cuenta de los clientes.

La forma más rápida de crear un nuevo centro de ayuda es con el comando mint new --template. Ejecuta el comando y selecciona la plantilla de inicio del centro de ayuda.

mint new your-help-center-name --template help-center-starter

Esto crea un nuevo proyecto preconfigurado para un centro de ayuda, que incluye la estructura de navegación, páginas de ejemplo y listados de directorios. Consulta el ejemplo en vivo o revisa el código fuente de la plantilla.

Si prefieres configurar un centro de ayuda en un proyecto existente, continúa con los pasos a continuación.

Si aún no has creado un proyecto de Mintlify, consulta la Guía de inicio rápido 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

Si estás creando un centro de soporte desde cero, pasa a Planifica la estructura de tu centro de soporte.

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?

• 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.

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.

{
  "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 para obtener más opciones de configuración.

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.

Los clientes recorren las páginas de soporte en busca de su problema específico. Usa encabezados claros y párrafos breves.

---
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.

Al explicar cómo hacer algo, utiliza pasos numerados.

Las capturas de pantalla y los diagramas ayudan a los usuarios a comprobar que están en la sección correcta.

![Página de configuración con la sección de facturación resaltada](/images/billing-settings.png)

El assistant responde a las preguntas de los clientes utilizando tu contenido de soporte. Configúralo desde tu dashboard.

Los comentarios te ayudan a entender qué páginas son útiles y cuáles necesitan mejoras. Revisa los comentarios 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.

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.

Si tienes diferentes niveles de cliente o planes de producto, muestra contenido relevante para cada segmento usando control de acceso basado en grupos.

---
title: "Enterprise SSO setup"
groups: ["enterprise"]
---

El contenido de soporte se vuelve obsoleto a medida que tu producto cambia. Establece procesos para mantener el contenido actualizado y preciso.

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.