> ## Documentation Index > Fetch the complete documentation index at: https://docs.levios.app/llms.txt > Use this file to discover all available pages before exploring further. # Escolha um objetivo para a automação > Relacione entrega, vendas, crescimento de público e captação de leads aos recursos da levios. ## Use esta skill de agente Copie as instruções abaixo para um arquivo `SKILL.md` dentro de uma pasta chamada `levios-plan-conversation` 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. ```markdown theme={null} --- name: levios-plan-conversation description: Plan levios Instagram messages around a business outcome, such as delivering a PDF then presenting a course, sending a video then inviting a booking, or qualifying a contact. Use when choosing opening messages, delivery, continuation, relevant gates, pacing or campaign measurements. --- # Plan the conversation Answer in the user's language. Read `get_automation_guide` topic `conversation` and the actual connection report. Use the known interaction, account and goal; do not restart an intake or assume every request includes a resource. If needed, ask one missing decision using the native question lifecycle in topic `start`. ## Turn the outcome into messages 1. Establish what is delivered and what the owner wants afterward. Learn the specific topic/benefit and how the real offer helps that audience. Ask for related resource/offer URLs together; never infer claims from their domains. 2. For resource plus continuation, recommend an opening `start_follow_up` button. Its eligible interaction starts the continuation and opens/refreshes the 24-hour window. The initial private reply or a URL click alone does neither. Respect explicit direct-only delivery instead of adding steps silently. 3. State the delivery format: a URL button opens a link; `send_media` with `media_type=file` sends a hosted attachment after the opening click. Require the real hosted URL. This MCP does not upload local files. 4. Propose a short sequence: prompt delivery, a truthful bridge, then one useful next step. Usually two to four messages are enough when a sequence helps. Do not split every sentence into a notification or write one long pitch. Do not say the material "helped" or imply it was read seconds after delivery. Connect its topic to a verified course benefit instead. Invent no prices, urgency, testimonials, outcomes or claims. 5. Explain editable relative pauses based on message length and campaign intent. A pause is not a typing indicator, proof of reading or waiting for a reply. Avoid long artificial waits and do not schedule at the 24-hour boundary. 6. For comments, resolve replies during opening: show five short DM-arrival questions and offer use/adjust/decline. Read topic `public_replies` for exact fields. Explain cap, rotation and mentions; show every approved variation. ## Choose only relevant capabilities - **Product:** deliver, connect the topic to the real offer, then link to it. A click is not a purchase. - **Booking:** explain why a conversation helps and link to the owner's actual booking page. No calendar availability or appointment creation is exposed. - **Qualification:** ask one relevant question and finish for a human to review. `send_message` does not wait, capture structured answers or branch on them. - **Capture:** read topic `capture`. Email/phone gates wait for supported inputs before delivery; they do not send email, start WhatsApp or verify ownership. - **Growth:** read topic `follow_gate`. Discuss the extra effort; use it for a fitting growth objective, not as a mandatory step for every delivery. - **Tagging:** use real account-scoped tag IDs after delivery. A tag is not a send campaign, new trigger or arbitrary branch. Follow and capture gates cannot be mixed in the same public sequence. ## Review the actual flow Use `get_automation_schema` where needed, then `validate_automation_configuration` with the complete configuration and user language. Show its full `preview_markdown`, exact copy, URLs, relative pauses, gate/no-click outcomes and repeat policy. Add verified account and intended state separately. Justify settings instead of defaulting to six hours, seven days or a fixed sales delay. Preserve the plan when editing copy and compare the previous configuration when revising. Follow topic `review` for authorized execution. Choose one primary outcome and one cost measure supported by actual metric tools. Label missing click/purchase attribution and suggest an external source when needed. Compare equivalent cohorts; do not promise a conversion lift. [Detailed paths and valid configuration examples](https://docs.levios.app/mcp/choose-objective). ``` ## Referência e exemplos Uma mensagem enviada segundos após a entrega não deve presumir que a pessoa já leu, concluiu ou teve resultado com o material. Conecte o tema a um benefício confirmado da oferta. Uma pausa não comprova leitura. Primeiro defina o que deve acontecer quando a pessoa interagir e, depois, a próxima etapa desejada. Pode não haver material para entregar. “Enviar um ebook” identifica a entrega; “enviar um ebook e depois oferecer meu curso” também define a continuação. Recomendações são hipóteses para testar, não promessas de maior conversão. | Seu objetivo | Caminho sugerido | Custo a considerar | | - | - | - | | Iniciar uma conversa útil | Botão de abertura, material e uma pergunta de qualificação | Alguém precisa ler e responder; uma pergunta programada não cria ramificações | | Apresentar um produto ou convidar para agendamento | Botão de abertura, material, contexto relevante e link real | Relacione a oferta ao material e mantenha o convite curto | | Crescer com seguidores relevantes | Botão de abertura, follow gate combinado e material valioso | Algumas pessoas podem sair antes de receber | | Captar leads | Botão de abertura, condição de email ou telefone e entrega | Peça apenas informações úteis para a próxima etapa | | Apenas entregar com menos etapas | URL direta na mensagem de abertura | O clique na URL não inicia uma sequência nem abre uma janela de mensagens | | Encontrar possíveis parceiros | Análise de contatos existentes e dados de perfil | Alcance não comprova afinidade nem intenção de compra | ## Recomende primeiro uma mensagem de abertura Para uma campanha de comentário que entrega material, proponha primeiro uma mensagem de abertura com botão `start_follow_up`. Explique a função: a interação elegível da pessoa inicia a sequência e abre ou renova a janela padrão de 24 horas. Só enviar a abertura não abre essa janela. Isso permite uma próxima etapa relevante depois da entrega, ao custo de um clique adicional. Ofereça entrega direta quando o objetivo for apenas receber o material com menos atrito. Clicar na URL não inicia essa sequência da levios nem abre uma janela. A pessoa ainda pode enviar uma mensagem por conta própria depois. Respeite uma preferência explícita por entrega direta sem insistir em mais etapas. Defina a próxima etapa antes de propor a abertura e a continuação, salvo quando ela já estiver clara. Pergunte uma decisão em aberto usando a ferramenta nativa do harness quando utilizável no modo atual, com opções contextuais e texto livre. Se a ferramenta estiver indisponível ou falhar, pergunte no chat. Descubra apenas o contexto do material ou da oferta necessário para propor os textos. Para crescimento, sugira um follow gate combinado quando o material for valioso e relacionado ao conteúdo da conta. Para intenção de compra, considere se uma condição extra atrapalharia o comprador. Apresente o motivo e a contrapartida antes de incluir um recurso. Veja [a conversa guiada](/pt-BR/mcp/first-automation). ## Construa uma conversa curta em torno da próxima etapa Proponha de duas a quatro mensagens separadas quando fizer sentido, cada uma com uma função: cumprir a promessa, acrescentar contexto útil e convidar para a próxima ação. Adapte ao material real, evitando discurso genérico de venda ou muitas mensagens minúsculas. | Próxima etapa desejada | Sequência proposta depois da entrega | Limite de execução | | - | - | - | | Qualificação | Uma dica útil e uma pergunta relevante | Encerre a sequência programada na pergunta; uma pessoa pode acompanhar a resposta no Instagram | | Produto | Uma relação verdadeira entre o material e o produto real, seguida da URL | Não invente preços, urgência, resultados ou depoimentos; clique não é compra | | Agendamento | Explique o propósito da conversa e ofereça a URL real de agendamento | O contrato público não consulta disponibilidade, cria ou confirma agendamentos | | Captação depois da entrega | Ofereça uma URL real de formulário externo ou converse sobre mover a condição de coleta para antes da entrega | Nunca altere a ordem combinada silenciosamente | Por exemplo, entregue logo, pause cinco segundos antes de uma frase útil e mais oito antes de uma pergunta. Ajuste as pausas à quantidade de texto e apresente para aprovação. São estimativas ilustrativas de leitura ou tempo de digitação, não um indicador de digitação, espera por resposta, prova de leitura ou presença humana. Os atrasos são relativos e cumulativos; filas podem acrescentar tempo. Valide a sequência dentro da janela restante. Envios não renovam a janela. `send_message` não espera respostas livres nem adapta mensagens posteriores a elas. Não programe uma oferta que depende da resposta logo depois da pergunta. Só condições suportadas esperam a entrada específica. Sem clique na abertura, essa sequência não começa; não prometa lembretes automáticos para quem não clicou. ## Recomende responder os comentários Na etapa de abertura, recomende **Responder os comentários** e escreva cinco perguntas curtas apenas sobre a chegada da DM, com alguns emojis. Mostre todos os textos e ofereça usar, ajustar ou não responder pelo seletor nativo utilizável. Respeite uma escolha existente e permita outra quantidade. Resolva a escolha antes da continuidade. Não mencione botões, pastas ou continuar conversa nessas respostas, nem afirme sucesso de envio antes de sabê-lo. [Veja cinco exemplos de respostas](/pt-BR/mcp/first-automation). Mostre todas as variações, rotação, menção, atraso e limite por post na prévia como no canvas. Só uma variação é escolhida por comentário elegível, não as cinco. A resposta ao comentário pode aparecer se a DM falhar e não abre a janela privada. Benefício de alcance é uma hipótese, não uma garantia. ## Apresente ações e filtros relevantes Use `send_message` para texto e botões de URL, ou `send_media` para imagem, vídeo, áudio ou arquivo com hospedagem real. `ask_to_follow`, `ask_for_email` e `ask_for_phone` são condições anteriores à entrega. `add_contact_tag` organiza um contato depois da entrega com o ID de uma tag existente; `finish` encerra a sequência. Explique as opções úteis para o objetivo, sem pedir que o usuário escolha entre todos os campos do schema. | Filtro de público | Quem inclui | O que explicar | | - | - | - | | `anyone` | Todo contato que atenda aos demais critérios | Uma proposta inicial útil para aquisição | | `followers_only` | Seguidores confirmados | Exclui os não seguidores que um follow gate poderia ajudar a converter | | `non_followers_only` | Não seguidores confirmados | Exclui os seguidores atuais da entrega do material | | `previous_dm_contacts` | Contatos que enviaram uma DM à sua conta antes deste gatilho | O histórico não comprova uma janela atualmente aberta | | `existing_contacts` | Contatos já conhecidos antes deste gatilho | Contato salvo não é uma nova permissão de envio | Limites por número de seguidores e condições arbitrárias de tags não são filtros de gatilho. Para pessoas acima de 10 mil seguidores, use a [análise de contatos estratégicos](/pt-BR/mcp/strategic-contacts). Para comentários, converse sobre um post específico, a próxima publicação ou todos os posts elegíveis. Confirme que nenhuma outra publicação virá antes ao usar `next_published`, mesmo se o usuário disser “hoje” ou “daqui a pouco”. Escolha palavras específicas ou qualquer comentário; explique `whole_word` e o alcance maior de `substring`. Nunca amplie o gatilho silenciosamente. Para `story_reply`, escolha texto com palavras-chave ou reação com as reações desejadas, e qualquer story ou stories específicos. `dm_keyword` identifica palavras específicas em DMs recebidas; `story_mention` é uma menção na superfície de mensagens, não dentro de um comentário de post. Respostas aos comentários só se aplicam a `comment`. Não ofereça gatilhos legados como opções de nova criação. Combine uma política de repetição para esta campanha. Seis horas não é uma recomendação universal. `none` remove o cooldown configurado, mas preserva deduplicação, outras proteções e limites da plataforma. Nenhum atraso, rotação ou cooldown garante proteção contra medidas de combate a spam. ## Colete email ou telefone Use `ask_for_email` ou `ask_for_phone` quando a informação atender ao objetivo informado. Explique como você a usará. Essas ações verificam o formato enviado; não confirmam a titularidade nem enviam mensagens por email ou WhatsApp. Em `follow_up`, a coleta vem antes da entrega. Cada campo pode aparecer uma vez. O contrato público atual não combina captação de leads com `ask_to_follow` na mesma sequência. Escolha a prioridade em vez de prometer as duas condições. Defina uma mensagem útil para nova tentativa, um limite de tentativas e o que acontece em caso de falha. `stop` encerra a condição sem entregar o material ao esgotar as tentativas. `continue` permite a entrega sem coleta bem-sucedida. A expiração não estende a janela de mensagens do Instagram. Uma ação `add_contact_tag` precisa do ID de uma tag existente e vem depois de uma ação de entrega. Uma tag organiza o contato; sozinha, não confirma compra nem cria um novo gatilho de automação. ## Meça o resultado que você quer Escolha uma medida de sucesso e uma de atrito antes de comparar versões. Por exemplo, compare entregas concluídas do material com pessoas que iniciaram o fluxo. Para vendas, use dados do checkout; um clique no link não é uma compra. Use `get_metrics` e `get_automation_metrics` apenas para os campos que seus schemas retornam. Eles não expõem um funil completo de campanha nem atribuição de compras. Se faltarem o denominador, a conclusão da condição ou um follow atribuído, marque como não medido. Compare períodos e públicos semelhantes e não trate uma amostra pequena ou variável como prova de causalidade. ## Receitas iniciais Os exemplos abaixo são configurações completas, não padrões do servidor nem instruções para executar na sua conta. Substitua palavra-chave, texto, publicação e URL pelos valores combinados. O intervalo de seis horas é ilustrativo. Permissões, plano e mídia da conta ainda precisam de validação. ### Abertura, entrega e uma pergunta de qualificação Este exemplo propõe cinco variações de resposta ao comentário e três mensagens curtas após o clique. A sequência termina na pergunta para uma pessoa acompanhar a resposta. Pausas de cinco e oito segundos, limite de respostas de 50, rotação sequencial, sem menções e sem cooldown configurado são escolhas ilustrativas para discutir, não padrões de campanha. Confirme que o post desejado é a próxima publicação após a ativação. Sem clique na abertura, a sequência não começa. ```json theme={null} { "contact_filter": "anyone", "trigger": { "type": "comment", "publication": { "mode": "next_published" }, "keywords": { "mode": "specific", "match_mode": "whole_word", "values": [ "GUIDE" ] } }, "opening": { "public_reply": { "enabled": true, "delay_seconds": 0, "messages": [ "Did the DM arrive? 📩", "Did you get my DM? 🙂", "Did the message reach you?", "Can you confirm the DM arrived?", "Have you seen my DM? 😊" ], "rotation": "sequential", "mention_mode": "none", "max_per_post": 50 }, "direct_message": { "delay_seconds": 0, "message": { "text": "Tap below to request your guide.", "buttons": [ { "type": "start_follow_up", "title": "Get guide" } ] } } }, "follow_up": { "actions": [ { "type": "send_message", "delay_seconds": 0, "text": "Here is your requested guide.", "buttons": [ { "type": "url", "title": "Open guide", "url": "https://example.com/guide" } ] }, { "type": "send_message", "delay_seconds": 5, "text": "Choose one idea from the guide to try first.", "buttons": [] }, { "type": "send_message", "delay_seconds": 8, "text": "What would you like help putting into practice?", "buttons": [] }, { "type": "finish" } ] }, "extras": { "cooldown": { "mode": "none" } } } ``` ### Entrega direta ```json theme={null} { "contact_filter": "anyone", "trigger": { "type": "comment", "publication": { "mode": "next_published" }, "keywords": { "mode": "specific", "match_mode": "whole_word", "values": [ "GUIDE" ] } }, "opening": { "public_reply": { "enabled": false }, "direct_message": { "delay_seconds": 0, "message": { "text": "Here is your requested guide.", "buttons": [ { "type": "url", "title": "Open guide", "url": "https://example.com/guide" } ] } } }, "follow_up": null, "extras": { "cooldown": { "mode": "fixed", "seconds": 21600 } } } ``` ### Colete email e depois entregue no Instagram ```json theme={null} { "contact_filter": "anyone", "trigger": { "type": "comment", "publication": { "mode": "next_published" }, "keywords": { "mode": "specific", "match_mode": "whole_word", "values": [ "GUIDE" ] } }, "opening": { "public_reply": { "enabled": false }, "direct_message": { "delay_seconds": 0, "message": { "text": "Tap below to request your guide.", "buttons": [ { "type": "start_follow_up", "title": "Get guide" } ] } } }, "follow_up": { "actions": [ { "type": "ask_for_email", "delay_seconds": 0, "message": "Which email address would you like to share before receiving the guide here?", "retry_message": "Send a valid email address, such as name@example.com.", "max_attempts": 3, "retry_exhausted_action": "stop", "expires_in_seconds": 86400 }, { "type": "send_message", "delay_seconds": 0, "text": "Here is your requested guide.", "buttons": [ { "type": "url", "title": "Open guide", "url": "https://example.com/guide" } ] }, { "type": "finish" } ] }, "extras": { "cooldown": { "mode": "fixed", "seconds": 21600 } } } ``` Peça a um agente com `get_automation_guide` para consultar `objectives`, `opening`, `conversation`, `public_replies`, `triggers` ou `capture`. Continue em [Follow gate](/pt-BR/mcp/follow-gate), [Contatos estratégicos](/pt-BR/mcp/strategic-contacts) ou [Limites do Instagram](/pt-BR/mcp/instagram-limits). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.