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

# Elige un objetivo de automatización

> Relaciona entrega, ventas, crecimiento de audiencia y captación de leads con las funciones de levios.

## Usa esta skill de agente

Copia las instrucciones de abajo en un archivo `SKILL.md` dentro de una carpeta
llamada `levios-plan-conversation` y añádelo mediante el mecanismo de skills que
admita tu cliente. Si no carga archivos de skill, proporciona este contenido
al agente como instrucciones de la tarea. Esto no instala nada ni habilita
herramientas por sí solo. La skill usa inglés para mantener una sola versión
de las instrucciones y pide al agente que responda en tu idioma.

<Accordion title="SKILL.md">
  ```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).
  ```
</Accordion>

## Referencia y ejemplos

Un mensaje enviado segundos después de la entrega no debe suponer que la persona
ya leyó, completó u obtuvo resultados con el material. Conecta el tema con un
beneficio confirmado de la oferta. Una pausa no demuestra lectura.

Primero define qué debe ocurrir cuando la persona interactúe y, después, el
siguiente paso deseado. Puede que no haya material para entregar. “Enviar un
ebook” identifica la entrega; “enviar un ebook y después ofrecer mi curso”
también define la continuación. Las recomendaciones son hipótesis para probar,
no promesas de mayor conversión.

| Tu objetivo | Camino sugerido | Coste que debes considerar |
| - | - | - |
| Iniciar una conversación útil | Botón de apertura, material y una pregunta de cualificación | Alguien debe leer y responder; una pregunta programada no crea ramificaciones |
| Presentar un producto o invitar a una cita | Botón de apertura, material, contexto relevante y enlace real | Relaciona la oferta con el material y mantén breve la invitación |
| Crecer con seguidores relevantes | Botón de apertura, condición de seguimiento acordada y material valioso | Algunas personas pueden salir antes de recibirlo |
| Captar leads | Botón de apertura, condición de correo o teléfono y entrega | Pide solo información útil para el siguiente paso |
| Solo entregar con menos pasos | URL directa en el mensaje de apertura | El clic en la URL no inicia una secuencia ni abre una ventana de mensajes |
| Encontrar posibles socios | Análisis de contactos existentes y datos del perfil | El alcance no demuestra afinidad ni intención de compra |

## Recomienda primero un mensaje de apertura

Para una campaña de comentarios que entrega material, propón primero un mensaje
de apertura con botón `start_follow_up`. Explica su función: la interacción
elegible de la persona inicia la secuencia y abre o renueva la ventana estándar
de 24 horas. Enviar la apertura por sí solo no la abre. Esto permite un siguiente
paso relevante después de la entrega, a cambio de un clic adicional.

Ofrece entrega directa cuando el objetivo sea solo recibir el material con
menos fricción. Pulsar la URL no inicia esta secuencia de levios ni abre una
ventana. La persona puede enviar un mensaje por iniciativa propia después.
Respeta una preferencia explícita por entrega directa sin insistir en más pasos.

Define el siguiente paso antes de proponer la apertura y la continuación, salvo
cuando ya esté claro. Pregunta una decisión pendiente con la herramienta nativa
del harness cuando se pueda usar en el modo actual, con opciones contextuales y
texto libre. Si la herramienta no está disponible o falla, pregunta en el chat.
Averigua solo el contexto del material o de la oferta necesario para proponer
los textos.

Para crecer, sugiere una condición de seguimiento acordada cuando el material
sea valioso y esté relacionado con el contenido de la cuenta. Ante intención
de compra, considera si una condición extra interrumpiría al comprador. Explica
el motivo y el coste antes de incluir una función. Consulta
[la conversación guiada](/es/mcp/first-automation).

## Construye una conversación breve alrededor del siguiente paso

Propón de dos a cuatro mensajes separados cuando resulte útil, cada uno con
una función: cumplir la promesa, aportar contexto útil e invitar a la siguiente
acción. Adapta al material real, evitando un discurso genérico de venta o muchos
fragmentos diminutos.

