workyol

¿Qué hace workyol?

Workyol es un programa que se ejecuta en el ordenador de la persona. Funciona con las plataformas oficiales de Meta (WhatsApp Business Platform, Instagram, Messenger), con la API de LinkedIn y, donde esté abierta, con la API de YouTube. Este skill le indica cómo usar sus herramientas MCP.

Cuándo usarlo

Use este skill cuando la persona quiera:

• enviar una campaña de plantilla de WhatsApp a una lista de contactos que haya aceptado;
• leer respuestas no leídas (WhatsApp, Instagram, Messenger) y responderlas;
• añadir auto-respuestas por palabras clave, o reglas de comentario a mensaje privado;
• programar Reels, fotos o carruseles (Instagram y Facebook), publicaciones de LinkedIn o vídeos de YouTube;
• comprobar su configuración o números de Workyol.

No lo use para personas que no hayan aceptado ser contactadas.

Requisito

1. Workyol está instalado y ejecutándose en el ordenador (se abre en localhost:4747).
2. El servidor MCP de Workyol está conectado a este asistente (consulte el README: en Workyol, Conexiones, Asistentes de IA, Conectar junto a la aplicación).

Primer paso en cada sesión: llame a check_setup (qué está hecho / falta en Configuración) y get_overview (contactos, mensajes, respuestas no leídas, publicaciones en espera). Si las herramientas no existen o responden "Workyol no se está ejecutando", deténgase y dígale a la persona que inicie Workyol y conecte el servidor MCP. No adivine.

La mayoría de las herramientas toman un account opcional (nombre, Página de Facebook o @instagram); sin él se usa la cuenta predeterminada. Use list_accounts primero cuando haya varias marcas o clientes.

Herramientas

Resumen y configuración

• list_accounts: las cuentas (marcas/clientes) y qué tiene conectado cada una.
• get_overview: contactos, mensajes enviados/entregados/leídos, respuestas no leídas, Página/Instagram/WhatsApp conectados, publicaciones en espera.
• check_setup: qué está hecho y qué falta en Configuración (licencia, modo real, aplicación Meta, WhatsApp, Página + Instagram, webhooks). Úselo para indicarle a la persona el siguiente paso.
• quick_connect: conectar la Página de Facebook de un cliente (y su Instagram) como cuenta de Workyol en un solo paso, a partir de un token que la persona copió en Graph API Explorer. Parámetros: token, name, business_type (general, dental, realestate, wholesale, restaurant, salon, school, none), page_id, language (en, fr, tr, ar, es), confirm. Las automatizaciones predefinidas se añaden DESACTIVADAS.

Bandeja de entrada

• list_replies: mensajes que las personas han enviado, los más nuevos primero, agrupados por persona. Parámetros: unread_only, limit.
• send_reply: responder a una persona en el mismo canal. Parámetros: channel (whatsapp, instagram, messenger), to (el valor de list_replies), text, confirm. WhatsApp solo permite texto libre dentro de las 24 horas posteriores al último mensaje de la persona.

Automatizaciones

• list_automations: auto-respuestas por palabras clave y reglas de comentario a MD.
• add_automation: parámetros type (auto_reply o comment_to_dm), keywords, channel, reply (auto_reply), file_link (enlace https opcional a una imagen, vídeo, audio o PDF), private_message y public_reply (comment_to_dm), name, confirm. {name} en un texto se convierte en el nombre de la persona.

Campañas de WhatsApp

• list_contact_lists: listas de personas que aceptaron recibir comunicaciones del negocio.
• list_templates: plantillas de WhatsApp aprobadas por Meta (las campañas solo pueden usar estas), con variables.
• list_campaigns: campañas con enviados/entregados/leídos/fallidos.
• create_campaign: enviar o programar una plantilla aprobada a una lista que haya aceptado. Parámetros: list_id, template_name, template_language, name, mapping, scheduled_at, confirm. Sin confirm devuelve una vista previa (cuántos la reciben, cuántos se saltan y por qué).

Publicaciones de Instagram y Facebook

• list_posts: publicaciones programadas y publicadas (filtro status: waiting, published, failed, all).
• schedule_post: un Reel (video_path: MP4 vertical, 9:16, máximo 100 MB, cover_path opcional) o imágenes (image_paths: 1 = foto, 2 a 10 = carrusel; Instagram solo acepta JPG). También caption (máximo 2200 caracteres), at (ISO 8601 con zona horaria), platforms (instagram, facebook), from_workyol_com, confirm.
• import_content_plan: programar un plan completo desde una carpeta con una hoja CSV (columnas date, time, caption, files, opcional channels) y los archivos multimedia. Sin confirm lista cada fila con su estado. Una fila nunca se programa dos veces.
• delete_post: eliminar una publicación programada (una publicada permanece en línea).

LinkedIn (el perfil propio de la persona)

