Escribir y publicar artículos

Actualizado el 4 nov 20266 min de lectura
Español
En esta página

Escribir un artículo del centro de ayuda es sencillo: editor de texto enriquecido, título, slug, categoría, contenido y publicar. El editor admite títulos, listas, citas, enlaces, imágenes, videos insertados y bloques de código. Con los borradores puedes trabajar en equipo antes de publicar. Los artículos toman sus metadatos SEO (descripción, OpenGraph) del título y la descripción del artículo; puedes cambiarlos en cada artículo en la pestaña SEO. Fynn, el bot de IA, puede usar los artículos publicados como conocimiento en cuanto activas Tu centro de ayuda en Fynn > Lo que sabe Fynn.

Los artículos del centro de ayuda son los pilares de tu base de conocimiento. Un buen conjunto de artículos ayuda a tus clientes a encontrar respuestas por su cuenta, reduce los tickets repetidos y permite que el bot de IA de Deskwoot dé respuestas correctas al instante. Esta guía te muestra cómo crear, dar formato y publicar artículos de forma eficaz.

Crear un artículo

  1. Ve a la sección Centro de ayuda en tu panel de Deskwoot.
  2. Haz clic en “Nuevo artículo”.
  3. Escribe un título claro y descriptivo que refleje la pregunta o el tema que buscan tus clientes.
  4. Elige una categoría adecuada para que el artículo sea fácil de encontrar (todo artículo necesita una).
  5. Escribe el contenido con el editor integrado. Puedes agregar títulos, listas, imágenes, videos y enlaces para que el artículo se lea con facilidad.

Imágenes: haz clic en Subir imagen desde tu computadora en la barra del editor, pega una captura de pantalla o arrastra una imagen al texto. Funcionan archivos PNG, JPG, GIF y WebP de hasta 10 MB cada uno. La imagen destacada tiene su propio botón Subir imagen. Una imagen subida sigue privada hasta que un artículo publicado la muestra. Con la API subes con POST /v1/accounts/{accountId}/portals/{portalId}/files y pones en tu artículo la dirección que te devuelve.

Escribir contenido útil

La forma en que escribes un artículo importa tanto como la información que contiene. Ten en cuenta estas buenas prácticas:

  • Empieza con la respuesta. Pon la información más importante arriba para que los lectores la vean enseguida.
  • Usa párrafos cortos y títulos. Divide el contenido en secciones fáciles de recorrer. La mayoría de los lectores echan un vistazo antes de leer.
  • Incluye instrucciones paso a paso con listas numeradas cada vez que expliques un proceso.
  • Usa palabras sencillas. Evita la jerga y escribe como si le explicaras el tema a alguien que lo ve por primera vez.
  • Agrega imágenes cuando ayuden. Las capturas de pantalla o una breve descripción de lo que el usuario debe ver en pantalla pueden evitar confusiones.

Borrador y publicación

Los artículos nuevos se guardan como borradores de forma predeterminada, así que puedes trabajar en ellos sin cambiar tu base de conocimiento publicada. Cuando todo esté listo:

  1. Revisa el formato, los enlaces y que el artículo se lea bien.
  2. Cambia el estado a Publicado y guarda para que el artículo quede publicado y visible para los clientes. Publicar todos los borradores en la pestaña Artículos publica todos los borradores a la vez.

Puedes volver más tarde a cualquier artículo publicado para editarlo o devolverlo a borrador si necesita cambios grandes.

Errores comunes que debes evitar

  • Títulos vagos: un título como “Configuración” es más difícil de encontrar que “Cómo configurar el reenvío de correo”. Sé específico.
  • Artículos sin categoría: los artículos sin categoría pueden no aparecer en la navegación de tu portal, y a los clientes les cuesta encontrarlos.
  • Información desactualizada: revisa tus artículos de vez en cuando para asegurarte de que las instrucciones y las capturas de pantalla siguen coincidiendo con tu forma de trabajar actual.

Preguntas frecuentes

