afrikyol/workyol

O que workyol faz?

Workyol é um programa que roda no computador da pessoa. Ele funciona com as plataformas oficiais da Meta (WhatsApp Business Platform, Instagram, Messenger), com a API do LinkedIn e, onde estiver aberta, a API do YouTube. Esta skill ensina como usar as ferramentas MCP do Workyol.

Quando usar

Use esta skill quando a pessoa quiser:

• enviar uma campanha de template do WhatsApp para uma lista de contatos que fez opt-in;
• ler respostas não lidas (WhatsApp, Instagram, Messenger) e respondê-las;
• adicionar auto-respostas por palavra-chave ou regras de comentário-para-DM;
• agendar Reels, fotos ou carrosséis (Instagram e Facebook), posts do LinkedIn ou vídeos do YouTube;
• verificar a configuração ou os números do Workyol.

Não use para pessoas que não concordaram em ser contactadas.

Requisitos

1. Workyol está instalado e rodando no computador (abre em localhost:4747).
2. O servidor MCP do Workyol está conectado a este assistente (veja o README: em Workyol, Connections, AI assistants, Connect ao lado do app).

Primeiro passo em toda sessão: chame check_setup (o que está feito/faltando em Set up) e get_overview (contatos, mensagens, respostas não lidas, posts aguardando). Se as ferramentas não existirem ou responderem "Workyol não está rodando", pare e informe a pessoa para iniciar o Workyol e conectar o servidor MCP. Não adivinhe.

A maioria das ferramentas aceita um parâmetro opcional account (nome, Página do Facebook ou @instagram); sem ele, a conta padrão é usada. Use list_accounts primeiro quando houver várias marcas ou clientes.

Ferramentas

Visão geral e configuração

• list_accounts: as contas (marcas/clientes) e o que cada uma tem conectado.
• get_overview: contatos, mensagens enviadas/entregues/lidas, respostas não lidas, Página/Instagram/WhatsApp conectados, posts aguardando.
• check_setup: o que está feito e o que está faltando em Set up (licença, modo ao vivo, app Meta, WhatsApp, Página + Instagram, webhooks). Use para informar a pessoa sobre o próximo passo.
• quick_connect: conectar a Página do Facebook de um cliente (e seu Instagram) como uma conta Workyol em uma etapa, a partir de um token que a pessoa copiou no 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. Automações prontas são adicionadas DESLIGADAS.

Caixa de entrada

• list_replies: mensagens que as pessoas enviaram, das mais recentes para as mais antigas, agrupadas por pessoa. Parâmetros: unread_only, limit.
• send_reply: responder uma pessoa no mesmo canal. Parâmetros: channel (whatsapp, instagram, messenger), to (o valor de list_replies), text, confirm. WhatsApp permite texto livre apenas dentro de 24 horas após a última mensagem da pessoa.

Automações

• list_automations: regras de auto-resposta por palavra-chave e comentário-para-DM.
• add_automation: parâmetros type (auto_reply ou comment_to_dm), keywords, channel, reply (auto_reply), file_link (opcional, link https para uma imagem, vídeo, áudio ou PDF), private_message e public_reply (comment_to_dm), name, confirm. {name} no texto se torna o nome da pessoa.

Campanhas de WhatsApp

• list_contact_lists: listas de pessoas que concordaram em receber comunicações da empresa.
• list_templates: templates do WhatsApp aprovados pelo Meta (campanhas só podem usar estes), com variáveis.
• list_campaigns: campanhas com enviados / entregues / lidos / falhas.
• create_campaign: enviar ou agendar um template aprovado para uma lista com opt-in. Parâmetros: list_id, template_name, template_language, name, mapping, scheduled_at, confirm. Sem confirm, retorna uma prévia (quantos recebem, quantos são pulados e por quê).

Posts do Instagram e Facebook

• list_posts: posts agendados e publicados (filtro status: waiting, published, failed, all).
• schedule_post: um Reel (video_path: MP4 vertical, 9:16, máx 100 MB, cover_path opcional) ou imagens (image_paths: 1 = foto, 2 a 10 = carrossel; Instagram aceita apenas JPG). Também caption (máx 2200 caracteres), at (ISO 8601 com fuso horário), platforms (instagram, facebook), from_workyol_com, confirm.
• import_content_plan: agendar um plano completo a partir de uma pasta com uma planilha CSV (colunas date, time, caption, files, canais opcionais) e as mídias. Sem confirm, lista cada linha com seu status. Uma linha nunca é agendada duas vezes.
• delete_post: remover um post agendado (um publicado permanece online).

LinkedIn (perfil próprio da pessoa)

