Skip to main content

Use esta skill de agente

Copie as instruções abaixo para um arquivo SKILL.md dentro de uma pasta chamada levios-create-automation e adicione pelo mecanismo de skills suportado pelo seu cliente. Se ele não carregar arquivos de skill, forneça esse conteúdo ao agente como instruções da tarefa. Isso não instala nada nem habilita ferramentas por conta própria. A skill usa inglês para manter uma única versão das instruções e orienta o agente a responder no seu idioma.

Revise a configuração, não um resumo reescrito

A ferramenta de validação retorna preview_markdown no language solicitado (pt-BR, en ou es). O agente apresenta o conteúdo completo: cada variação de resposta, mensagem, botão, URL, condição, pausa e intervalo vem da configuração válida. Ele acrescenta o perfil verificado, nome e estado pretendido separadamente. Configurações inválidas não têm prévia. Elegibilidade da conta, links funcionando e entrega real ainda exigem suas próprias verificações. Um botão com link de PDF e um PDF anexado são experiências diferentes. O agente propõe o formato explicitamente: um link abre o material; send_media com media_type=file envia um anexo hospedado após o clique na mensagem de abertura. Não há ferramenta de upload. Um pedido de mudança no texto altera apenas aquela mensagem; o agente esclarece um alvo ambíguo sem reabrir o fluxo ou objetivo acordado.

Referência e exemplos

Você pode começar com “quero criar uma automação”. O agente ajuda a escolher a interação, entender o resultado desejado e propor as mensagens.

Comece pela interação

O agente consulta get_automation_guide e explica brevemente se você pode criar e ativar por essa conexão ou salvar um rascunho. Ele não presume que você quer um rascunho. Essa consulta não confirma a elegibilidade da conta nem do plano. Para um pedido vago, ele pergunta uma decisão: “Qual interação deve iniciar sua automação?”. As opções incluem comentário em post, carrossel ou Reels; resposta ou reação a story; menção em story; palavra-chave em uma DM recebida; ou ajuda para escolher. Se o seletor tiver menos espaços, o agente agrupa Comentários, Stories e DMs e depois pergunta sobre a família escolhida. Ajuda e texto livre continuam disponíveis. Se você já disse “enviar um ebook para quem comentar”, a interação de comentário está definida. O agente pula essa pergunta. Resolve o perfil se necessário e, depois, a ação inicial e o próximo passo desejado. Uma decisão por turno não significa repetir um questionário: uma resposta completa pode resolver várias etapas.

Use a interface de perguntas disponível

Para perguntas com escolhas, consulte as ferramentas realmente expostas pelo cliente. No Codex, prefira request_user_input_async quando disponível e utilizável. Use request_user_input somente quando sua descrição e o modo atual permitirem aquela pergunta. Outros clientes podem ter uma ferramenta equivalente com outro nome. Uma skill de brainstorming recomenda múltipla escolha; ela não abre o seletor. Esses nomes são exemplos, não uma promessa de disponibilidade. Quando uma ferramenta nativa de perguntas está exposta e utilizável no modo atual, o agente realmente a chama. Preserva Outro ou texto livre sem duplicar esse campo. Uma opção preselecionada ou uma pergunta enviada não é sua resposta. Se a ferramenta estiver indisponível, restrita, falhar ou não aparecer para você, o agente faz a mesma pergunta curta no chat. Ele não deve apontar para perguntas que nunca foram apresentadas. O MCP não observa nem força essa interface local, e uma resposta de planejamento não é confirmação de ativação. Nas perguntas assíncronas, o agente mantém uma pergunta pendente e usa a espera interrompível do cliente ou uma transferência documentada que preserve a pergunta. Ele não encerra a resposta, repete a pergunta nem escolhe por você antes da sua resposta. O tempo decorrido não é uma resposta. Se o seletor fechar ou não estiver disponível, o agente coleta a mesma escolha no chat sem reiniciar o briefing.

Defina o resultado antes de escrever as mensagens

