Saltar al contenido

Plantilla de artículo de ayuda y estructura de un centro de ayuda, en Word y PDF

Lo que hace falta para crear una base de conocimiento que los clientes usen. La plantilla de un artículo, con el título como lo pregunta el cliente y la respuesta arriba, la estructura de colecciones para un producto de software y la hoja con los veinte primeros artículos y cómo decidirlos. Se descarga en Word y en PDF y se puede copiar desde esta página.

Adrià Castany 12 min

Ilustración de una estantería antigua con fichas y libros de consulta en un claro del bosque al atardecer, con una escalera de mano apoyada

¿Cómo se crea una base de conocimiento?

Con las preguntas que ya llegan, ordenadas por frecuencia, y una misma plantilla para todos los artículos. Veinte artículos bien elegidos cubren la mayor parte de lo que se pregunta cada semana.

Incluye
Plantilla, siete colecciones y hoja de veinte artículos
Formatos
Word, PDF y texto para copiar
Para quién
Quien escribe o encarga la ayuda de un software
Primer resultado
Los diez artículos más preguntados

En resumen

  • Un centro de ayuda funciona cuando contesta las preguntas que ya llegan al equipo. Los veinte primeros artículos salen de las conversaciones, no de una reunión.
  • Cada artículo responde una sola pregunta, lleva el título con las palabras del cliente y contesta en la primera frase. Después van los pasos, las capturas y qué hacer si falla.
  • Siete colecciones bastan para un producto de software, nombradas por lo que el cliente quiere hacer.
  • Lo que se escribe para los clientes sirve igual a un agente de IA, que solo puede responder con lo que está escrito y al día.
  • La plantilla se descarga en Word y en PDF sin dejar ningún dato, y también se puede copiar desde esta página.
En esta página
  1. Descargar la plantilla
  2. La plantilla de un artículo de ayuda
  3. El documento completo, para copiar
  4. La estructura de colecciones
  5. Cómo decidir los veinte primeros artículos
  6. Cuando también lo lee un agente de IA
  7. Mantenerlo al día
  8. Cómo lo hace Intake
  9. Preguntas frecuentes

Descargar la plantilla

El documento lleva la ficha y la plantilla del artículo, la comprobación antes de publicar, las colecciones, la hoja de los veinte primeros artículos y el calendario de revisión. Word sirve para rellenarlo con el equipo y PDF para repartirlo.

Plantilla de artículo de ayuda y plan del centro de ayuda

Siete apartados con los datos por rellenar entre corchetes. Gratis, sin pedir correo.

Word, 16 KB. PDF, 277 KB

La plantilla de un artículo de ayuda

Todos los artículos siguen el mismo orden. El cliente aprende dónde está cada cosa y quien escribe no parte de una hoja en blanco. La plantilla, lista para pegar en el editor.

Plantilla de artículo de ayuda

[La pregunta, con las palabras del cliente] [Respuesta en una o dos frases. Quien solo lea esto ya sabe qué hacer.] Antes de empezar [Qué rol, plan o dato hace falta.] Pasos 1. [Una acción, con el nombre exacto del botón o del menú.] 2. [Una acción.] 3. [Una acción.] [Captura de la pantalla que cambia] Qué pasa después [Lo que se va a ver, con cifras y plazos exactos.] Lo que no se puede hacer [El límite, y la alternativa si la hay.] Si no funciona - [Fallo habitual y su arreglo.] - [Fallo habitual y su arreglo.] - Si sigue sin funcionar, escribe a [canal de soporte] con [los datos que se van a pedir]. Artículos relacionados - [Artículo] - [Artículo]

El mismo artículo, relleno