| Siguiente paso deseado | Secuencia propuesta después de la entrega | Límite de ejecución |
| - | - | - |
| Cualificación | Un consejo útil y una pregunta relevante | Termina la secuencia programada en la pregunta; una persona puede revisar la respuesta en Instagram |
| Producto | Una relación verdadera entre el material y el producto real, seguida de su URL | No inventes precios, urgencia, resultados ni testimonios; un clic no es una compra |
| Cita | Explica el propósito de la conversación y ofrece la URL real para reservar | El contrato público no consulta disponibilidad, crea ni confirma citas |
| Captación después de la entrega | Ofrece una URL real de formulario externo o habla sobre mover la condición de recopilación antes de la entrega | Nunca cambies el orden acordado en silencio |

Por ejemplo, entrega pronto, pausa cinco segundos antes de una frase útil y
ocho más antes de una pregunta. Ajusta las pausas a la cantidad de texto y
preséntalas para aprobación. Son estimaciones ilustrativas de lectura o tiempo
de escritura, no un indicador de escritura, espera de respuesta, prueba de
lectura o presencia humana. Los retrasos son relativos y acumulativos; las
colas pueden añadir tiempo. Valida la secuencia dentro de la ventana restante.
Los envíos no renuevan la ventana.

`send_message` no espera respuestas libres ni adapta mensajes posteriores a
ellas. No programes una oferta que dependa de la respuesta después de la
pregunta. Solo las condiciones admitidas esperan su entrada específica. Sin
clic en la apertura, esta secuencia no empieza; no prometas recordatorios
automáticos para quien no haya pulsado.

## Recomienda responder los comentarios

En la etapa de apertura, recomienda **Responder los comentarios** y redacta cinco
preguntas breves solo sobre la llegada del DM, con algunos emojis. Muestra todos
los textos y ofrece usar, ajustar o no responder mediante un selector nativo
utilizable. Respeta una elección existente y permite otra cantidad. Resuelve la
opción antes de continuar. No menciones botones, carpetas ni continuar una
conversación, ni afirmes éxito del envío antes de conocerlo.
[Consulta cinco ejemplos de respuestas](/es/mcp/first-automation).

Muestra todas las variaciones, rotación, mención, retraso y límite por post en la
vista previa como en el canvas. Se elige una por comentario elegible, no las cinco.
Una respuesta al comentario puede aparecer si el DM falla y no abre la ventana
privada. Un beneficio de alcance es una hipótesis, no una garantía.

## Presenta acciones y filtros relevantes

Usa `send_message` para texto y botones de URL, o `send_media` para imagen, vídeo,
audio o archivo con alojamiento real. `ask_to_follow`, `ask_for_email` y
`ask_for_phone` son condiciones anteriores a la entrega. `add_contact_tag`
organiza un contacto después de la entrega con el ID de una etiqueta existente;
`finish` termina la secuencia. Explica las opciones útiles para el objetivo sin
pedir al usuario que elija entre todos los campos del schema.

| Filtro de audiencia | A quién incluye | Qué explicar |
| - | - | - |
| `anyone` | Todo contacto que cumpla los demás criterios | Una propuesta inicial útil para adquisición |
| `followers_only` | Seguidores confirmados | Excluye a los no seguidores que una condición de seguimiento podría ayudar a convertir |
| `non_followers_only` | No seguidores confirmados | Excluye a los seguidores actuales de la entrega del material |
| `previous_dm_contacts` | Contactos que enviaron un DM a tu cuenta antes de este disparador | El historial no demuestra una ventana actualmente abierta |
| `existing_contacts` | Contactos ya conocidos antes de este disparador | Un contacto guardado no es un nuevo permiso de envío |

Los umbrales de seguidores y las condiciones arbitrarias de etiquetas no son
filtros de disparador. Para personas con más de 10 mil seguidores, usa el
[análisis de contactos estratégicos](/es/mcp/strategic-contacts).