Resolva primeiro a entrega e depois pergunte o próximo objetivo, se faltar. Não misture formatos como PDF/link com venda, agendamento ou crescimento em um único menu. Uma decisão por vez não significa um campo por vez: peça os links do material e do curso juntos quando ambos forem necessários. Para material seguido de curso, descubra o recorte do tema, o benefício, o público do curso e a relação entre eles. Um tema amplo ou uma URL não bastam para escrever uma boa transição. Explique para que precisa de cada dado sem prometer que a sequência está pronta enquanto faltam escolhas. Confirme uma URL ambígua em vez de alterá-la. “Entregar um PDF” identifica uma ação inicial. “Entregar um PDF e depois oferecer meu curso” também define a próxima etapa. Se só a entrega estiver clara, o agente pergunta o que a pessoa deve fazer depois. Adapta as opções ao contexto: conhecer um produto, agendar uma conversa, responder uma pergunta de qualificação ou apenas receber o material. Crescimento e coleta de contato entram quando servem ao objetivo. Nenhum material é presumido se você não mencionou um. O agente descobre apenas o contexto do material e da oferta necessário para propor bons textos. Você não precisa escrever cada mensagem. Respostas conhecidas são aproveitadas; se o objetivo mudar, só as escolhas afetadas são revistas antes da execução. O briefing segue interação → perfil → resultado desejado e depois os passos do canvas Gatilho → Mensagem de abertura → Continuidade → Extras, seguidos de prévia e execução. São etapas de raciocínio, não perguntas obrigatórias para cada configuração. Os schemas públicos do MCP definem quais recursos do builder podem ser executados.

Considere primeiro a mensagem de abertura

Para uma campanha de entrega de material, o agente propõe primeiro uma mensagem de abertura com um botão para solicitar o conteúdo. Quando a pessoa usa o botão start_follow_up em uma interação elegível, ela inicia a sequência e abre ou renova a janela padrão de 24 horas para mensagens. Apenas enviar a mensagem de abertura não abre essa janela. Leia os limites do Instagram. Isso permite entregar o material e continuar com informações relevantes sobre um produto, uma pergunta de qualificação ou um link real de agendamento enquanto houver elegibilidade. O clique acrescenta uma etapa, então o agente explica a troca e respeita sua escolha. Ele não deve adicionar a abertura ou uma condição silenciosamente. Um botão url direto, com follow_up definido como null, é a alternativa quando você quer apenas entregar com menos etapas. Clicar nesse link não inicia a sequência nem abre uma nova janela de mensagens. A pessoa ainda pode enviar uma mensagem por iniciativa própria depois; isso é outra interação elegível.

Decida o que acontece depois da entrega

A próxima etapa desejada vem do briefing. O agente a usa para propor o que acontece depois do clique na abertura e da entrega. Se ainda faltar essa informação, resolve essa decisão antes de propor a sequência. Não pergunta novamente quando seu objetivo já está claro. Ele propõe uma sequência curta, com uma função por mensagem: entregar o material, trazer um ponto útil e indicar um próximo passo relevante. Revise cada mensagem e pausa em Escolha um objetivo. Uma mensagem com atraso não espera a resposta da pessoa. O agente explica onde é necessário atendimento humano, uma condição de captura disponível ou uma página externa. Para crescer, ele pode sugerir um follow gate. Para captar contatos, pode sugerir email ou telefone. Essas condições vêm antes da entrega, e a sequência pública atual não combina seguir com captura de email ou telefone.

Sugira responder os comentários e configurações relevantes

Na etapa de abertura, recomende Responder os comentários e mostre cinco variações curtas. Ofereça Usar essas variações, Ajustar ou Não responder no seletor nativo quando utilizável. Preserve texto livre. Resolva essa escolha antes de avançar para a continuidade, salvo quando a resposta já estiver clara. Escreva as sugestões sem pedir permissão só para redigi-las; não habilite as respostas silenciosamente.
  • “Chegou no seu direct? 📩”
  • “Recebeu a DM aí? 🙂”
  • “A mensagem chegou pra você?”
  • “Me confirma aqui se chegou no direct?”
  • “Viu minha mensagem na DM? 😊”