¿Puedo cambiar de plan a mitad de mes? Sí. El cambio se hace desde Ajustes > Facturación y se aplica al momento. Antes de empezar Hace falta ser administrador de la cuenta. Pasos 1. Abre Ajustes > Facturación. 2. Pulsa Cambiar plan y elige el plan nuevo. 3. Revisa el importe y pulsa Confirmar. Qué pasa después Al subir de plan se cobra la parte proporcional de lo que queda de mes. Al bajar, el plan nuevo empieza en la siguiente factura y hasta entonces se conserva el actual. Lo que no se puede hacer No se devuelve la parte de un mes ya facturado. En los planes anuales el cambio a un plan inferior se aplica en la renovación. Si no funciona - No aparece el botón Cambiar plan. Solo lo ven los administradores. En Ajustes > Equipo se ve quién lo es. - El pago se rechaza. Revisa la tarjeta en Ajustes > Facturación > Forma de pago y vuelve a intentarlo. - Si sigue sin funcionar, escribe a soporte desde la cuenta de la empresa e indica el plan que quieres. Artículos relacionados - ¿Dónde descargo mis facturas? - ¿Cómo cambio la forma de pago?

Por qué va cada parte

PartePara qué sirveEl fallo habitual
Título con la preguntaEl cliente lo reconoce en el buscador y en Google.«Política de modificación de suscripciones».
Respuesta arribaLa mayoría solo necesita esa frase.Dos párrafos de contexto antes de contestar.
Pasos de una acciónSe siguen con el producto abierto al lado.Tres acciones en un mismo paso.
CapturasConfirman que se está en la pantalla correcta.Capturas viejas, o pasos que solo se entienden con la imagen.
Lo que no se puede hacerEvita la consulta siguiente y una promesa que no se cumple.Callarlo y que el cliente lo descubra.
Si no funcionaResuelve el fallo sin escribir, o deja el caso bien planteado.Un «contacte con soporte» sin decir con qué datos.

El documento completo, para copiar

  1. Página 1 de 4 de «Plantilla de artículo de ayuda y plan del centro de ayuda»
  2. Página 2 de 4 de «Plantilla de artículo de ayuda y plan del centro de ayuda»
Ver como texto

Plantilla de artículo de ayuda y plan del centro de ayuda

Lo que va entre corchetes se sustituye por los datos de la empresa. Los apartados 1 a 3 se repiten en cada artículo. Los apartados 4 a 7 se rellenan una vez.

01 Ficha del artículo

Se rellena antes de escribir. Un artículo responde una sola pregunta. Si la respuesta empieza por «depende», son dos artículos.

CampoQué se escribe
Título[La pregunta, con las palabras del cliente]
Colección[Una sola colección]
A quién le pasa[Rol, plan o situación en la que surge la duda]
Dueño del artículo[Nombre]
Última revisión[Fecha]
Se revisa cuando cambia[Pantalla, precio, plazo o política de la que depende]

02 El artículo

Título. [La pregunta tal como la escribe el cliente, por ejemplo «¿Puedo cambiar de plan a mitad de mes?»]

Respuesta. [Una o dos frases que contestan del todo. Quien solo lea esto ya sabe qué hacer.]

Antes de empezar. [Qué rol, plan o dato hace falta. Si no hace falta nada, se quita este apartado.]

Pasos. [Una acción por paso, con el nombre exacto del botón o del menú, por ejemplo Ajustes > Facturación > Cambiar plan.]

Captura. [Una por pantalla que cambia, recortada a la zona que importa. El texto de los pasos se entiende sin ella.]

Qué pasa después. [Lo que el cliente va a ver, con cifras y plazos exactos.]

Lo que no se puede hacer. [El límite, dicho sin rodeos, y la alternativa si la hay.]

Si no funciona. [Los dos o tres fallos habituales con su arreglo, y cómo escribir a soporte con los datos que se van a pedir.]

Artículos relacionados. [Dos o tres, como mucho.]

03 Comprobación antes de publicar

  • El título es una pregunta que ha llegado al equipo, con las palabras del cliente.
  • La primera frase contesta sin obligar a leer el resto.
  • Cada paso es una sola acción y nombra el botón como sale en pantalla.
  • Las cifras y los plazos son exactos, sin «unos días» ni «en breve».
  • Dice lo que no se puede hacer.
  • Explica qué hacer si falla y cómo llegar a una persona.
  • Cada párrafo se entiende leído solo, sin «como se ha dicho arriba».
  • Lo ha seguido paso a paso alguien que no lo escribió.
  • Tiene dueño y fecha de revisión.

04 Estructura del centro de ayuda

