📚 Artículos

Los artículos forman tu base de conocimientos o Centro de ayuda: respuestas escritas una sola vez que tus clientes pueden leer por su cuenta, sin esperar a un agente. Bien mantenidos, reducen el volumen de conversaciones y además sirven como fuente de entrenamiento para el chatbot.

Esta página explica cómo crear artículos y categorías, y todas las formas de mostrárselos a tus clientes:

Crear y editar artículos

Abre Artículos en el menú lateral del panel. El área tiene dos pestañas arriba: Artículos y Categorías. A la derecha están los accesos a Ajustes (te lleva a Ajustes > Artículos) y a Informes (te lleva directo a las estadísticas de artículos).

Si eres agente y no ves el área, pide a un administrador que active Ajustes > Administración > Agentes y permisos > Privilegios del agente > Área de artículos. Los supervisores la ven si tienen marcado Área de artículos en Ajustes > Administración > Agentes y permisos > Supervisores. Un administrador deja de verla si se activa Desactivar artículos (ver «Desactivar los artículos» más abajo).

Nuevo artículo

En la pestaña Artículos, pulsa Agregar nuevo artículo.
Completa los campos:
- Título: el nombre del artículo, tal como lo verá el cliente.
- Contenido: el cuerpo del artículo, con el editor de bloques (párrafos, encabezados, listas, imágenes, etc.).
- Enlace externo (opcional): si lo rellenas, al final del artículo aparece un botón Leer más que abre esa dirección.
- Categoría principal: la categoría de primer nivel a la que pertenece el artículo.
- Categorías: una subcategoría dentro de la principal (opcional). Primero elige la categoría principal; si no, el panel te avisa «Seleccione primero una categoría principal.»
Pulsa Guardar cambios.

Una vez guardado, el artículo muestra su ID al pie del formulario y se activa el icono de Vista previa (arriba a la derecha), que abre el artículo en su página pública en una pestaña nueva.

Para editar un artículo, haz clic en su nombre en la lista de la izquierda, cambia lo que necesites y pulsa Guardar cambios. Si intentas salir con cambios sin guardar, el panel te pide confirmación.
Para borrarlo, usa el icono de papelera junto a su nombre en la lista. El borrado es permanente.

Consejo de estructura: usa encabezados de nivel 2 y 3 (H2/H3) para dividir artículos largos. Con ellos ZampiBot genera automáticamente el índice del artículo en la página pública (ver «Índice del artículo» más abajo).

Categorías

En la pestaña Categorías:

Pulsa Agregar nueva categoría.
Completa Nombre, Descripción e Imagen (opcional; .png, .jpg, .jpeg, .gif o .webp).
Activa el interruptor Categoría principal si es una categoría de primer nivel. Si lo dejas apagado, la categoría funciona como subcategoría y aparece en el campo Categorías de cada artículo.
Pulsa Guardar cambios. En esta pestaña, el botón guarda todas las categorías a la vez.

Si usas categorías, asigna todos tus artículos a una categoría principal. En la página de artículos, la portada se organiza por categorías principales, y un artículo sin categoría no aparece dentro de ninguna.

Traducir artículos y categorías

Puedes tener cada artículo y cada categoría en varios idiomas:

Abre el artículo (o la categoría) que quieres traducir.
Junto al título verás las banderas de los idiomas que ya tiene. Pulsa el botón + (Agregar traducción) y elige el idioma.
Escribe la traducción y pulsa Guardar cambios.

Para pasar de un idioma a otro, haz clic en su bandera.
Para borrar una traducción, pasa el cursor sobre su bandera y pulsa el icono de papelera.
Las traducciones de un artículo heredan las categorías del artículo original; por eso, al editar una traducción, los campos de categoría no aparecen.

Más abajo, en «Idioma y traducción automática», se explica qué versión ve cada cliente.

Mostrar los artículos en el widget de chat

Panel de artículos en el widget

Activa Ajustes > Artículos > Visualización del panel > Mostrar en el tablero para que el widget muestre el bloque Centro de ayuda: un buscador, hasta 4 artículos sugeridos y el botón Todos los artículos.

Opciones relacionadas en Ajustes > Artículos (tarjetas Visualización del panel y Enlaces y URLs):

Opción	Qué hace
Mostrar en el tablero	Muestra el panel de artículos en el widget. También es necesario para la pantalla Ayuda de la barra del widget.
Mostrar categorías	En el panel muestra las categorías en lugar de la lista de artículos.
Título del panel	Cambia el título del bloque (por defecto, «Centro de ayuda»).
Enlace del botón de artículos	Si escribes una URL, el botón Todos los artículos abre esa dirección en lugar del panel de artículos del widget.

