> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/hablla/marketing/execucoes-de-fluxos-em-lote.md).

# Execuções de Fluxos em Lote

A **Execução de Fluxos em Lote** permite executar um fluxo de automação para múltiplas pessoas de forma massiva, possibilitando automatizar comunicações, atualizações e diferentes processos em larga escala.

Diferente de uma ação limitada ao envio de uma única mensagem, neste recurso **todo o fluxo configurado será executado para cada pessoa definida como alvo da execução**.

Isso permite utilizar toda a versatilidade dos Fluxos de Automação da Hablla para construir diferentes estratégias e processos.

Por exemplo, uma execução em lote pode iniciar um fluxo que envia uma mensagem para determinado público e, de acordo com a interação de cada pessoa, atualiza informações, executa novas ações ou transfere o atendimento para um atendente.

Outros exemplos de utilização incluem:

* Atualização de informações de Pessoas;
* Execução de integrações e automações;
* Segmentação de diferentes caminhos de acordo com regras definidas no fluxo;
* Execução de processos personalizados construídos através dos componentes disponíveis nos Fluxos de Automação.

As possibilidades dependem diretamente da **lógica configurada no fluxo utilizado na execução**.

{% hint style="info" %}
A **Execução de Fluxos em Lote** é um recurso recomendado para usuários que já possuem conhecimento sobre a criação e o funcionamento dos **Fluxos de Automação da Hablla**.

Antes de realizar execuções para grandes públicos, recomendamos testar o fluxo utilizando uma quantidade reduzida de pessoas. Dessa forma, você poderá validar seu comportamento antes de ampliar a execução.
{% endhint %}

## Como criar uma Execução de Fluxos em Lote

A configuração é realizada em etapas, nas quais você poderá definir **como a execução acontecerá, quem fará parte dela e qual fluxo será utilizado**.

{% stepper %}
{% step %}

### 1. Acesse Execução de Fluxos em Lote

No menu superior da Hablla, acesse **Marketing** e selecione a opção **Execução de Fluxos em Lote**. Nesta página serão apresentadas as execuções já cadastradas no seu workspace.

Para criar uma nova, clique no botão <kbd>**+ Novo Disparo**</kbd>, localizado no canto superior direito da tela.

<figure><img src="https://1879311494-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrmxWrIrMauHcIrsuqfGq%2Fuploads%2FUtaIAczKr8LxVu4MaaeI%2F%5BDOCS%5D%20-%20Como%20Acessar%20Execu%C3%A7%C3%A3o%20de%20Fluxos%20em%20Lote.gif?alt=media&amp;token=afafb876-1b63-42f4-aaed-b8e1135b8bdb" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 2. Configurações de Informações do Disparo

Na primeira etapa, configure as informações básicas da execução.

> **Nome do Disparo**: Defina um nome que permita identificar facilmente essa execução posteriormente. Utilize uma nomenclatura relacionada ao objetivo ou público da execução para facilitar sua identificação.

> **Tipo de Envio**: Defina **quando** a execução deverá ser iniciada. Você poderá configurar a execução para ser realizada **imediatamente** após a finalização da configuração do disparo ou definir um **agendamento** para que ela seja iniciada em uma data e horário programado.

> **Modo de Envio**: Defina como as execuções serão processadas. Você poderá escolher entre **Único Lote** ou **Fracionado**.
>
> * **Único lote:** Utilize essa opção quando desejar processar todas as execuções de uma só vez.
> * **Fracionado**: O modo **Fracionado** permite dividir a execução em grupos menores, distribuídos ao longo do tempo. Ao selecionar essa opção, configure:
>
>   * **Intervalo:** valor da quantidade **em** **minutos** entre cada lote;
>   * **Tamanho do lote:** quantidade de execuções que deverão ser iniciadas a cada intervalo.
>
>   Por exemplo, para uma execução destinada a `1.000` pessoas, você poderia configurar:
>
>   <table><thead><tr><th width="198.17236328125">Configuração</th><th align="right">Valor</th></tr></thead><tbody><tr><td><strong>Quantidade total</strong></td><td align="right">1.000 pessoas</td></tr><tr><td><strong>Tamanho do lote</strong></td><td align="right">100</td></tr><tr><td><strong>Intervalo</strong></td><td align="right">10 minutos</td></tr></tbody></table>
>
>   Nesse cenário, a Hablla processará **100 execuções a cada 10 minutos**, até que o total do público definido seja processado. O envio fracionado pode ser utilizado quando você deseja distribuir a execução ao longo do tempo em vez de iniciar todo o volume simultaneamente.

{% endstep %}

{% step %}

### 3. Defina os alvos da execução

{% endstep %}
{% endstepper %}

