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

# Crear un carrusel con un agente

> Planifica tarjetas con imágenes y una llamada posterior, valida la configuración completa y crea la automatización mediante MCP.

Pide a tu agente conectado que envíe una colección de tarjetas con imágenes
por DM de Instagram. Indica los títulos, URLs de imágenes, textos de botones,
destinos y el orden deseado. Menciona cualquier mensaje que quieras después de
las tarjetas.

Por ejemplo: “Cuando alguien comente CATALOG, pregunta si quiere ver mi
colección. Después del clic, envía las tarjetas de mis productos y, cinco
segundos más tarde, una invitación a mi grupo. Ayúdame a revisar los mensajes
antes de activar.” Proporciona tus imágenes y enlaces reales antes de guardar.
El agente puede proponer textos, pero no debe inventar datos de productos ni
destinos.

## Usa esta skill de agente

Copia las siguientes instrucciones en `SKILL.md` dentro de una carpeta llamada
`levios-carousel` y usa el mecanismo de skills compatible con tu cliente.
También puedes proporcionar el texto como instrucciones de la tarea. Esto no
instala un conector, concede permisos ni habilita herramientas. La skill
compartida está en inglés y pide al agente que responda en tu 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>

## Revisa las tarjetas y la siguiente acción

La [guía de carrusel de la API](/es/guides/carousels) contiene los límites de
los campos y un ejemplo de configuración completa. MCP usa ese mismo formato
público de acción. `get_automation_schema` con `section: "follow_up"` muestra
su esquema actual cuando tu cliente presenta campos anidados como desconocidos.

La acción acepta de 1 a 10 tarjetas con imágenes y de 1 a 3 botones de enlace
por tarjeta. Las imágenes deben ser accesibles públicamente. No hay una
herramienta de carga en MCP; usa una URL de imagen existente. El agente conserva
el orden de las tarjetas, los subtítulos opcionales y todos los botones.

En una continuación iniciada por comentario, el clic en `start_follow_up` de
la apertura inicia la secuencia y abre o renueva la ventana de mensajes
aplicable. El botón de enlace de una tarjeta solo abre su destino. Una acción
`send_message` posterior sigue su propia pausa después de que el envío anterior
tenga éxito; no espera a que la persona pulse una tarjeta ni entre al grupo.
Las solicitudes para seguir y otras condiciones deben conservar su posición
compatible antes de la entrega.

## Valida antes de guardar

Llama a `validate_automation_configuration` con la configuración completa
codificada en `configuration_json` y el `language` solicitado. Incluye
`previous_configuration_json` al revisar una configuración acordada. El agente
muestra el `preview_markdown` completo, con todas las tarjetas, textos, botones,
URLs, pausas, condiciones y política de repetición. Añade por separado la
cuenta, el nombre de la automatización, el estado solicitado y la ruta de
activación compatible.

La validación es de solo lectura y comprueba estructura y semántica. No verifica
la elegibilidad de la cuenta o del plan, descarga imágenes, prueba enlaces ni
envía mensajes. Las configuraciones no válidas no tienen vista previa. Corrige
los campos indicados y valida de nuevo sin eliminar decisiones no relacionadas.

## Guarda el estado solicitado y consulta el resultado

`create_automation` recibe un objeto `configuration`, no la cadena JSON del
validador. Usa el `status: "draft"` o `status: "live"` autorizado. La creación
activa requiere los permisos de la conexión y el flujo de confirmación
compatible. Cuando esa ruta no esté disponible, el agente explica el motivo y
ofrece la alternativa disponible. Una respuesta de planificación no sustituye
la confirmación de activación.

Para cambios, consulta primero `get_automation` y usa su `updated_at` como
`expected_updated_at`. Envía una configuración completa mediante
`update_automation`. Consulta de nuevo la automatización después de guardar y
distingue los cambios almacenados, `has_unpublished_changes`, el estado activo
y la entrega. Guardar correctamente no demuestra que el carrusel llegó. No
repitas a ciegas una creación con resultado incierto.

Consulta [Crear tu primera automatización por chat](/es/mcp/first-automation)
para el flujo completo de planificación y [Límites de Instagram](/es/mcp/instagram-limits)
para ventanas de envío y pausas.


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