Mantenha essa simplicidade: só perguntar se a DM chegou, com alguns emojis. Não mencione botões, pastas, solicitar material ou continuar conversa. A pergunta não afirma entrega; evite “enviei” antes de haver confirmação de envio. Respostas aos comentários podem aparecer mesmo se a DM atrasar ou falhar. Convidar a responder é uma hipótese de conversa para testar, não uma garantia de alcance. Responder ao comentário não inicia a continuidade na DM nem abre sua janela. Você pode pedir outra quantidade. Mostre cada texto na prévia final, não apenas “uma de cinco variações”. Só uma é enviada por comentário elegível. sequential percorre a lista; random pode repetir. Explique e revise mention_mode, delay_seconds e max_per_post. O limite vale para respostas por post, não para DMs. Os outros tipos de gatilho suportados não aceitam essa ação. Explique o público e a política de repetição para a campanha. Sete dias, três minutos até a oferta e 100 respostas não são padrões. Para intervalo fixo, use Não ativar a automação para a mesma pessoa dentro de [tempo], preenchendo a duração escolhida. Para none, use Sem intervalo adicional entre ativações para a mesma pessoa. Outras proteções continuam; isso não significa envios ilimitados. A frase trata da repetição do gatilho, não de mudar o status da automação.

Confirme a publicação desejada

Antes de buscar posts existentes, pergunte se o post já foi publicado ou se será uma publicação futura, salvo quando isso já estiver claro. Não busque posts existentes para uma próxima publicação já confirmada. “Hoje” ou “daqui a pouco” não significa necessariamente o próximo post. Antes de usar next_published, confirme que nenhuma publicação virá antes. Ative antes de publicar o post desejado. Esse modo não agenda nem publica conteúdo. Se outro post vier primeiro, prepare as mensagens e vincule o post certo após a publicação. O agente pode sugerir a palavra-chave, mas precisa dos links de destino reais. Um plano incompleto fica no chat; até um rascunho precisa de configuração completa.

Revise a automação como no canvas

Use Quando… → Então eu vou… → Quando a pessoa clicar… → E também…. Monte frases curtas e numeradas com os valores escolhidos em negrito. Mostre os textos literais, nomes dos botões e URLs completas. Este exemplo fictício ilustra o formato; textos, conta, pausas, limites e estado final são escolhas para revisão, não padrões nem instruções para criar uma automação. O exemplo supõe uma conexão que permite ativar pelo MCP. Quando…
  1. Qualquer pessoa fizer um comentário…
  2. contendo GUIDE como palavra isolada, inclusive dentro de uma frase…
  3. no próximo post que eu publicar após a ativação…
  4. no perfil @yourprofile.
Então eu vou…
  1. Responder os comentários com uma destas cinco variações: “Chegou no seu direct? 📩”; “Recebeu a DM aí? 🙂”; “A mensagem chegou pra você?”; “Me confirma aqui se chegou no direct?”; “Viu minha mensagem na DM? 😊”.
  2. Mandar uma DM contendo:
    Quer receber o guia de fotografia? Toque abaixo para solicitar.
    Com o botão Quero o guia.
Quando a pessoa clicar em “Quero o guia”…
  1. Enviar imediatamente uma mensagem:
    Aqui está seu guia de fotografia. Boa leitura! 📘
    Botão Baixar guia → https://example.com/guide.
  2. Esperar 5 segundos e enviar:
    No curso, você pratica os exercícios de iluminação apresentados no guia.
    Botão Conhecer o curso → https://example.com/course.
  3. Finalizar a sequência.
E também…
  • Não ativar a automação para a mesma pessoa dentro de 24 horas.
  • Responder a até 50 comentários por post, alternando as variações em ordem, sem menções nem atraso configurado na abertura.
  • Sem clique em Quero o guia, a continuidade não começa.
  • Estado final: ativa, após a confirmação compatível pelo MCP, aguardando o próximo post.