Si usas la barra de pantallas del widget (Inicio · Conversaciones · Ayuda), la pantalla Ayuda solo está disponible con Mostrar en el tablero activo, y la tarjeta del Centro de ayuda en Inicio se controla desde Ajustes > Chat > Pantalla de inicio (Mostrar la tarjeta del Centro de ayuda y Ocultar los artículos sugeridos). Detalles en Ajustes.

Compartir artículos dentro de una conversación

Shortcode [articles]: envíalo en un mensaje (o úsalo en una respuesta del chatbot) y el cliente verá el bloque del Centro de ayuda dentro del chat, con buscador y artículos sugeridos.
Abrir un artículo concreto: crea un botón con el mensaje enriquecido button y pon como enlace #article- seguido del ID del artículo. Al pulsarlo, el artículo se abre dentro del widget.

[button link="#article-12" name="Ver cómo cambiar mi contraseña"]

Desde un flujo del chatbot: en el bloque de acción de Flujos puedes usar la acción Mostrar un artículo e indicar su ID. Consulta Chatbot e Inteligencia artificial.

Más información sobre los mensajes enriquecidos en Conversaciones.

Página de artículos alojada por ZampiBot (la forma más sencilla)

ZampiBot publica automáticamente una página pública con todos tus artículos, sin que tengas que instalar nada. Su dirección es:

https://articles.chatbot.zampisoft.com/TU_ID

donde TU_ID es el número de tu cuenta (el mismo que aparece en init.js?id=… de tu código de instalación).

La forma más fácil de obtenerla es copiarla del portal: https://chatbot.zampisoft.com/app/portal/ > Instalación > tarjeta Enlaces a artículos. Puedes enlazarla desde el menú de tu web, desde un correo o desde el botón Todos los artículos (con la opción Enlace del botón de artículos).

La página incluye:

portada con tus categorías principales (con imagen y descripción) y sus artículos;
buscador de artículos;
ruta de navegación (breadcrumbs) y página de cada categoría;
página de cada artículo con su índice, el botón Leer más si tiene enlace externo y la valoración Útil / No es útil;
el widget de chat de tu cuenta, para que el cliente pueda escribirte si el artículo no le resolvió la duda.

Las direcciones internas ya son legibles, por ejemplo:

Página	Dirección
Portada	`https://articles.chatbot.zampisoft.com/TU_ID`
Una categoría	`https://articles.chatbot.zampisoft.com/TU_ID/category/ID-DE-CATEGORIA`
Un artículo	`https://articles.chatbot.zampisoft.com/TU_ID/ID-O-SLUG-DEL-ARTICULO`

Para forzar un idioma, añade ?lang= con el código de dos letras, por ejemplo ?lang=es.

En la página alojada no necesitas activar Reescritura de URL ni configurar URL de la página de artículos: ZampiBot ya genera las direcciones amigables. Si rellenas URL de la página de artículos con otra dirección, los enlaces internos de los artículos (categorías, buscador, artículos relacionados) apuntarán a esa otra dirección.

Mostrar los artículos en una página de tu propio sitio

Si prefieres que el Centro de ayuda viva dentro de tu web, tienes dos métodos. En ambos casos, primero:

Crea en tu sitio la página que va a mostrar los artículos (por ejemplo, https://tusitio.com/ayuda).
Escribe esa dirección en Ajustes > Artículos > Enlaces y URLs > URL de la página de artículos. Así los enlaces a categorías, búsquedas y artículos apuntarán a tu página y no a la página alojada.

Método JavaScript

Es el más fácil: solo pegas código HTML. Inserta esto en el cuerpo de tu página, en el lugar donde quieres que aparezcan los artículos:

<script>var SB_ARTICLES_PAGE = true;</script>
<div id="sb-articles" class="sb-loading"></div>
<script id="chat-init" async src="https://chatbot.zampisoft.com/account/js/init.js?id=TU_ID"></script>

Reemplaza TU_ID por el número de tu cuenta. Lo más seguro es copiar tu propio código de instalación desde el portal (Instalación > Código de inserción) y añadir las otras dos líneas.
Si en esa página ya tienes el código del widget, no lo pegues dos veces: añade solo las dos primeras líneas.
Los artículos se cargan dentro del <div id="sb-articles">, y la navegación (categorías, búsqueda, artículo) funciona con los parámetros ?category=, ?article_id= y ?search= en la dirección de tu página.

Este método no es el mejor para el SEO: los artículos se cargan después de abrir la página, y es posible que los buscadores no los indexen. Si el posicionamiento en Google es importante para ti, usa la página alojada o el método por API.

Método por API (recomendado para SEO)

Con este método, tu servidor pide el HTML de los artículos a ZampiBot y lo imprime directamente en la página, así los buscadores ven el contenido completo. Requiere que tu sitio pueda ejecutar código en el servidor (el ejemplo es PHP) y conocimientos técnicos básicos.

Necesitas tu Token de API: lo encuentras en el portal, Instalación > Token de API.

⚠️ El token de API da acceso administrativo a tu cuenta. Úsalo solo en el código del servidor, nunca en HTML ni en JavaScript visible para el navegador, y no lo compartas.

Ejemplo en PHP:

<div id="sb-articles">
<?php
// Reenvía a ZampiBot la página que pidió el visitante: categoría, artículo, búsqueda o idioma.
$query = [];
foreach (['category', 'article_id', 'search', 'lang'] as $key) {
    if (!empty($_GET[$key]) && is_string($_GET[$key])) {
        $query[$key] = $_GET[$key];
    }
}
$ch = curl_init('https://chatbot.zampisoft.com/script/include/api.php' . ($query ? '?' . http_build_query($query) : ''));
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_CONNECTTIMEOUT => 5,
    CURLOPT_TIMEOUT => 15,
    CURLOPT_POSTFIELDS => http_build_query([
        'function' => 'init-articles',
        'token' => 'TU_TOKEN_DE_API',
        // 'nojquery' => 'true', // si tu página ya carga jQuery
        // 'nojs' => 'true',     // si tu página ya tiene el código del widget de ZampiBot
    ]),
]);
echo curl_exec($ch);
curl_close($ch);
?>
</div>

Qué hace cada parte:

La petición es un POST a https://chatbot.zampisoft.com/script/include/api.php con function=init-articles y tu token.
La respuesta es el HTML del Centro de ayuda, junto con las hojas de estilo y el script del widget de tu cuenta (necesario para el buscador, el índice y las valoraciones).
nojquery: no incluye jQuery en la respuesta. Úsalo solo si tu página ya lo carga.
nojs: no incluye el script del widget. Úsalo solo si tu página ya tiene tu código de instalación de ZampiBot, para no cargarlo dos veces.
Los parámetros category, article_id, search y lang que llegan a tu página se reenvían en la dirección de la API; así ZampiBot sabe qué mostrar en cada momento.

El antiguo método por GET con api.php?articles=true ya no se usa. Utiliza siempre el POST con function=init-articles de este ejemplo.

Reescritura de URL (solo si alojas la página en tu propio servidor Apache)

Por defecto, los enlaces de tu página usan parámetros, por ejemplo tusitio.com/ayuda?article_id=12 o tusitio.com/ayuda?category=facturacion. Si tu sitio corre en Apache y quieres direcciones más limpias (tusitio.com/ayuda/12, tusitio.com/ayuda/category/facturacion):

Activa Ajustes > Artículos > Enlaces y URLs > Reescritura de URL.
Añade reglas como estas al archivo .htaccess de tu sitio. En el ejemplo, la página se llama ayuda.php y se publica como /ayuda; cambia ambos nombres por los tuyos:

<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteRule ^ayuda/?$ ayuda.php [L,QSA]
    RewriteRule ^ayuda/category/([^/]+)/?$ ayuda.php?category=$1 [L,QSA]
    RewriteRule ^ayuda/([^/]+)/?$ ayuda.php?article_id=$1 [L,QSA]
</IfModule>