Siete colecciones cubren un producto de software. Se nombran por lo que el cliente quiere hacer, no por el organigrama de la empresa. Una colección con menos de tres artículos se junta con otra.

ColecciónQué respondeArtículos de ejemplo
Primeros pasosLo que necesita un cliente nuevo en su primera semana.Crear la cuenta, invitar al equipo, importar los datos.
Cuenta y accesoEntrar, contraseñas, usuarios, roles y permisos.No puedo entrar, cambiar el correo, qué puede hacer cada rol.
Facturación y planesFacturas, cobros, cambios de plan y bajas.Descargar una factura, cambiar de plan, darse de baja.
Uso del productoLas tareas de cada día, con una colección por módulo si el producto es grande.[La tarea principal], [la segunda tarea], exportar los datos.
IntegracionesConectar el producto con las herramientas del cliente.Conectar [la integración más usada], usar la API.
Datos y seguridadDónde están los datos, quién los ve y cómo se borran.Dónde se guardan los datos, verificación en dos pasos, pedir el borrado.
Solución de problemasLos errores y avisos que más se repiten.[El error más habitual], cómo contactar con soporte.

05 Los veinte primeros artículos

La lista de partida para un producto de software con clientes de empresa. Se sustituye cada línea por la pregunta que llega al equipo, se apunta cuántas veces llegó el último mes y se escribe de más a menos.

Título, como lo pregunta el clienteColecciónVeces al mesDueñoHecho
¿Cómo creo mi cuenta y entro por primera vez?Primeros pasos[n][Nombre]
¿Cómo invito a mi equipo?Primeros pasos[n][Nombre]
¿Cómo importo mis datos desde otra herramienta?Primeros pasos[n][Nombre]
¿Por dónde empiezo? Lo esencial en diez minutosPrimeros pasos[n][Nombre]
No puedo entrar o he olvidado la contraseñaCuenta y acceso[n][Nombre]
¿Cómo cambio el correo de mi cuenta?Cuenta y acceso[n][Nombre]
¿Qué puede hacer cada rol y cómo cambio los permisos?Cuenta y acceso[n][Nombre]
¿Dónde descargo mis facturas?Facturación y planes[n][Nombre]
¿Cómo cambio los datos de facturación?Facturación y planes[n][Nombre]
¿Puedo cambiar de plan a mitad de mes?Facturación y planes[n][Nombre]
¿Cómo cambio la forma de pago?Facturación y planes[n][Nombre]
¿Cómo me doy de baja y qué pasa con mis datos?Facturación y planes[n][Nombre]
¿Cómo [la tarea principal del producto]?Uso del producto[n][Nombre]
¿Cómo [la segunda tarea más habitual]?Uso del producto[n][Nombre]
¿Cómo exporto mis datos?Uso del producto[n][Nombre]
¿Cómo conecto [la integración más usada]?Integraciones[n][Nombre]
¿Dónde se guardan mis datos y quién puede verlos?Datos y seguridad[n][Nombre]
¿Cómo activo la verificación en dos pasos?Datos y seguridad[n][Nombre]
Me sale [el error más habitual]. ¿Qué hago?Solución de problemas[n][Nombre]
¿Cómo contacto con soporte y cuándo responden?Solución de problemas[n][Nombre]

06 Cómo se deciden

  • Se repasan las conversaciones de los últimos [tres] meses y se apunta la pregunta de cada una.
  • Se juntan las que piden lo mismo con palabras distintas y se cuentan.
  • Se pregunta a quien más atiende qué le preguntan cada día y qué respuesta copia y pega.
  • Se añaden las dudas que ventas oye antes de la compra.
  • Se ordena por veces al mes. Lo que no ha llegado nunca no entra en los veinte primeros.

07 Calendario de revisión

Un artículo que ya no es cierto hace más daño que no tenerlo. Cada artículo tiene dueño y el centro de ayuda tiene estas cuatro citas.