Para comentarios, habla sobre una publicación específica, la siguiente o todas
las publicaciones elegibles. Confirma que ninguna otra se publicará antes al
usar `next_published`, aunque el usuario diga “hoy” o “dentro de poco”. Elige
palabras específicas o cualquier comentario; explica `whole_word` y el alcance
más amplio de `substring`. Nunca amplíes el disparador en silencio.

Para `story_reply`, elige texto con palabras clave o reacción con las reacciones
deseadas, y cualquier historia o historias específicas. `dm_keyword` identifica
palabras específicas en DMs entrantes; `story_mention` es una mención en la
superficie de mensajes, no dentro de un comentario de publicación. Las respuestas
públicas solo se aplican a `comment`. No ofrezcas disparadores heredados como
opciones para nuevas automatizaciones.

Acuerda una política de repetición para esta campaña. Seis horas no es una
recomendación universal. `none` elimina el cooldown configurado, pero conserva
la deduplicación, otras protecciones y los límites de la plataforma. Ningún
retraso, rotación o cooldown garantiza protección frente a medidas contra el spam.

## Recopila correo o teléfono

Usa `ask_for_email` o `ask_for_phone` cuando esa información cumpla tu propósito.
Explica cómo la usarás. Estas acciones comprueban el formato enviado; no verifican
la titularidad ni envían mensajes por correo o WhatsApp.

En `follow_up`, la recopilación precede a la entrega. Cada campo puede aparecer
una vez. El contrato público actual no combina captación de leads con
`ask_to_follow` en la misma secuencia. Elige la prioridad en lugar de prometer
las dos condiciones.

Define un mensaje útil de reintento, un límite de intentos y el resultado en
caso de fallo. `stop` termina la condición sin entregar el recurso al agotar
los intentos. `continue` permite entregarlo sin completar la recopilación.
La caducidad no amplía la ventana de mensajes de Instagram.

Una acción `add_contact_tag` necesita el ID de una etiqueta existente y va
después de una acción de entrega. Una etiqueta organiza el contacto; por sí
sola no confirma una compra ni crea un nuevo disparador de automatización.

## Mide el resultado que buscas

Elige una medida de éxito y otra de fricción antes de comparar versiones. Por
ejemplo, compara entregas completas del material con personas que iniciaron el
flujo. Para ventas, usa datos del checkout; un clic en el enlace no es una compra.

Usa `get_metrics` y `get_automation_metrics` solo para los campos que devuelven
sus schemas. No exponen un embudo completo de campaña ni atribución de compras.
Si falta el denominador, la finalización de la condición o un seguimiento
atribuido, márcalo como no medido. Compara periodos y audiencias semejantes y
no interpretes una muestra pequeña o cambiante como prueba de causalidad.

## Recetas iniciales

Los ejemplos siguientes son configuraciones completas, no valores predeterminados
del servidor ni instrucciones para ejecutar en tu cuenta. Sustituye palabra
clave, texto, publicación y URL por los valores acordados. El intervalo de seis
horas es ilustrativo. Los permisos, el plan y los medios aún necesitan validación.

### Apertura, entrega y una pregunta de cualificación

Este ejemplo propone cinco variaciones de respuesta pública y tres mensajes
breves tras el clic. La secuencia termina en la pregunta para que una persona
revise la respuesta. Pausas de cinco y ocho segundos, límite público de 50,
rotación secuencial, sin menciones y sin cooldown configurado son elecciones
ilustrativas para discutir, no valores predeterminados de campaña. Confirma que
la publicación deseada sea la siguiente tras la activación. Sin clic en la
apertura, la secuencia no empieza.

```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 directa

```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
    }
  }
}
```

### Recopila correo y después entrega en 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
    }
  }
}
```

Pide a un agente con `get_automation_guide` que consulte `objectives`, `opening`, `conversation`, `public_replies`, `triggers` o `capture`.
Continúa con [Condición de seguimiento](/es/mcp/follow-gate),
[Contactos estratégicos](/es/mcp/strategic-contacts) o
[Límites de Instagram](/es/mcp/instagram-limits).


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