> For the complete documentation index, see [llms.txt](https://academy.vambe.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.vambe.ai/workflows/workflows-pt-br/sequencias-agrupe-as-tentativas-sem-duplicar-nos.md).

# Sequências: agrupe as tentativas sem duplicar nós

Montar um workflow com reintentos — ligar, esperar, tentar novamente, esperar, tentar de novo — significava até agora duplicar a mesma lógica de nós e condições repetidamente. Um fluxo de quatro tentativas podia terminar com mais de 30 nós, difíceis de ler e de manter.

As **sequências** são um novo tipo de nó que resolve isso: agrupam vários nós que são executados em ordem, com esperas e condições de saída configuráveis entre cada um, e terminam assim que uma condição é atendida ou ao chegar ao final da lista.

{% hint style="info" %}
**Para entrar:** dentro do editor de um Flow, adicione um nó e selecione **Sequência** na lista de tipos de nó disponíveis.
{% endhint %}

***

### Como funciona uma sequência

Uma sequência executa seus passos **em ordem, de cima para baixo**. Em cada passo, você pode configurar duas coisas, independentes entre si:

* **Esperar depois deste passo** — quanto tempo esperar depois que o passo terminar, antes de avaliar sua condição de saída.
* **Condição de saída** — a regra que, se for atendida, faz a sequência terminar ali mesmo.

Se a condição de saída de um passo **não for atendida**, a sequência continua com o próximo passo. Se for atendida, a sequência termina imediatamente. E, se chegar ao final sem que nenhuma condição tenha sido atendida, a sequência também termina — isso equivale a ter esgotado as tentativas.

<figure><img src="https://450999295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0xCLgfGby0xiCWJaqr57%2Fuploads%2Fuk6pcii7k8z4h1Gfrsfa%2F2-nodo-secuencia-estructura.png?alt=media&amp;token=c2c6afdd-a6c9-46c4-a407-a7ab32f36767" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Você pode adicionar **qualquer tipo de nó da plataforma** dentro de uma sequência: uma chamada, um template, uma mensagem com IA, uma espera manual, o que você precisar. E você pode **reordená-los** arrastando-os, ou adicionar novos passos no mesmo painel da sequência.
{% endhint %}

***

### Esperar antes ou depois de avaliar

Nem sempre convém avaliar a condição de saída no mesmo momento. Por exemplo, em uma sequência de reintentos de chamada:

* Você quer avaliar **imediatamente** se a chamada foi atendida — não faz sentido esperar para isso.
* Mas, se não foi atendida, você quer **esperar um minuto** antes de tentar novamente.

Já se o passo for enviar um template de WhatsApp, você não vai avaliar a resposta na hora — aí convém esperar um tempo maior (por exemplo, uma hora) antes de verificar se o cliente respondeu.

Para tentar novamente várias vezes, basta **duplicar o passo**: como a condição se baseia no resultado do nó (por exemplo, se a chamada ficou no estado `concluído`), duplicá-lo funciona corretamente sem precisar reconfigurar nada.

<figure><img src="https://450999295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0xCLgfGby0xiCWJaqr57%2Fuploads%2FfnBjf8EpG7gwY4xCb3Et%2F3-pasos-espera-condicion-salida.png?alt=media&amp;token=ae974b24-1f1f-43d0-a26f-be6302a64596" alt=""><figcaption></figcaption></figure>

***

### Como ramificar de acordo com o resultado: Condição de sequência

Uma sequência, por si só, tem uma única saída para o próximo nó do fluxo, independentemente de em qual passo ela tenha terminado. Se você precisa que o fluxo continue de forma diferente de acordo com **como** a sequência terminou, adicione um nó de condição do tipo **Condição de sequência**.

Aí você seleciona a sequência que quer avaliar, e o nó permite ramificar entre seus dois possíveis estados de saída:

* **Condição atendida** — a sequência terminou porque alguma de suas condições de saída foi atendida.
* **Concluída** — a sequência chegou ao final sem que nenhuma condição fosse atendida.

<figure><img src="https://450999295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0xCLgfGby0xiCWJaqr57%2Fuploads%2FhlwklwkQwz842OV73T7Q%2F4-condicion-de-secuencia-ramas.png?alt=media&amp;token=f22e43e9-50f0-44c2-815c-9a420935f583" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Se você não adicionar um nó de Condição de sequência, não há problema: a sequência simplesmente segue por um único caminho até o próximo nó, independentemente de como tenha terminado.
{% endhint %}

***

### Resultado real: de 31 a 16 nós

Em um caso real de reintentos de chamada com três tentativas, substituir a lógica duplicada por uma sequência reduziu o workflow de **31 a 16 nós**, sem mudar seu comportamento. Na execução, vê-se exatamente a mesma coisa de antes — se o contato respondeu na primeira tentativa, a segunda e a terceira não são executadas, e o fluxo sai direto por **Condição atendida**.

<figure><img src="https://450999295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0xCLgfGby0xiCWJaqr57%2Fuploads%2FbcEsEBqGfXuA3s9C7dci%2F6-ejecucion-reducida-3-pasos.png?alt=media&amp;token=8f2b9275-a849-4b3f-a0d7-a01caf882511" alt=""><figcaption></figcaption></figure>

***

### Variáveis disponíveis

Depois que a sequência for executada, você pode referenciar informações sobre como ela terminou — tanto dentro do nó de Condição de sequência quanto em passos posteriores do fluxo:

* **Por qual tipo de nó saiu** — por exemplo, se a saída ocorreu em um passo de chamada ou em um de envio de mensagem.
* **Em qual passo saiu** — se foi no passo 1, 2, 3 etc.
* **Quantos passos ocorreram** no total antes de sair.
* **O estado do passo** — se ficou concluído ou não alcançado.
* **Se a sequência foi interrompida** antes de terminar.

<figure><img src="https://450999295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0xCLgfGby0xiCWJaqr57%2Fuploads%2FXmabhyymrzewRtN2ojdg%2F5-variables-de-la-secuencia.png?alt=media&amp;token=c9d2c3c8-7299-4abe-a1ab-688a974f3672" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Sobre as variáveis dos nós dentro da sequência:** se você tiver vários nós do mesmo tipo dentro de uma sequência (por exemplo, três passos de "Ativar chamada IA"), Vambe **agrupa as variáveis por tipo**: ao referenciar uma variável desse tipo de nó, você sempre vai obter a do último nó desse tipo que foi executado — não a de um passo específico. Isso é necessário porque, de antemão, não se sabe em qual passo a sequência vai sair.
{% endhint %}

***

### Em resumo

Uma sequência agrupa nós que são executados em ordem, com esperas e condições de saída configuráveis entre cada um, e termina por **Condição atendida** ou **Concluída**. Você pode tentar novamente simplesmente duplicando passos, ramificar o fluxo depois com um nó de **Condição de sequência**, e referenciar o resultado com as variáveis da sequência. O resultado prático: a mesma lógica de reintentos, com muito menos nós e muito mais fácil de ler e manter.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://academy.vambe.ai/workflows/workflows-pt-br/sequencias-agrupe-as-tentativas-sem-duplicar-nos.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