**\[GIF — Configurando as informações e o modo de envio]**

### Defina os alvos da execução

Na próxima etapa, você deverá definir **para quais pessoas o fluxo será executado**.

A Hablla permite definir esse público de duas formas:

| Opção                 | Como funciona                                                                                                           |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| **Arquivo**           | Permite utilizar um arquivo contendo os dados que serão utilizados como entrada para a execução.                        |
| **Filtros Dinâmicos** | Permite utilizar as próprias Pessoas cadastradas no workspace e segmentá-las através dos filtros disponíveis na Hablla. |

#### Utilizando um arquivo

Caso escolha utilizar um arquivo, faça o upload do documento que contém os dados que serão utilizados na execução.

Atualmente, são aceitos os seguintes formatos:

* `.xlsx`
* `.xls`
* `.json`

Após realizar o upload, continue para a próxima etapa da configuração.

**\[GIF — Realizando o upload de um arquivo]**

#### Utilizando Filtros Dinâmicos

Caso escolha utilizar os **Filtros Dinâmicos**, você poderá segmentar as Pessoas cadastradas no seu workspace de acordo com os critérios disponíveis.

Conforme os filtros forem configurados, a Hablla apresentará a **quantidade de pessoas correspondentes à segmentação**, permitindo visualizar o tamanho do público que fará parte da execução.

Os filtros seguem a mesma lógica de segmentação utilizada em outros recursos de Marketing da Hablla.

Para conhecer os filtros disponíveis e entender como utilizá-los, consulte nossa documentação sobre **Filtros Dinâmicos clicando aqui**.

**\[GIF — Criando uma segmentação utilizando Filtros Dinâmicos]**

### Selecione o Fluxo

Depois de definir os alvos da execução, selecione o **Fluxo de Automação** que deverá ser utilizado.

O fluxo selecionado será executado para as pessoas definidas nas etapas anteriores.

É justamente a estrutura desse fluxo que determinará **o que acontecerá durante a execução em lote**.

Por exemplo, se o fluxo possuir uma ação responsável por enviar uma mensagem, essa ação será executada durante o processamento das pessoas definidas como alvo.

Se o fluxo possuir outras etapas, como atualização de dados, condições, integrações ou transferências, essas ações também poderão fazer parte da execução de acordo com a lógica construída.

**\[GIF — Selecionando o Fluxo de Automação]**

### Revise e finalize a execução

Após concluir todas as configurações, revise as informações definidas antes de continuar.

Confira principalmente:

* O público selecionado;
* A quantidade de pessoas envolvidas;
* O modo de envio;
* O agendamento, caso tenha sido configurado;
* O fluxo selecionado;
* As ações que serão executadas por esse fluxo.

Quando estiver tudo correto, clique em **Finalizar**, no canto superior direito da tela.

{% hint style="danger" %}
**Revise cuidadosamente sua configuração antes de confirmar uma Execução de Fluxos em Lote.**

O fluxo selecionado será executado de forma massiva para o público definido e poderá realizar ações como envio de mensagens, alterações de dados e outros processos configurados na automação.

Dependendo dos componentes, canais e serviços utilizados pelo fluxo, a execução também poderá **gerar cobranças relacionadas ao uso desses recursos**.

Por isso, recomendamos validar previamente o fluxo com uma quantidade reduzida de pessoas e conferir o público selecionado antes de realizar execuções em maior escala.
{% endhint %}

### Confirme a execução

Ao clicar em **Finalizar**, a Hablla exibirá uma janela de confirmação antes de registrar a solicitação.

Para confirmar que você está ciente da ação que será realizada, será necessário digitar no campo apresentado a **palavra de confirmação solicitada pelo sistema**.

Após preencher corretamente a confirmação, o botão responsável por concluir a ação será liberado.

Clique no botão de confirmação para registrar a Execução de Fluxos em Lote.

**\[GIF — Revisando e confirmando a execução]**

### Tudo pronto!

Após a confirmação, a Hablla processará a execução de acordo com as configurações definidas.

Se você configurou uma execução **imediata**, o processamento poderá ser iniciado após a confirmação. Caso tenha utilizado um **agendamento**, a execução seguirá a data e o horário configurados.

No modo **Fracionado**, o processamento seguirá o intervalo e o tamanho dos lotes definidos anteriormente.

A partir desse momento, o comportamento de cada execução dependerá da lógica construída no **Fluxo de Automação selecionado**.

É justamente essa flexibilidade que permite utilizar a Execução de Fluxos em Lote para diferentes necessidades da sua operação, desde comunicações em larga escala até processos automatizados mais completos.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.hablla.com/hablla/marketing/execucoes-de-fluxos-em-lote.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