• linkedin_status: conectado o no, días de acceso restantes (60 días, luego la persona hace clic en Reconectar), publicaciones en espera.
• linkedin_schedule_posts: una o varias publicaciones. Cada una: text (máximo 3000 caracteres, texto plano, se permiten hashtags), at, media_path opcional (imagen JPG/PNG o MP4), lang opcional. Máximo 60 publicaciones por llamada.
• linkedin_list_posts: publicaciones programadas, publicadas y fallidas.
• linkedin_delete_post: eliminar una publicación programada (una publicada permanece en LinkedIn).

YouTube (solo donde YouTube esté abierto para esta licencia; en el momento de redactar esto no está abierto para clientes aún, y las herramientas responden "YouTube aún no está abierto")

• youtube_status, youtube_playlists, youtube_list, youtube_schedule (MP4/MOV hasta 2 GB; título, descripción, etiquetas, publish_at, privacy, thumbnail_path, playlist, first_comment; 3 subidas al día por canal, los vídeos adicionales esperan al día siguiente), youtube_delete.

Flujos de trabajo

Preparar una campaña de WhatsApp

1. check_setup, luego list_contact_lists y list_templates.
2. Elija la lista y una plantilla aprobada con la persona. Solo se muestran listas con aceptación.
3. Llame a create_campaign sin confirm. Muestre la vista previa: quién la recibe, quién se salta y por qué.
4. Solo si la persona dice que sí, llámela de nuevo con confirm: true. Ofrezca scheduled_at si quieren una hora posterior.
5. Después: list_campaigns para informar de enviados/entregados/leídos/fallidos.

Responder respuestas no leídas

1. list_replies con unread_only: true.
2. Resuma por persona y canal. Redacte una respuesta para cada uno.
3. Muestre cada borrador. Envíe cada uno con send_reply y confirm: true solo después de que la persona lo apruebe.
4. En WhatsApp, si el último mensaje tiene más de 24 horas, un texto libre fallará: dígale a la persona que se necesita una plantilla.

Añadir una auto-respuesta por palabra clave o comentario a MD

1. list_automations para evitar duplicados.
2. Muestre la regla (palabras clave, canal, respuesta) como una tabla.
3. Tras un sí, add_automation con confirm: true.

Programar una semana de Reels

1. Pida los archivos de vídeo, los pies de foto y las horas (con zona horaria).
2. list_posts para ver qué hay ya en espera.
3. Muestre el horario completo. Tras un sí, llame a schedule_post para cada publicación con confirm: true. O, para una carpeta con una hoja CSV, use import_content_plan (vista previa primero).

Programar un mes de publicaciones de LinkedIn

1. linkedin_status: si no está conectado, o quedan pocos días, dígale a la persona que se conecte o reconecte en Workyol.
2. Escriba las publicaciones en texto plano (sin markdown ni negrita). Muéstrelas todas con sus fechas.
3. Tras un sí, linkedin_schedule_posts con confirm: true.

Reglas de seguridad (sígalas siempre)

• Nada se envía, publica o cambia hasta que la persona diga que sí. Llame a la herramienta sin confirm primero, muestre el resumen, y pase confirm: true solo después de un sí claro a esa acción exacta.
• Solo listas que hayan aceptado. Las campañas van solo a listas de contactos importadas en Workyol con la casilla de aceptación marcada. Ninguna herramienta puede añadir números de teléfono. Nunca envíe mensajes a personas que no lo hayan solicitado.
• Sin spam, sin mensajes masivos a desconocidos. Respete STOP: las personas que responden STOP son omitidas por Workyol.
• Usted nunca ve tokens de acceso, el secreto de la aplicación ni la clave de licencia. No los pida.
• Las reglas propias de Workyol siguen aplicándose: la ventana de 24 horas de WhatsApp, las exclusiones, las plantillas aprobadas, los límites de licencia y los límites diarios de Meta.
• Meta solo permite que una empresa responda a personas que escribieron primero en Instagram y Messenger. No hay campañas en esos canales.
• No prometa resultados como "sin baneo". Diga solo que Workyol usa las APIs oficiales.

Ejemplos de prompts

• "Comprueba mi configuración de Workyol y dime qué falta."
• "¿Cuántas respuestas no leídas tengo? Resúmelas y redacta respuestas."
• "Prepara una campaña de WhatsApp con la plantilla aprobada 'order_ready' para mi lista 'Clientes 2026'. Muéstrame primero la vista previa."
• "Añade una auto-respuesta: cuando alguien escriba CATÁLOGO, responde con este texto y envíale mi PDF."
• "Cuando alguien comente PRECIO debajo de mi publicación, envíales un mensaje privado con nuestros precios."
• "Programa estos 5 vídeos como Reels en Instagram y Facebook, uno cada día a las 18:00."
• "Importa el plan de contenido desde la carpeta C:\planes\noviembre y muéstrame la vista previa."
• "Programa 12 publicaciones de LinkedIn sobre cuidado dental, dos por semana, y muéstramelas primero."