Del brief del cliente a las publicaciones en línea: una semana completa a cargo de un agente, llamada por llamada
Una semana de cliente en Shager, paso a paso: brief, archivos, borradores por cuenta, revisión, aprobación del cliente, programación, verificación e informe.
Pasar de un brief del cliente a publicaciones en línea con un agente lleva ocho etapas: confirmar el acceso y el espacio de trabajo, revisar las cuentas conectadas, subir los archivos, planificar, redactar borradores con textos por cuenta, revisar, conseguir la aprobación del cliente y, por último, programar y verificar. En cada etapa, el agente se encarga del volumen. Una persona toma tres decisiones: aprobar el plan, otorgar el permiso para publicar y, cuando el cliente lo pide, el visto bueno del propio cliente a través de un enlace de aprobación.
A continuación, una semana realista de un cliente ficticio, con cada llamada a Shager que hace el agente, en orden. El cliente, Harbor Coffee, tiene 14 cafeterías, cada una con su página de Facebook y su cuenta profesional de Instagram, más un canal de YouTube de la marca.
Lunes por la mañana: llega el brief
El ejecutivo de cuenta deja un brief en la carpeta de contexto del cliente: una nueva bebida de otoño, un lanzamiento el jueves, un 20 % de descuento el primer fin de semana, un video vertical de 25 segundos y dos fotos alojadas en el CDN del cliente. Nada más. Las instrucciones permanentes del agente le prohíben inventar cualquier cosa que el brief no diga, así que el descuento, la fecha y el nombre del producto son los únicos datos que va a usar.
La sesión arranca dentro de la carpeta del cliente, así que el agente tiene cargadas las reglas de la agencia y el archivo de tono de Harbor Coffee, y nada sobre otros clientes. Por qué eso importa se explica en un agente, muchos clientes.
Etapa 1: confirmar quién y dónde
whoami -> organization, claimed or sandbox, key scopes
list_workspaces -> "Harbor Coffee" (ws_harbor), timezone Europe/London
whoami responde dos preguntas antes de empezar a trabajar: ¿esta organización fue reclamada? y ¿la clave tiene publish? Si es un entorno de prueba sin reclamar, el agente igual puede subir archivos y crear borradores, pero programar y pedir aprobaciones fallará con un error claro hasta que una persona lo reclame. El proceso de reclamo se describe en /auth.md.
Etapa 2: revisar las cuentas
list_channels ws_harbor -> 29 channels: 14 Facebook, 14 Instagram, 1 YouTube
list_groups ws_harbor -> "All cafes FB", "All cafes IG", "Brand YouTube"
El agente revisa el estado de cada canal. Una cuenta de Instagram aparece desconectada. En lugar de esquivarla en silencio al redactar, el agente crea un enlace de conexión para el encargado de esa cafetería:
{
"tool": "create_connect_link",
"arguments": { "workspace_id": "ws_harbor", "label": "Harbor Quayside, Instagram reconnect" }
}
El ejecutivo de cuenta reenvía el enlace. El encargado de la cafetería inicia sesión en Instagram a través de él, sin cuenta de Shager, y esa misma tarde la cuenta vuelve a aparecer en list_channels.
Etapa 3: subir los archivos
Tres llamadas, una por archivo. El video lleva sus dimensiones y su duración para que la validación de Reels y Shorts pueda hacerse ahora y no al momento de publicar.
{
"tool": "upload_media_from_url",
"arguments": {
"workspace_id": "ws_harbor",
"url": "https://cdn.harbor-coffee.example/autumn/launch.mp4",
"file_name": "autumn-launch.mp4",
"width": 1080, "height": 1920, "duration_ms": 25000
}
}
Las dos fotos se suben igual, sin los campos del video.
Etapa 4: planificar y esperar
En lugar de ponerse a redactar de inmediato, el agente propone un plan:
| Día | Publicación | Formato | Destino |
|---|---|---|---|
| Mar | Foto de adelanto | FEED | All cafes FB, All cafes IG |
| Jue | Video de lanzamiento | REEL / SHORT | All cafes FB, All cafes IG, Brand YouTube |
| Sáb | Foto recordatorio del descuento | FEED | All cafes FB, All cafes IG |
El ejecutivo de cuenta responde “adelante” y pasa la publicación del sábado al viernes por la tarde. Un solo mensaje, y un plan flojo nunca llega a convertirse en 85 textos por cuenta.
Etapa 5: redactar con textos por cuenta
Cada publicación planificada se convierte en una llamada a create_post sin schedule_at, que guarda un borrador. La del lanzamiento muestra la estructura completa:
{
"tool": "create_post",
"arguments": {
"workspace_id": "ws_harbor",
"group_ids": ["grp_all_fb", "grp_all_ig", "grp_brand_yt"],
"media_ids": ["med_launch"],
"caption": "The autumn drink is here. 20% off this weekend.",
"youtube_title": "Harbor Coffee autumn drink, first pour",
"youtube_privacy": "public",
"cta_url": "https://harbor-coffee.example/autumn",
"campaign": "autumn-launch",
"label": "Harbor autumn launch video",
"first_comment": "Find your nearest Harbor and the weekend offer: https://harbor-coffee.example/autumn",
"per_channel": [
{ "channel_id": "ch_fb_quayside", "format": "REEL",
"caption": "Quayside regulars, it's here. Autumn's first pour, 20% off this weekend." },
{ "channel_id": "ch_ig_quayside", "format": "REEL",
"caption": "First pour at Quayside. 20% off all weekend, details in bio." },
{ "channel_id": "ch_yt_brand", "format": "SHORT",
"caption": "The new Harbor autumn drink, poured for the first time." }
]
}
}
En la llamada real, per_channel tiene 29 entradas, cada texto anclado en su cafetería. Al publicar, cada URL de los textos y de los comentarios se convierte en un enlace corto exclusivo de esa cuenta, con utm_content identificándola, así que el agente escribe las URL tal cual. El oficio de variar los textos se explica en variación de textos por cuenta con IA.
Etapa 6: revisar en una pasada aparte
Una segunda sesión, con un prompt de revisor y herramientas de solo lectura, llama a list_posts con status en DRAFT y a get_post para cada borrador. Busca textos duplicados, datos que no están en el brief, enlaces puestos donde no serán clicables y formatos de video aplicados a archivos que no son verticales. Esta vez señala dos textos de Instagram que dicen “enlace abajo” cuando el enlace está en la bio. El agente redactor los corrige creando borradores nuevos, y los viejos quedan fuera de la programación.
Etapa 7: aprobación del cliente
El espacio de trabajo de Harbor Coffee tiene activado approval_required, así que no se puede programar nada hasta que el cliente apruebe. El agente envía cada borrador a aprobación:
{
"tool": "request_approval",
"arguments": {
"workspace_id": "ws_harbor",
"post_id": "pst_launch",
"reviewer_name": "Dana, Harbor Coffee marketing",
"reviewer_email": "dana@harbor-coffee.example",
"send_email": true
}
}
El cliente abre el enlace, revisa la publicación y la aprueba sin iniciar sesión. El estado de la publicación pasa por IN_REVIEW hasta APPROVED, o a CHANGES_REQUESTED, en cuyo caso el agente la corrige y la vuelve a enviar. Cómo diseñar buenas reglas de aprobación se explica en aprobación humana para las publicaciones de agentes.
Etapa 8: programar y verificar
Una vez aprobada, la programación se hace con una clave que tiene el permiso publish. El agente calcula cada horario en la zona horaria del espacio de trabajo, con la diferencia horaria que corresponde a esa fecha:
{
"tool": "schedule_post",
"arguments": {
"workspace_id": "ws_harbor",
"post_id": "pst_launch",
"schedule_at": "2026-10-15T08:30:00+01:00"
}
}
Con 14 cuentas en Facebook y otras 14 en Instagram, y el escalonamiento predeterminado de 30 a 90 segundos, el envío en cada red tarda unos 13 minutos, y las dos redes avanzan en paralelo. El jueves a las 9:15, el agente llama a get_post. Veintiocho cuentas aparecen como publicadas, con sus URL en línea. Una muestra un error de permisos. El agente informa la cuenta por su nombre y sugiere un nuevo enlace de conexión; no reintenta a ciegas.
El lunes siguiente: el informe
La semana cierra con el informe: list_posts para ver qué salió, get_post para los resultados por cuenta y get_analytics para los clics por cuenta y por publicación durante la semana, cruzados con los leads del CRM por utm_content cuando el cliente los comparte. La configuración completa, incluida su ejecución sin supervisión, está en el informe semanal del cliente a cargo de un agente.
Quién hizo qué
| Etapa | Agente | Persona |
|---|---|---|
| Acceso y espacio de trabajo | Lo verifica y lo informa | |
| Cuentas | Detecta la que falla y crea el enlace | Reenvía el enlace |
| Archivos y plan | Los sube y propone | Dice “adelante” |
| Borradores y revisión | Escribe 85 textos y los revisa | |
| Aprobación | Envía los enlaces | El cliente aprueba |
| Programación | Calcula los horarios y programa | Otorgó publish una vez |
| Envío e informe | Verifica e informa | Lee el informe |
Preguntas frecuentes
¿Cuánto tiempo le lleva a una persona una semana así?
En este ejemplo, las decisiones humanas son unos pocos mensajes y una aprobación. El tiempo exacto depende del cliente y de cuántas idas y vueltas necesite el plan. Lo que cambia es el tipo de trabajo: revisar y decidir en lugar de escribir textos y armar enlaces.
¿El agente puede saltarse la aprobación del cliente en las publicaciones de rutina?
Solo si el espacio de trabajo no la exige. approval_required se define por espacio de trabajo, así que un cliente que aprueba un plan mensual puede tenerlo desactivado, mientras que un cliente más cauteloso lo mantiene activado. El agente no puede cambiar ese ajuste por su cuenta en un espacio de trabajo existente.
¿Y si el cliente pide cambios después de aprobar?
Si la publicación todavía no empezó a salir, el agente llama a cancel_post, que la devuelve a borrador aprobado, luego crea una versión corregida y la vuelve a enviar a aprobación. Una vez que la publicación empezó a salir, los cambios en las propias redes se hacen a mano.
Por dónde seguir
Prueba esta secuencia con un cliente y un grupo pequeño de cuentas antes de aplicarla a todo. Si tu agente todavía no está conectado, la página de entrada para agentes explica el servidor MCP, la API REST y el registro autónomo.