CuándoQué se revisaQuién
El día de cada versión del productoLos artículos de las pantallas que cambian. Se actualizan el mismo día.[Dueño del artículo]
Cada semanaLas preguntas que llegaron al equipo y no tenían artículo.[Responsable del centro de ayuda]
Cada mesLos artículos con más votos de «no me ha servido» y las búsquedas sin resultado.[Responsable del centro de ayuda]
Cada trimestreLos artículos sin revisar desde hace más de [seis] meses. Se actualizan o se retiran.[Responsable del centro de ayuda]

La estructura de colecciones

El cliente llega con una tarea en la cabeza, no con el nombre de un módulo. Las colecciones siguen ese orden, del primer día al problema del mes doce.

ColecciónQué respondeArtículos de ejemplo
Primeros pasosLo que necesita un cliente nuevo en su primera semana.Crear la cuenta, invitar al equipo, importar los datos.
Cuenta y accesoEntrar, contraseñas, usuarios, roles y permisos.No puedo entrar, cambiar el correo, qué puede hacer cada rol.
Facturación y planesFacturas, cobros, cambios de plan y bajas.Descargar una factura, cambiar de plan, darse de baja.
Uso del productoLas tareas de cada día, con una colección por módulo si el producto es grande.[La tarea principal], [la segunda tarea], exportar los datos.
IntegracionesConectar el producto con las herramientas del cliente.Conectar [la integración más usada], usar la API.
Datos y seguridadDónde están los datos, quién los ve y cómo se borran.Dónde se guardan los datos, verificación en dos pasos, pedir el borrado.
Solución de problemasLos errores y avisos que más se repiten.[El error más habitual], cómo contactar con soporte.
  • Un artículo vive en una sola colección. Si encaja en dos, se elige la que el cliente abriría primero y se enlaza desde la otra.
  • Dos niveles como mucho. Colección y artículo. Un tercer nivel esconde los artículos y nadie llega a ellos.
  • Lo más preguntado, arriba. Dentro de cada colección se ordena por frecuencia, no por orden alfabético.
  • El buscador manda. La mayoría de los clientes busca en vez de navegar, y por eso el título lleva sus palabras.

Qué cambia según el sector

SectorLa colección que más pesaQué cuidar
Software de gestión o SaaS B2BFacturación y planes, y las integraciones con la contabilidad o el CRM del cliente.Que cada cambio de versión actualice sus artículos el mismo día.
Software sanitarioDatos y seguridad, con accesos por rol y por centro.Que ningún artículo ni captura enseñe datos de pacientes.
Fintech y segurosCuenta y acceso, verificación de identidad y cobros.Plazos exactos y lo que no se puede hacer, revisado con quien lleva el cumplimiento normativo.

Cómo decidir los veinte primeros artículos

La hoja de la plantilla trae una lista de partida. Sirve para no empezar de cero, pero la lista buena sale de las conversaciones de la empresa. Cinco pasos.

  1. Repasar las conversaciones de los últimos tres meses. Correo, chat y WhatsApp. Se apunta la pregunta de cada una, tal como la escribió el cliente.
  2. Juntar las que piden lo mismo. «No me deja entrar», «he perdido la contraseña» y «no me llega el correo de acceso» son un mismo artículo.
  3. Contar. Unas pocas preguntas se llevan la mayor parte del volumen. Esas van primero.
  4. Preguntar a quien más atiende. Las respuestas que copia y pega cada semana son artículos que aún no existen.
  5. Escribir diez y publicar. Los diez primeros ya se notan en la bandeja. Los diez siguientes se deciden con lo que siga llegando.

A partir de ahí la lista se alimenta sola. Cada pregunta que llega dos veces y no tiene artículo es el siguiente de la hoja. Está explicado con más detalle en cómo detectar qué le falta a la documentación.

Ver Huecos de contenido, la pantalla de Intake que agrupa por tema lo que los clientes preguntan en el portal de ayuda y ningún artículo responde. Reservar una demo

Cuando también lo lee un agente de IA

Un agente de IA responde con lo que encuentra escrito. Un artículo hecho con esta plantilla ya le sirve, y cuatro detalles marcan la diferencia.

  • Párrafos que se entienden solos. El agente recupera trozos, no el artículo entero. «Como se ha dicho arriba» no le dice nada.
  • Lo que no se puede hacer, escrito. Si no está, el agente no sabe que no existe y puede prometerlo.
  • Una sola versión de cada dato. Dos artículos con plazos distintos dan dos respuestas distintas. El viejo se retira.
  • Tablas que sean tablas. Una tabla pegada como imagen no la lee.

