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

# Monte uma sequência de follow-up

> Exemplos e regras de ordem para os oito tipos de actions.

Coloque estes objetos em `configuration.follow_up.actions`, na ordem de
execução. Cada exemplo é uma action, não uma configuração completa. Uma
sequência exige pelo menos uma action de entrega e um `finish` final, com até 20
actions no total.

## Envie texto e botões de link

```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` e `buttons`. Use um array vazio para não incluir
botões: nesse caso, o texto permite de 1 a 1000 valores escalares Unicode. Com 1
a 3 botões, permite de 1 a 640. Botões de follow-up são apenas de URL, com
títulos de 1 a 20 valores escalares e URLs HTTP(S). O clique em uma URL não
retoma a sequência.

## Envie mídia

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

`send_media` aceita `media_type` com valores `image`, `video`, `audio` ou
`file`, com uma `url` HTTP(S) pública. Mantenha o arquivo acessível até a
entrega. A API de criação aceita uma URL, não upload multipart ou base64. A
validação estrutural não baixa o arquivo nem verifica tamanho, tipo MIME ou
aceitação pelo provedor.

## Envie um carrossel

Use `send_carousel` para 1 a 10 cards de imagem, cada um com 1 a 3 botões de
URL. O [guia de carrosséis](/pt-BR/guides/carousels) inclui todos os campos e um
exemplo completo de criação.

## Peça ao contato para seguir

```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` verifica no Instagram se o contato segue a conta; `trusted_click`
confia no clique de confirmação. `not_following_message` é obrigatório, mas pode
ser `null`. As duas mensagens permitem de 1 a 640 valores escalares; os títulos
dos botões, de 1 a 20. `max_attempts` vai de 1 a 10. `recheck_after_seconds` vai
de 60 a 86400; `expires_in_seconds`, de 60 a 604800.

## Peça um endereço de e-mail

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

## Peça um número de telefone

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

As duas actions de captura exigem todos os campos mostrados. `message` e
`retry_message` permitem de 1 a 1000 valores escalares; `max_attempts` vai de 1
a 5; `expires_in_seconds`, de 60 a 604800. A captura valida o valor informado,
não sua titularidade, e não envia e-mail ou mensagem de WhatsApp.

Em todas as etapas de espera, `retry_exhausted_action` aceita `continue` ou
`stop`. A expiração encerra a etapa mesmo quando o esgotamento das tentativas
está configurado para continuar. A expiração configurada não estende a permissão
do Instagram para enviar mensagens.

## Adicione uma tag ao contato

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

Use o UUID de uma tag existente na conta selecionada. Coloque `add_contact_tag`
depois de uma action de entrega. Seu `delay_seconds` aceita de 0 a 2592000, mas
uma mensagem posterior ainda precisa respeitar a validação cumulativa da janela
de mensagens.

## Finalize a sequência

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

`finish` aparece exatamente uma vez, no final, e não aceita atraso nem outros
campos.

## Ordem e temporização

Todo follow-up não nulo exige exatamente um botão `start_follow_up` na abertura,
para qualquer tipo de trigger. Etapas de espera vêm antes da entrega. Use no
máximo um `ask_to_follow`; ele não pode ser combinado com captura de e-mail ou
telefone. E-mail e telefone podem aparecer uma vez cada, em qualquer ordem.

Atrasos de entrega e de etapas de espera são inteiros de 0 a 86399 segundos,
relativos à conclusão bem-sucedida anterior. Esperas acumuladas, incluindo
atrasos de tags e verificações de follow em segundo plano, precisam manter cada
action de envio dentro de 86399 segundos do início aplicável da janela. Uma
resposta recebida na captura reinicia essa referência; uma verificação
silenciosa de follow não. Filas e o ritmo de envio da conta podem adicionar
latência. Uma configuração salva não comprova entrega.


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