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

# Crea una secuencia de seguimiento

> Ejemplos y reglas de orden para los ocho tipos de actions.

Coloca estos objetos en `configuration.follow_up.actions`, en orden de
ejecución. Cada ejemplo es una action, no una configuración completa. Una
secuencia exige al menos una action de entrega y un `finish` final, con un
máximo de 20 actions en total.

## Envía texto y botones de enlace

```json theme={null}
{
  "type": "send_message",
  "delay_seconds": 0,
  "text": "Here is your guide.",
  "buttons": [
    {
      "type": "url",
      "title": "Open guide",
      "url": "https://example.com/guide"
    }
  ]
}
```

`send_message` exige `text` y `buttons`. Usa un array vacío para no incluir
botones: en ese caso, el texto permite de 1 a 1000 valores escalares Unicode.
Con 1 a 3 botones, permite de 1 a 640. Los botones de seguimiento son solo de
URL, con títulos de 1 a 20 valores escalares y URL HTTP(S). Un clic en una URL
no reanuda la secuencia.

## Envía contenido multimedia

```json theme={null}
{
  "type": "send_media",
  "delay_seconds": 0,
  "media_type": "image",
  "url": "https://example.com/guide.jpg"
}
```

`send_media` acepta `media_type` con valores `image`, `video`, `audio` o `file`,
con una `url` HTTP(S) pública. Mantén el archivo accesible hasta la entrega. La
API de creación acepta una URL, no carga multipart ni base64. La validación
estructural no descarga el archivo ni comprueba su tamaño, tipo MIME o
aceptación por el proveedor.

## Envía un carrusel

Usa `send_carousel` para 1 a 10 tarjetas de imagen, cada una con 1 a 3 botones
de URL. La [guía de carruseles](/es/guides/carousels) incluye todos los campos y
un ejemplo completo de creación.

## Pide al contacto que siga la cuenta

```json theme={null}
{
  "type": "ask_to_follow",
  "delay_seconds": 0,
  "message": "Follow our account, then confirm to receive the guide.",
  "buttons": {
    "open_profile_title": "Open profile",
    "confirm_title": "I follow you"
  },
  "verification_mode": "strict",
  "not_following_message": "We could not confirm your follow yet. Please try again.",
  "max_attempts": 3,
  "retry_exhausted_action": "stop",
  "recheck_after_seconds": 300,
  "expires_in_seconds": 86400
}
```

`strict` comprueba en Instagram si el contacto sigue la cuenta; `trusted_click`
confía en el clic de confirmación. `not_following_message` es obligatorio, pero
puede ser `null`. Ambos mensajes permiten de 1 a 640 valores escalares; los
títulos de botones, de 1 a 20. `max_attempts` va de 1 a 10.
`recheck_after_seconds` va de 60 a 86400; `expires_in_seconds`, de 60 a 604800.

## Pide una dirección de correo

```json theme={null}
{
  "type": "ask_for_email",
  "delay_seconds": 0,
  "message": "What is your email address?",
  "retry_message": "Please send a valid email address.",
  "max_attempts": 3,
  "retry_exhausted_action": "stop",
  "expires_in_seconds": 86400
}
```

## Pide un número de teléfono

```json theme={null}
{
  "type": "ask_for_phone",
  "delay_seconds": 0,
  "message": "What is your phone number?",
  "retry_message": "Please send a valid phone number.",
  "max_attempts": 3,
  "retry_exhausted_action": "stop",
  "expires_in_seconds": 86400
}
```

Ambas actions de captura exigen todos los campos mostrados. `message` y
`retry_message` permiten de 1 a 1000 valores escalares; `max_attempts` va de 1 a
5; `expires_in_seconds`, de 60 a 604800. La captura valida el valor enviado, no
su titularidad, y no envía correos ni mensajes de WhatsApp.

En todas las etapas de espera, `retry_exhausted_action` acepta `continue` o
`stop`. La caducidad termina la etapa incluso cuando el agotamiento de intentos
está configurado para continuar. La caducidad configurada no amplía el permiso
de Instagram para enviar mensajes.

## Añade una etiqueta al contacto

```json theme={null}
{
  "type": "add_contact_tag",
  "delay_seconds": 0,
  "tag_id": "00000000-0000-4000-8000-000000000003"
}
```

Usa el UUID de una etiqueta existente en la cuenta seleccionada. Coloca
`add_contact_tag` después de una action de entrega. Su `delay_seconds` acepta de
0 a 2592000, pero un mensaje posterior todavía debe cumplir las comprobaciones
acumuladas de la ventana de mensajes.

## Finaliza la secuencia

```json theme={null}
{
  "type": "finish"
}
```

`finish` aparece exactamente una vez, al final, y no acepta retraso ni otros
campos.

## Orden y tiempos

Todo seguimiento no nulo exige exactamente un botón `start_follow_up` en la
apertura, para cualquier tipo de trigger. Las etapas de espera van antes de la
entrega. Usa como máximo un `ask_to_follow`; no se puede combinar con captura de
correo o teléfono. Correo y teléfono pueden aparecer una vez cada uno, en
cualquier orden.

Los retrasos de entrega y de etapas de espera son enteros de 0 a 86399 segundos,
relativos a la finalización correcta anterior. Las esperas acumuladas, incluidos
retrasos de etiquetas y comprobaciones de seguimiento en segundo plano, deben
mantener cada action de envío dentro de 86399 segundos del inicio aplicable de
la ventana. Una respuesta entrante de captura reinicia esa referencia; una
comprobación silenciosa de seguimiento no. Las colas y el ritmo de envío de la
cuenta pueden añadir latencia. Una configuración guardada no demuestra la
entrega.


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