El detalle de cada cambio está en preparar la documentación para un agente de IA. Y la diferencia entre lo que se publica y lo que solo consulta el agente, en base de conocimiento o centro de ayuda.

Mantenerlo al día

Un centro de ayuda se queda viejo con cada versión del producto. Cuatro citas lo mantienen vivo sin convertirlo en un proyecto.

CuándoQué se revisaQuién
El día de cada versión del productoLos artículos de las pantallas que cambian. Se actualizan el mismo día.[Dueño del artículo]
Cada semanaLas preguntas que llegaron al equipo y no tenían artículo.[Responsable del centro de ayuda]
Cada mesLos artículos con más votos de «no me ha servido» y las búsquedas sin resultado.[Responsable del centro de ayuda]
Cada trimestreLos artículos sin revisar desde hace más de [seis] meses. Se actualizan o se retiran.[Responsable del centro de ayuda]

La cita que más se salta es la primera. Cuando el producto cambia, los clientes preguntan por lo nuevo ese mismo día. Por eso las notas de versión y los artículos se preparan a la vez, como explica la guía de plantillas para comunicar cambios a los clientes.

Cómo lo hace Intake

El Centro de ayuda de Intake es un portal público con buscador y colecciones. Los artículos se escriben en un editor de bloques, se guardan como borrador hasta que se publican y conservan su historial de versiones, de modo que una versión anterior se puede restaurar. Cada artículo pregunta al lector si le ha resultado útil. Los artículos del centro de ayuda actual se pueden traer con el importador. Lo que es privado de cada cliente, como sus casos o sus facturas, corresponde a un portal del cliente.

El portal lleva un asistente que contesta solo con los artículos publicados. Lo que se pregunta en el portal y ningún artículo responde aparece en Huecos de contenido, agrupado por tema y comparado con los treinta días anteriores. Cada hueco dice si falta el artículo o si el que hay no responde, y la IA propone un borrador con esas preguntas para que una persona lo revise y lo publique. Más en artículos nuevos a partir de lo que se pregunta.

Ver el Centro de ayuda y los huecos de contenido con las preguntas de los clientes de la empresa. Reservar una demo

Preguntas frecuentes

¿Cuántos artículos necesita un centro de ayuda para empezar?

Con diez artículos bien elegidos ya se nota, y con veinte queda cubierto lo que más se pregunta. Lo que importa es que respondan preguntas que llegan al equipo, no cuántos son.

¿Qué diferencia hay entre una base de conocimiento y un centro de ayuda?

El centro de ayuda es la web pública que leen los clientes. La base de conocimiento es toda la información con la que se responde, e incluye documentos que no se publican. La plantilla sirve para las dos.

¿Cómo se hace una página de preguntas frecuentes?

Con las mismas reglas, en corto. Preguntas que llegan al equipo, escritas con las palabras del cliente y contestadas en la primera frase. Cuando una respuesta necesita pasos o más de dos párrafos, pasa a ser un artículo.

¿Cuánto debe medir un artículo de ayuda?

Lo justo para responder una pregunta. Si hacen falta más de ocho o diez pasos, suele haber dos tareas mezcladas y conviene partirlo en dos artículos enlazados.

¿Hacen falta capturas y vídeos?

Las capturas ayudan a confirmar la pantalla, pero el texto tiene que entenderse sin ellas, porque envejecen con cada cambio y un agente de IA no las lee. Un vídeo corto sirve de apoyo, nunca en lugar de los pasos.

¿Se puede usar la plantilla sin pagar ni dejar un correo?

Sí. La descarga en Word y en PDF es abierta y la plantilla también se puede copiar desde esta página. Es gratis y no pide ningún dato.

Guías

Sigue leyendo

Ver todas las guías

Intake

Cómo lo resuelve Intake

Cada cliente, atendido como si fuera el único

15 minutos, sin compromiso