¿Puedo editar un artículo después de publicarlo?
Sí. Abre el artículo publicado, haz los cambios y guarda. Los cambios se ven en el portal publicado al instante.
¿El bot de IA usa los artículos de mi centro de ayuda?
Sí, en cuanto activas Tu centro de ayuda en Fynn > Lo que sabe Fynn. Desde ese momento, el bot de IA de Deskwoot usa tus artículos publicados para dar respuestas correctas a las preguntas de los clientes, así que mantener tu contenido al día mejora directamente la calidad de la atención automática.
¿Cómo debo organizar los artículos en categorías?
Agrupa los artículos por tema o por área del producto. Busca categorías que reflejen cómo piensan tus clientes en sus preguntas, por ejemplo, Facturación, Primeros pasos o Configuración de la cuenta.
¿Cómo creo mi primer artículo?
Centro de ayuda → Nuevo artículo. Título, slug (se genera a partir del título y puedes editarlo), categoría, contenido, estado (Borrador / Publicado). Guarda. Los artículos publicados aparecen al instante en el centro de ayuda público.
¿Debo usar el editor visual (WYSIWYG) o el modo HTML?
El editor es solo de texto enriquecido; no hay modo HTML. La barra de herramientas tiene títulos (H2, H3), negrita, cursiva, tachado, listas con viñetas y numeradas, citas, bloques de código, enlaces, Insertar imagen e Insertar video.
¿Qué es un “slug” y puedo cambiarlo?
El slug es el identificador que se usa en la URL (por ejemplo, 'how-to-reset-password' → URL https://yourslug.deskwoot.com/how-to-reset-password, o la misma ruta en tu dominio propio). Se genera a partir del título; puedes editarlo en la pestaña Inglés, y todos los idiomas lo comparten. Si cambias el slug después de publicar, se rompen los enlaces externos que apuntan a la URL anterior, así que ten cuidado.
¿Cómo agrego imágenes?
Haz clic en Insertar imagen en la barra de herramientas y pega la URL https de la imagen. El editor no sube archivos, así que primero aloja la imagen en algún lugar. Comprime las imágenes grandes, porque hacen que la página cargue más lento.
¿Puedo agregar un acordeón de preguntas frecuentes?
No en el editor de artículos. No tiene vista HTML ni bloque de acordeón. Usa títulos H2 o H3 con respuestas cortas.
¿Cómo funciona el SEO de los artículos?
La pestaña SEO tiene Título SEO (si está vacío, se usa el título del artículo) y Descripción SEO; sin una descripción SEO se usa la Descripción del artículo. La URL es https://yourslug.deskwoot.com/article-slug (o tu dominio propio). El marcado de Schema.org se genera solo, y cada centro de ayuda tiene su propio sitemap.xml para enviarlo a Google Search Console.
¿El bot de IA lee los borradores?
No. El bot solo indexa los artículos publicados. Los borradores no los ven ni los clientes ni el bot hasta que los publicas.
¿Puedo traducir artículos?
Sí. Cada artículo puede tener varias versiones de idioma. El editor de artículos tiene un botón “Traducir del inglés” (desde el plan Startup, $0.06 por traducción del saldo prepago), o puedes escribir cada idioma a mano.
¿Debo organizar los artículos con H1, H2 y H3?
Sí. H1 = título del artículo (automático). H2 = secciones principales (3-5 por artículo). H3 = subsecciones. No te saltes niveles (no pases de H1 → H3 directamente). Los títulos ayudan al SEO y a la lectura.
¿Qué tan largo debe ser un artículo?
Depende del tema. Guías de configuración: 300-800 palabras. Explicaciones de conceptos: 600-1500 palabras. Estilo preguntas frecuentes: 150-400 palabras más la lista de preguntas. Calidad > extensión: un artículo claro de 300 palabras es mejor que uno de 2000 palabras que da vueltas.
¿Puedo ver qué artículos se leen?
No hay un contador de vistas por artículo. En Informes, la sección Valoración de artículos muestra los votos de pulgar arriba y pulgar abajo que los lectores dieron a tus artículos en el widget de chat. Úsala para encontrar los artículos que necesitan mejoras.

¿Te resultó útil esta guía?

Sigue leyendo

Preguntar a Fynn sobre esta guía

Recibe una respuesta corta basada en esta guía y el resto del centro de ayuda.

¿Aún necesitas ayuda?

Fynn responde en el chat con estas guías, y ahí también puedes hablar con el equipo.

Escríbenos por correo