Docs de agentes

Redes · publicar y conversar

← Todos los módulos · Conecta tu agente →

Redes · publicar y conversar

Qué hay en el módulo

Flujos

Publicar o programar una pieza

1. La pieza debe existir en el calendario con copy (skills musa-planear y musa-copy) y, si lleva imagen o video, con su diseño o mediaUrl.

2. list_social_accounts({ workspaceId }) → destinos reales con su id.

3. Confirma con la persona: pieza, cuentas, fecha y hora.

4. publish_content({ workspaceId, contentId, mode: "now" | "schedule", accountIds, contentType: "post" | "story" | "reel", scheduledFor: "2026-11-10T09:00:00", timezone }).

5. Stories y reels necesitan Zernio y un archivo (mediaUrl HTTPS de la imagen o el video).

6. Si falla y quieres reintentar, se usan los mismos destinos; para cambiarlos, duplica la pieza.

Conectar redes del Publisher (sin la pantalla)

1. list_publisher_networks() → por red: kind, fields (claves exactas), setup, notes, appKey, y redirectUri.

2. Redes con llave (kind: "token": Telegram, Discord, Slack, Bluesky, Mastodon, WordPress, Ghost, DEV, Hashnode, Listmonk, Notion, Gumroad, Luma): pide a la persona sus datos y llama publisher_connect_token({ provider, input: { <clave>: <valor> }, brandId? }). Musa valida contra la red, cifra y devuelve la cuenta.

3. Redes OAuth (Instagram, Facebook, LinkedIn, X, Threads, Pinterest, Reddit, Google Business, Blogger): primero publisher_save_app({ app: appKey, client_id, client_secret }) (la persona registra redirectUri en el portal de la red). Luego publisher_connect_link({ provider, brandId? }) → enlace de 7 días y un uso que el dueño de la cuenta abre y aprueba una vez (ninguna API se salta ese «Permitir»). Después list_publisher_accounts().

4. Notas: Luma exige Luma Plus; con evento manda un correo a sus invitados, sin evento crea un evento privado. Gumroad envía un correo a seguidores/clientes/todos. Notion crea una página en la página o base compartida con la integración.

Publicar con el Publisher

1. La imagen debe ser un archivo público de Musa (render_frame_png o upload_image).

2. list_publisher_accounts() → ids. Confirma con la persona cuentas y texto.

3. publisher_publish({ account_ids, media_url, media_mime: "image/png", caption, captions?, mode: "live" }) (sin mode = prueba). Si remaining > 0: publisher_continue_job({ jobId }). Resultado por destino: get_publisher_job.

4. Reintentar solo si la persona lo pide: publisher_retry_job({ jobId }).

Atender la bandeja

1. list_social_inbox({ workspaceId, status: "pending" }).

2. Responde con la voz de la marca (get_brand_strategy): reply_social({ workspaceId, itemId, content }).

3. Si es un posible cliente: capture_social_contact({ workspaceId, itemId }) lo crea en el CRM; sigue en musa-vender.

4. Lo raro, las quejas o las crisis: no respondas; asígnalo a alguien del equipo con inbox_update({ itemId, assignedTo }) y avísale a la persona.

5. Lo resuelto: inbox_update({ itemId, status: "done" }); spam o irrelevante: status: "hidden".

¿Qué pieza trajo conversaciones?

Herramientas

Reglas

Ejemplos

Documentación de agentes de Musaworks · actualizado 2026-11-20