Comprueba que URL de la página de artículos sea la dirección pública de esa página (por ejemplo, https://tusitio.com/ayuda).

No necesitas nada de esto si usas la página alojada en articles.chatbot.zampisoft.com, que ya tiene direcciones amigables. Si activas la reescritura sin crear las reglas en tu servidor, los enlaces de tu página darán error 404.

Opciones de la página de artículos

En Ajustes > Artículos también ~~encontrarás:~~encontrarás (repartidas entre las tarjetas Visualización del panel, Enlaces y URLs y Funciones adicionales):

Opción	Qué hace
URL de la página de artículos	La dirección de tu página de artículos. Déjala vacía si usas la página alojada por ZampiBot.
Menú izquierdo	En la página de cada artículo, muestra a la izquierda un menú con todas las categorías principales y sus artículos.
Reescritura de URL	Usa direcciones amigables en tu propia página (ver la sección anterior).
Botón adicional	Muestra un enlace al final de cada artículo, por ejemplo para abrir un ticket o contactar. Tiene los campos Activo, Texto (frase que acompaña al botón), Botón de texto (el texto del botón; por defecto «Leer más») y Enlace del botón. El botón solo aparece si tiene enlace.
Idioma	Opciones de idioma de los artículos (ver la sección siguiente).

Índice del artículo

En la página de cada artículo se genera automáticamente un índice con los encabezados H2 y H3 del contenido. Al hacer clic en una entrada, la página se desplaza a esa sección. En teléfonos, el índice se abre con el botón de la parte superior.

Idioma y traducción automática

Las opciones están en Ajustes > Artículos > Funciones adicionales > Idioma:

Opción	Qué hace
Traducción automática	Traduce automáticamente artículos y categorías al idioma del cliente cuando no existe una traducción escrita por ti.
Menú de idiomas	Muestra, al final de cada artículo, un selector con todos los idiomas en los que está disponible.
Idioma predeterminado	El idioma en que escribiste los artículos originales. Configúralo siempre que uses traducciones.

Cómo decide ZampiBot qué ver:

El idioma del cliente es el que ZampiBot detecta (el de su navegador o el que tenga en su perfil). Puedes forzarlo añadiendo lang=CÓDIGO a la dirección de la página, con el código de dos letras del idioma (por ejemplo ?lang=es).
Sin traducción automática: si existe al menos un artículo traducido al idioma del cliente, la portada y las categorías muestran solo los artículos de ese idioma. Si no hay ninguno, se muestran todos los artículos en su idioma original.
Con traducción automática: se muestran todos los artículos; los que no tienen traducción escrita por ti se traducen con Google y la traducción se guarda para las siguientes visitas.

La Traducción automática solo funciona si también está activa la opción Multilingüe a través de la traducción en ~~la tarjeta~~ ~~Google~~ de Ajustes > Inteligencia artificial > Google y búsqueda > Google. LaSi en esa misma opción el Modo de sincronización es Automático, la traducción usa el servicio de Google de ~~la plataforma~~ZampiBot y consume ~~créditos;~~créditos ~~consulta~~(sin créditos, el artículo se muestra en su idioma original); en modo Manual usa las credenciales de Google que configures tú. Consulta Tu cuenta, créditos y seguridad.

Artículos, chatbot e informes

Entrenamiento del chatbot: tus artículos se usan como fuente cuando entrenas el chatbot desde el área Chatbot ~~> Entrenamiento~~ (pestaña de entrenamiento, que en pantalla aparece como Capacitación) con el botón Entrenar chatbot. Si creas o cambias artículos, vuelve a entrenar para que el chatbot use la versión nueva. Más detalles en Chatbot e Inteligencia artificial.
Enlaces a las fuentes: si activas la opción del chatbot que añade enlaces a las fuentes en sus respuestas, los enlaces a artículos se construyen con la página de artículos (la alojada o la que indiques en URL de la página de artículos).
Informes: ZampiBot registra las búsquedas en el Centro de ayuda, las visitas a cada artículo y las valoraciones Útil / No es útil. Las ves en Informes, categoría de artículos (también desde el enlace Informes del área Artículos). Consulta Informes.

Desactivar los artículos

Si no vas a usar la base de conocimientos, ~~puedes apagarla por completo en~~activa Ajustes > Misceláneas > Sistema y rendimiento > Optimización del rendimiento > Desactivar artículos.: Elel área Artículos deja de aparecer en el ~~panel~~menú lateral de los administradores.

Esta opción no apaga el Centro de ayuda del widget ni la página de artículos. Para que el widget deje de mostrar artículos, desactiva también Mostrar en el tablero. Los agentes y ~~los~~supervisores ~~artículos~~que ~~dejan~~tengan el permiso Área de ~~cargarse.~~artículos siguen viendo el área.

Solución de problemas

El widget no muestra el Centro de ayuda: comprueba que Mostrar en el tablero esté activo y que haya al menos un artículo guardado.
Un artículo no aparece en la portada de la página de artículos: revisa que tenga una Categoría principal asignada.
Los enlaces de mi página propia llevan a articles.chatbot.zampisoft.com: rellena URL de la página de artículos con la dirección de tu página.
Los enlaces de mi página propia dan error 404: si activaste Reescritura de URL, revisa las reglas de tu .htaccess; si no las vas a usar, desactiva la opción.
Algún bloque del editor no se guarda: prueba a desactivar las extensiones del navegador y vuelve a intentarlo.