Na prévia real, use apenas fatos confirmados sobre material/oferta e os valores reais. Substitua todos os campos em aberto. Inclua cada mensagem e mídia, pedidos e tentativas das condições, pausas relativas, tags, público, limites e estado final da configuração validada. Explique o motivo das sugestões antes da aprovação. Não esconda textos atrás de “mensagem conectando o guia ao curso”. Uma pausa não prova que alguém leu o material. A numeração da abertura não garante a ordem entre a resposta ao comentário e a DM nem confirma entrega. Adapte o resumo ao gatilho. Na entrega direta, mostre a URL na abertura e omita a seção de continuidade por clique. Para condições, preserve sua ordem antes da entrega e explique expiração, tentativas e ausência de resposta. Se as respostas forem recusadas, mostre que os comentários não serão respondidos. Mantenha visíveis o estado ativo/rascunho escolhido e o caminho real de ativação. Antes de salvar, confira se a escolha de responder, textos literais, URLs, pausas, condições, extras e estado final estão resolvidos. Pergunte só o que faltar. Compare toda a prévia com a configuração validada e leia novamente após gravar. Um teste real do harness precisa observar a chamada nativa, o seletor visível e a escolha enviada; retorno bem-sucedido não comprova renderização.

Revise, salve e conclua

Revise perfil, publicação, público, regra de correspondência, cada mensagem e botão, todas as variações de resposta ao comentário, condições, pausas relativas, política de repetição e estado final. Veja também o que acontece se a pessoa não clicar nem responder. Com whole_word e a palavra-chave EBOOK, tanto EBOOK quanto “quero EBOOK” correspondem; EBOOKS não. O comentário inteiro não precisa ser igual à palavra-chave. O agente usa get_automation_schema para campos pouco claros e validate_automation_configuration com configuration_json antes de gravar. Nas revisões, previous_configuration_json permite comparar duas versões válidas. Uma versão anterior inválida significa que não houve comparação. O agente corrige erros sem remover respostas, condições ou cooldowns combinados e mostra as mudanças de comportamento. A validação não testa a elegibilidade da conta, o acesso ao link ou a entrega. Escolha o estado final depois de revisar o plano. Se você já pediu para ativar, o agente mantém essa escolha sem perguntar novamente.
  • Criar e ativar: create_automation com status: "live" cria a automação ativa pelo MCP quando a conexão tem permissões de escrita e ativação e suporta a confirmação exigida. Conclua essa confirmação para o plano revisado. Você não precisa salvar um rascunho antes.
  • Salvar rascunho: create_automation com status: "draft" salva sem processar gatilhos. Escolha isso quando quiser ativar depois. Um rascunho existente pode ser ativado com activate_automation pelo fluxo de confirmação compatível.
Se a conexão não puder ativar, o agente explica o motivo específico. activation_route=permission_required indica falta de permissão de ativação. activation_route=dashboard indica que a conexão não consegue concluir a confirmação exigida pelo MCP, mesmo que tenha permissão de ativação. Perguntas de planejamento ou um sim no chat não substituem essa confirmação. O agente oferece o caminho pelo painel e só salva um rascunho se você aceitar essa alternativa. Ele usa o ID retornado da automação salva no link direto. Não transforma silenciosamente um pedido de ativação em rascunho nem descreve todo o MCP como restrito a rascunhos. Para next_published, conclua a ativação antes de publicar o post desejado. Depois de gravar, o agente lê a automação novamente. get_automation retorna updated_at para usar como expected_updated_at nas edições. has_unpublished_changes indica que ainda é preciso publicar as mudanças. Rascunho salvo, automação ativa e mensagem entregue são resultados diferentes. Confira o estado antes de repetir uma criação com resposta incerta. Consulte tools/list para encontrar o guia e as ferramentas de planejamento. Use start, opening, conversation, public_replies, triggers e review conforme necessário. Se uma ferramenta ou tópico não estiver na versão conectada, use esta página e os schemas disponíveis. O guia ajuda o agente a escolher; não obriga um agente externo a seguir todas as recomendações.