• linkedin_status: conectado ou não, dias de acesso restantes (60 dias, então a pessoa clica em Reconectar), posts aguardando.
• linkedin_schedule_posts: um ou vários posts. Cada um: text (máx 3000 caracteres, texto simples, hashtags permitidas), at, media_path opcional (JPG/PNG ou MP4), lang opcional. Máx 60 posts por chamada.
• linkedin_list_posts: posts agendados, publicados e com falha.
• linkedin_delete_post: remover um post agendado (um publicado permanece no LinkedIn).

YouTube (apenas onde o YouTube está aberto para esta licença; no momento da escrita, ainda não está aberto para clientes, e as ferramentas então respondem "YouTube não está aberto ainda")

• youtube_status, youtube_playlists, youtube_list, youtube_schedule (MP4/MOV até 2 GB; título, descrição, tags, publish_at, privacy, thumbnail_path, playlist, first_comment; 3 envios por dia por canal, vídeos extras aguardam o próximo dia), youtube_delete.

Fluxos de trabalho

Preparar uma campanha de WhatsApp

1. check_setup, depois list_contact_lists e list_templates.
2. Escolha a lista e um template aprovado com a pessoa. Apenas listas com opt-in são mostradas.
3. Chame create_campaign sem confirm. Mostre a prévia: quem recebe, quem é pulado e por quê.
4. Somente se a pessoa disser sim, chame novamente com confirm: true. Ofereça scheduled_at se quiser um horário posterior.
5. Depois: list_campaigns para relatar enviados / entregues / lidos / falhas.

Responder respostas não lidas

1. list_replies com unread_only: true.
2. Resuma por pessoa e canal. Rascunhe uma resposta para cada.
3. Mostre cada rascunho. Envie cada um com send_reply e confirm: true somente após a pessoa aprovar.
4. No WhatsApp, se a última mensagem for mais antiga que 24 horas, um texto livre falhará: informe a pessoa de que é necessário um template.

Adicionar uma auto-resposta por palavra-chave ou comentário-para-DM

1. list_automations para evitar duplicatas.
2. Mostre a regra (palavras-chave, canal, resposta) como uma tabela.
3. Após um sim, add_automation com confirm: true.

Agendar uma semana de Reels

1. Pergunte pelos arquivos de vídeo, legendas e horários (com fuso horário).
2. list_posts para ver o que já está aguardando.
3. Mostre a agenda completa. Após um sim, chame schedule_post para cada post com confirm: true. Ou, para uma pasta com planilha CSV, use import_content_plan (prévia primeiro).

Agendar um mês de posts no LinkedIn

1. linkedin_status: se não estiver conectado ou com poucos dias restantes, informe a pessoa para conectar ou reconectar no Workyol.
2. Escreva os posts em texto simples (sem markdown ou negrito). Mostre todos com suas datas.
3. Após um sim, linkedin_schedule_posts com confirm: true.

Regras de segurança (siga sempre)

• Nada é enviado, publicado ou alterado até a pessoa dizer sim. Chame a ferramenta sem confirm primeiro, mostre o resumo e passe confirm: true apenas após um sim claro para aquela ação exata.
• Apenas listas com opt-in. Campanhas vão somente para listas de contatos importadas no Workyol com a caixa de opt-in marcada. Nenhuma ferramenta pode adicionar números de telefone. Nunca envie mensagens para pessoas que não pediram.
• Sem spam, sem mensagens em massa para estranhos. Respeite STOP: pessoas que respondem STOP são ignoradas pelo Workyol.
• Você nunca vê tokens de acesso, o segredo do App ou a chave de licença. Não peça por eles.
• As regras próprias do Workyol ainda se aplicam: a janela de 24 horas do WhatsApp, opt-outs, templates aprovados, limites de licença e limites diários do Meta.
• O Meta só permite que uma empresa responda a pessoas que escreveram primeiro no Instagram e Messenger. Não há campanhas nesses canais.
• Não prometa resultados como "sem banimento". Diga apenas que o Workyol usa as APIs oficiais.

Exemplos de prompts

• "Verifique minha configuração do Workyol e me diga o que está faltando."
• "Quantas respostas não lidas eu tenho? Resuma-as e rascunhe respostas."
• "Prepare uma campanha de WhatsApp com o template aprovado 'order_ready' para minha lista 'Clientes 2026'. Mostre a prévia primeiro."
• "Adicione uma auto-resposta: quando alguém escrever CATALOG, responda com este texto e envie meu PDF."
• "Quando alguém comentar PRECO no meu post, envie uma mensagem privada com nossos preços."
• "Agende estes 5 vídeos como Reels no Instagram e Facebook, um por dia às 18:00."
• "Importe o plano de conteúdo da pasta C:\planos\novembro e mostre a prévia."
• "Agende 12 posts no LinkedIn sobre cuidados dentários, dois por semana, e mostre-os para mim primeiro."