Automatización · Contenido y publicación

Proponer en GitBook un artículo de ayuda nuevo con la pregunta que más se repite por WhatsApp

Un agente de IA convierte la pregunta que más llega por WhatsApp en un artículo de GitBook, en un change request listo para que tu equipo lo revise.

Quiero verlo con mi operación Ver todas las automatizaciones

¿Cómo convierto las preguntas que más me hacen por WhatsApp en artículos de mi centro de ayuda?

Le pides a tu Met por WhatsApp o en el chat interno algo como «arma un artículo de ayuda sobre cómo cambiar una cita». El Met lista tus sitios de GitBook, abre la estructura del centro de ayuda para ver dónde encaja y si ya existe algo parecido, abre un change request, escribe ahí el artículo con lo que tu equipo responde por WhatsApp y lo envía a revisión. Te devuelve el enlace de vista previa para que lo leas antes de publicar. Lo publicado no cambia hasta que alguien fusiona el change request. Para escribir el contenido y armar la vista previa, el admin tiene que encender en Conexiones la acción genérica de la API de GitBook, que arranca apagada.

Qué la pone en marcha

Cuando alguien lo pide

Empieza cuando alguien del equipo le pide el artículo al Met por WhatsApp o en el chat interno, con el tema y lo que se le suele responder al cliente. No hay un trigger que configurar: el Met corre el procedimiento en esa conversación.

Una tarea de ejecución manual: alguien del equipo la corre con un botón, o se la pide al Met por chat.

Quién la ejecuta

Met de contenido para el centro de ayuda en GitBook

No tiene un nombre propio sembrado. Es un Met interno con GitBook conectado: termina cuando el artículo queda en un change request enviado a revisión y te entrega el enlace para leerlo, o cuando te dice qué paso no pudo hacer y por qué.

Lo ejecuta el Met de contenido y redes

Canales: WhatsApp · Chat del sitio web

Qué hay que tener conectado

GitBook Automatizar y colaborar

6 pasos · 5 herramientas

El procedimiento, paso a paso

Cada paso muestra la herramienta que se ejecuta. Son las del conector real: si una dejara de existir, esta página no compilaría.

1
Encontrar el sitio del centro de ayuda

El Met lista los sitios de documentación de tu organización en GitBook y toma el del centro de ayuda que indicaste en la habilidad. Si hay varios con nombres parecidos, te pregunta cuál antes de seguir.
- list_sites GitBook
2
Ver dónde encaja el artículo

El Met abre la estructura del sitio y revisa sus secciones y páginas. Si ya hay una página sobre el mismo tema, te lo dice en vez de duplicarla; si no, te propone en qué sección va el artículo nuevo.
- get_site_structure GitBook
3
Abrir un change request

El Met abre un change request en el espacio del centro de ayuda, con un título que dice qué pregunta resuelve. Así el artículo queda como borrador revisable y lo publicado no cambia.
- create_change_request GitBook
4
Escribir el artículo en el borrador

Con la acción genérica encendida, el Met llama la operación de la API de GitBook que escribe contenido en un change request (updateChangeRequestContent) y deja ahí el artículo con la respuesta que tu equipo da por WhatsApp. Si la acción está apagada, se detiene aquí y te lo dice.
- invoke_operation GitBook
5
Enviar el change request a revisión

El Met envía el change request a revisión para que la persona responsable lo apruebe en GitBook. La misma acción puede fusionar y publicar; la habilidad le indica que solo lo envíe a revisión, y si quieres que nunca fusione, el admin la apaga.
- submit_or_merge_change_request GitBook
6
Devolver el enlace de vista previa

GitBook no entrega la vista previa de un change request en una sola llamada. El Met trae los datos del espacio y del sitio con operaciones de la API (getSpaceById y getSiteById) y te responde con el enlace para leer el artículo como se verá publicado.
- invoke_operation GitBook

Antes de empezar

Qué necesitas tener listo

Ninguno de estos puntos lo resuelve el Met. Si falta uno, la automatización se detiene ahí.

Un centro de ayuda o documentación en GitBook

Tu empresa publica su centro de ayuda en GitBook, en un sitio de la organización. El Met trabaja sobre lo que la cuenta conectada puede ver en ese sitio.
GitBook conectado en Met con la acción genérica encendida

En Met, abre Conexiones → GitBook → Conectar y autoriza con una cuenta que pueda editar el centro de ayuda. Para escribir el artículo y armar la vista previa, el admin enciende la acción genérica de la API, que arranca apagada.
Lo que tu equipo responde sobre el tema

La respuesta que el equipo da por WhatsApp a esa pregunta, escrita en el pedido o en la habilidad del Met. El artículo sale de ahí; el Met no inventa políticas que tu equipo no dio.

Los límites

Qué NO resuelve esta automatización

Preferimos decirlo aquí que descubrirlo en la implementación.

No publica el artículo por su cuenta si la habilidad le dice que solo envíe a revisión. Fusionar el change request es lo que publica, y conviene que lo haga tu equipo en GitBook.
No escribe el contenido si la acción genérica de la API está apagada: en ese caso solo abre el change request vacío y te avisa.
No detecta por su cuenta cuáles son las preguntas que más se repiten. Alguien del equipo le dice el tema; el Met arma el artículo con esa información.
No pide confirmación en el chat antes de escribir en GitBook: si las acciones están encendidas, las ejecuta. El admin decide qué queda encendido en Conexiones.
No pasa por Git Sync. Si tu centro de ayuda se sincroniza con un repositorio, GitBook recomienda que los cambios grandes vayan por ahí; esta receta es para un artículo puntual.

Preguntas frecuentes

Preguntas sobre esta automatización

No. Queda en un change request, que no toca lo publicado. Se publica cuando alguien lo fusiona en GitBook, y la receta solo lo envía a revisión.

Porque escribir el contenido de un change request y armar la vista previa son operaciones de la API de GitBook que el servidor llama por una acción genérica. Como esa acción abre la API, nace apagada y la enciende el admin.

Esta receta es para uno nuevo: si el Met encuentra una página sobre el mismo tema, te avisa en vez de duplicarla. Cambiar una página existente sigue el mismo camino del change request.

Esta receta solo funciona con GitBook. Si tu centro de ayuda vive en Mintlify, Intercom o Contentful, el catálogo tiene recetas propias para esas herramientas.

Sigue por aquí