> ## 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.

# Criar um carrossel com um agente

> Planeje cards com imagens e uma chamada posterior, valide a configuração completa e crie a automação pelo MCP.

Peça ao agente conectado para enviar uma coleção de cards com imagens no
Direct do Instagram. Informe os títulos, URLs das imagens, textos dos botões,
destinos e a ordem desejada. Mencione qualquer mensagem que queira após os cards.

Por exemplo: “Quando alguém comentar CATALOG, pergunte se quer ver minha
coleção. Após o clique, envie os cards dos produtos e, cinco segundos depois,
um convite para meu grupo. Me ajude a revisar as mensagens antes de ativar.”
Forneça suas imagens e links reais antes de salvar. O agente pode propor textos,
mas não deve inventar informações dos produtos ou destinos.

## Use esta skill de agente

Copie as instruções abaixo para `SKILL.md` em uma pasta chamada
`levios-carousel` e use o mecanismo de skills compatível com seu cliente.
Você também pode fornecer o texto como instruções da tarefa. Isso não instala
um conector, concede permissões nem habilita ferramentas. A skill compartilhada
está em inglês e pede ao agente que responda no seu idioma.

<Accordion title="SKILL.md">
  ```markdown theme={null}
  ---
  name: levios-carousel
  description: Plan, validate, and create an Instagram DM carousel with image cards and URL buttons through the levios MCP.
  ---

  Answer in the user's language. Use the current tools and schemas, not inferred
  fields. Start with get_automation_guide topic start to learn the connection's
  activation route. Resolve the accessible Instagram account.

  Collect missing card titles, public image URLs, optional subtitles, button
  labels and destinations. Keep the requested card/button order. There are 1 to 10
  cards and 1 to 3 URL buttons per card. Do not invent products, prices, images or
  links. Ask only for missing choices and preserve agreed copy.

  Read get_automation_schema section follow_up. Build send_carousel with an
  explicit delay_seconds and cards inside the complete configuration. Use the
  public shape, not a raw Meta generic template. For a comment-triggered sequence,
  keep the opening start_follow_up button. Explain that the eligible click starts
  the continuation; URL buttons do not resume the flow or renew the DM window.

  If the user wants a message after the cards, add a separate send_message action
  with its own delay_seconds. Do not assume that the recipient viewed a card,
  clicked a link or joined a group before this action. Keep gates before delivery.

  Call validate_automation_configuration with configuration_json and language.
  For an edit, also supply previous_configuration_json. Show the complete returned
  preview_markdown, then add the verified account, name, desired state and actual
  activation route. Fix only invalid fields and revalidate after changes.
  Validation does not check account eligibility, image retrieval or delivery.

  Use create_automation with the configuration object and the user's authorized
  status. Live creation still requires the connection's supported confirmation
  flow. If that route is unavailable, explain it and offer a draft or dashboard
  route without silently changing the request. Never fabricate confirmation.
  For updates, preserve the complete configuration and use expected_updated_at
  from a fresh get_automation read. Read back after writes. Distinguish saved,
  active, unpublished changes and actual provider delivery. Do not retry an
  uncertain creation blindly. There is no media upload tool.
  ```
</Accordion>

## Revise os cards e a ação seguinte

O [guia de carrossel da API](/pt-BR/guides/carousels) contém os limites dos
campos e um exemplo de configuração completa. O MCP usa esse mesmo formato
público de ação. `get_automation_schema` com `section: "follow_up"` mostra o
schema atual quando seu cliente exibe campos aninhados como desconhecidos.

A ação aceita de 1 a 10 cards com imagens e de 1 a 3 botões de link por card.
As imagens precisam estar acessíveis publicamente. Não há ferramenta de upload
no MCP; use uma URL de imagem existente. O agente preserva a ordem dos cards,
os subtítulos opcionais e todos os botões.

Em uma continuação iniciada por comentário, o clique em `start_follow_up` na
abertura inicia a sequência e abre ou renova a janela de mensagens aplicável.
O botão de link de um card apenas abre seu destino. Uma ação `send_message`
posterior segue sua própria pausa após o envio anterior ter sucesso; ela não
aguarda o clique em um card nem a entrada no grupo. Pedidos para seguir e
outras condições devem permanecer na posição suportada antes da entrega.

## Valide antes de gravar

Chame `validate_automation_configuration` com a configuração completa
codificada em `configuration_json` e o `language` solicitado. Inclua
`previous_configuration_json` ao revisar uma configuração acordada. O agente
mostra o `preview_markdown` completo, incluindo todos os cards, textos, botões,
URLs, pausas, condições e política de repetição. Ele acrescenta separadamente
a conta, o nome da automação, o status solicitado e a rota de ativação suportada.

A validação é somente leitura e verifica estrutura e semântica. Ela não
verifica elegibilidade da conta ou do plano, busca imagens, testa links nem
envia mensagens. Configurações inválidas não têm prévia. Corrija os campos
informados e valide novamente sem remover escolhas não relacionadas.

## Salve o estado solicitado e consulte o resultado

`create_automation` recebe um objeto `configuration`, não a string JSON do
validador. Use o `status: "draft"` ou `status: "live"` autorizado. A criação
ativa exige as permissões da conexão e o fluxo de confirmação suportado. Quando
essa rota não estiver disponível, o agente explica o motivo e oferece a
alternativa disponível. Uma resposta de planejamento não substitui a
confirmação de ativação.

Para alterações, consulte `get_automation` primeiro e use seu `updated_at`
como `expected_updated_at`. Envie uma configuração completa por
`update_automation`. Consulte novamente a automação após gravar e diferencie
mudanças armazenadas, `has_unpublished_changes`, status ativo e entrega. Salvar
com sucesso não comprova que o carrossel chegou. Não repita às cegas uma criação
com resultado incerto.

Consulte [Criar sua primeira automação por chat](/pt-BR/mcp/first-automation)
para o fluxo completo de planejamento e [Limites do Instagram](/pt-BR/mcp/instagram-limits)
para janelas de envio e pausas.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.