> ## Documentation Index
> Fetch the complete documentation index at: https://help.wizebot.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Blocos avançados do fluxo

> Entenda o que fazem os blocos da categoria Avançado do editor de fluxos e como configurar cada um

![Editor de fluxos com os blocos Horário de atendimento, Formulário do WhatsApp, Pipeline, Pagamento PIX, Agente de IA e Iniciar automação ligados](https://mintcdn.com/wizebot-d8529edc/npLQJVV8gD5vOhne/images/fluxo-blocos-avancados/capa.png?fit=max\&auto=format\&n=npLQJVV8gD5vOhne\&q=85\&s=7eb77bda19888be67b0581a9d13e50dc)

Os blocos da categoria **Avançado** ligam o fluxo a outras partes da WizeBot: agentes de IA, formulários do WhatsApp, modelos aprovados, outros fluxos, o funil do CRM, o horário de atendimento, cobranças Pix e eventos de conversão para os seus anúncios.

Para adicionar um deles, abra o fluxo em **Fluxos**, clique no **+** azul no canto superior direito do editor e desça até **Avançado**. Para configurar, clique no bloco no canvas: o painel abre à esquerda. Se ainda não sabe montar um fluxo, comece por [Criar e ativar um fluxo](https://help.wizebot.com.br/tutoriais/gerenciador-bots/fluxo.md).

![Menu de blocos aberto com a categoria Avançado destacada](https://mintcdn.com/wizebot-d8529edc/npLQJVV8gD5vOhne/images/fluxo-blocos-avancados/01-menu-avancado.png?fit=max\&auto=format\&n=npLQJVV8gD5vOhne\&q=85\&s=f3780a8efaa1f38f1962d8c2d608a1af)

## Resumo dos blocos

| Bloco | Para que serve | Saídas |
| - | - | - |
| [Agente de IA](#agente-de-ia) | Passa o atendimento para um agente de IA | Uma, só no modo **Aguardar próxima mensagem** |
| [Formulário do WhatsApp](#formulário-do-whatsapp) | Envia um formulário para o cliente preencher no WhatsApp | **Quando responder** e, com prazo, **Se não respondeu em…** |
| [Modelo do WhatsApp](#modelo-do-whatsapp) | Envia um modelo de mensagem aprovado pela Meta | Uma |
| [Iniciar automação](#iniciar-automação) | Começa outro fluxo na mesma conversa | Nenhuma |
| [Pipeline CRM](#pipeline-crm) | Cria ou move o card do contato no funil | Uma |
| [Horário de atendimento](#horário-de-atendimento) | Separa o caminho de dentro e de fora do horário | **Aberto** e **Fechado** |
| [Pagamento PIX](#pagamento-pix) | Envia uma cobrança Pix com os itens do pedido | Uma |
| [Conversão](#conversão) | Avisa a plataforma de anúncios que houve uma venda ou um lead | Uma |

> [!NOTE]
>
> Formulário do WhatsApp, Modelo do WhatsApp e Pagamento PIX só existem no WhatsApp. Quando o fluxo roda numa conversa do Telegram ou do chat no site, esses blocos não enviam nada e o fluxo segue pela saída do bloco. A exceção é o Formulário com prazo de resposta: nesse caso o fluxo termina no bloco.

## Agente de IA

Coloca um [agente de IA](https://help.wizebot.com.br/tutoriais/ia/agentes.md) para atender a conversa a partir deste ponto. Use quando o fluxo já fez a triagem e o restante do atendimento pode ficar com a IA. Por exemplo: depois de perguntar o que o cliente procura, a vendedora virtual tira dúvidas sobre tamanhos e fecha o pedido.

**Antes de usar:** crie o agente em **Agents** e deixe ele ativo. Só agentes ativos aparecem na lista. Sem nenhum, o painel mostra **Nenhum agente ativo**.

![Painel do bloco Agente de IA com Quando ativar, Limite de mensagens e Transferir para humano numerados](https://mintcdn.com/wizebot-d8529edc/npLQJVV8gD5vOhne/images/fluxo-blocos-avancados/02-agente-de-ia.png?fit=max\&auto=format\&n=npLQJVV8gD5vOhne\&q=85\&s=97d8005f85df70408dc63f2d0b16e09c)

* **Agente**: o agente que vai atender. Para mudar, clique em **Trocar**.
* **Quando ativar** (1):
  * **Aguardar próxima mensagem**: o agente fica pronto e responde quando o cliente mandar a próxima mensagem. O fluxo continua pela saída do bloco na mesma hora, sem esperar o agente.
  * **Responder imediatamente**: o agente responde agora à mensagem que o cliente acabou de mandar. Neste modo o bloco não tem saída, e os blocos seguintes deste fluxo não rodam.
* **Avançado** (clique para abrir):
  * **Limite de mensagens** (2): quantas respostas o agente dá antes de parar, de 1 a 100. Vazio é sem limite.
  * **Transferir para humano** (3): ao atingir o limite ou terminar o atendimento, a conversa passa para a equipe.
  * **Mensagens do fluxo no histórico**: o agente lê o que o fluxo já mandou, para não repetir perguntas.

Se o agente escolhido foi apagado ou desativado, o fluxo termina neste bloco e nada é enviado ao cliente.

## Formulário do WhatsApp

Envia um formulário nativo do WhatsApp: o cliente toca no botão, preenche as telas sem sair da conversa e as respostas voltam para a WizeBot. Serve para pegar endereço de entrega, agendar um horário ou fazer um cadastro sem uma pergunta por vez.

**Antes de usar:** crie e publique o formulário. O passo a passo está em [Formulários do WhatsApp](https://help.wizebot.com.br/tutoriais/whatsapp-flows/criar-formulario.md). Só formulários publicados aparecem na lista.

![Painel do bloco Formulário do WhatsApp com Formulário, Mensagem e Texto do botão numerados](https://mintcdn.com/wizebot-d8529edc/npLQJVV8gD5vOhne/images/fluxo-blocos-avancados/03-formulario.png?fit=max\&auto=format\&n=npLQJVV8gD5vOhne\&q=85\&s=5170015e7e69fc51286c774452d6d924)

* **Formulário** (1): o formulário que vai ser enviado. **Novo formulário** abre o estúdio em outra aba. Clique em **Verificar envio** para conferir se a Meta está aceitando o envio desse formulário.
* **Tela inicial**: por qual tela o formulário abre. Só aparecem as telas que podem abrir sozinhas.
* **Mensagem** (2): o texto que acompanha o botão. Aceita variáveis.
* **Texto do botão** (3): o que aparece no botão que abre o formulário, até 20 caracteres. Vazio, o botão diz "Abrir".
* **Esperar resposta por**: **Sem prazo**, **30 minutos**, **1 hora**, **6 horas** ou **24 horas**. Com prazo, o bloco ganha a saída **Se não respondeu em…** para quem não preencheu a tempo.
* **Modo de envio**: **Publicado** para os clientes ou **Rascunho (teste)**, que só abre para os números de teste da conta.

O fluxo para neste bloco e segue pela saída **Quando responder** assim que o cliente envia o formulário.

## Modelo do WhatsApp

Envia um modelo de mensagem aprovado pela Meta. É o jeito de falar com quem está fora da janela de 24 horas do WhatsApp, como na confirmação de um pagamento que chegou horas depois da última conversa.

**Antes de usar:** crie o modelo e espere a aprovação da Meta. Veja [Criar modelo](https://help.wizebot.com.br/tutoriais/modelos-mensagem/criacao.md). Só modelos aprovados aparecem na lista.

![Painel do bloco Modelo do WhatsApp com Modelo aprovado e Variáveis do modelo numerados, e a pré-visualização do modelo](https://mintcdn.com/wizebot-d8529edc/npLQJVV8gD5vOhne/images/fluxo-blocos-avancados/04-modelo-whatsapp.png?fit=max\&auto=format\&n=npLQJVV8gD5vOhne\&q=85\&s=dcc1241ec813e1bf87ce1aa6da2a3cf3)

* **Modelo aprovado** (1): busque e clique no modelo. Cada item mostra o idioma e a categoria.
* **Variáveis do modelo** (2): para cada variável do texto, digite um valor fixo ou clique em **{ }** para escolher uma variável, como o nome do contato. Os atalhos abaixo do campo (**Evento**, **Nome do produto**, **ID do produto**, **E-mail do comprador**, **Nome do comprador**) usam os dados que chegam por [webhook](https://help.wizebot.com.br/tutoriais/integracoes/webhooks.md).
* **Mídia do cabeçalho**: aparece quando o modelo tem imagem, vídeo ou documento no topo. Escolha **URL fixa**, **Variável do fluxo** ou **Variável do webhook**.
* **Pré-visualização**: mostra como a mensagem chega no celular.

O fluxo envia o modelo e segue pela saída na mesma hora, sem esperar resposta.

## Iniciar automação

Começa outro fluxo na mesma conversa. Use para reaproveitar um fluxo que já existe em vez de repetir os mesmos blocos. Por exemplo: todos os fluxos de venda, quando a loja está fechada, chamam o mesmo fluxo "Recado fora do horário".

![Painel do bloco Iniciar automação com Fluxo de destino e Passar variáveis numerados](https://mintcdn.com/wizebot-d8529edc/npLQJVV8gD5vOhne/images/fluxo-blocos-avancados/05-iniciar-automacao.png?fit=max\&auto=format\&n=npLQJVV8gD5vOhne\&q=85\&s=e5bdf9a3c071e38a9fb1ee32e0945183)

* **Fluxo de destino** (1): o fluxo que vai começar. A lista mostra só fluxos ativos e não mostra o próprio fluxo que você está editando.
* **Passar variáveis** (2): o fluxo de destino recebe as variáveis que este fluxo já preencheu.

O bloco não tem saída: ele é o último passo deste caminho. O fluxo de destino começa logo em seguida. Se o fluxo de destino estiver desativado, o fluxo atual termina neste bloco sem iniciar o outro.

## Pipeline CRM

Coloca o contato no [funil do CRM](https://help.wizebot.com.br/tutoriais/crm/funil.md) ou muda a etapa dele. Assim o funil se atualiza sozinho conforme o cliente avança no fluxo. Por exemplo: quem recebeu a cobrança vai para **Proposta enviada**. No canvas, o bloco aparece com o nome **Pipeline**.

![Painel do bloco Pipeline CRM com Operação, Pipeline e Etapa de destino numerados](https://mintcdn.com/wizebot-d8529edc/npLQJVV8gD5vOhne/images/fluxo-blocos-avancados/06-pipeline-crm.png?fit=max\&auto=format\&n=npLQJVV8gD5vOhne\&q=85\&s=42643013727bce03f332c0670aef3519)

* **Operação** (1):
  * **Criar lead**: cria um card na etapa escolhida. Se o contato já tem um card aberto nesse pipeline, nada muda. Nesta opção aparece também o campo **Valor**, que vai para o card novo.
  * **Mover etapa**: move o card aberto do contato para a etapa escolhida. Com **Criar se não existir** ligado, cria o card quando o contato ainda não tem um.
  * **Garantir etapa**: cria o card se não existir e move se já existir. Na dúvida, use esta.
* **Pipeline** (2): qual funil.
* **Etapa de destino** (3): a coluna onde o card deve ficar.

O fluxo sempre segue pela saída, mesmo quando o bloco não consegue mexer no card. Por exemplo, na opção **Mover etapa** sem card e sem **Criar se não existir**, o fluxo continua normalmente.

## Horário de atendimento

Verifica se a empresa está aberta naquele momento e manda o fluxo por um de dois caminhos. Use para responder de um jeito durante o expediente e de outro fora dele.

**Antes de usar:** configure os dias e horários em **Configurações** > **Horario**. Veja [Horário de atendimento](https://help.wizebot.com.br/tutoriais/configuracao/horario-atendimento.md).

![Painel do bloco Horário de atendimento com as saídas Aberto e Fechado destacadas](https://mintcdn.com/wizebot-d8529edc/npLQJVV8gD5vOhne/images/fluxo-blocos-avancados/07-horario.png?fit=max\&auto=format\&n=npLQJVV8gD5vOhne\&q=85\&s=c759ef22273bd996da28c4f4f59ebe7f)

O bloco não tem campos. As **Saídas do nó** (1) são:

* **Aberto**: dentro do horário configurado.
* **Fechado**: fora do horário.

Se a verificação de horário estiver desligada nas configurações, o fluxo segue sempre por **Aberto**.

## Pagamento PIX

Envia uma cobrança Pix no WhatsApp, com a lista de itens, o total e o código para o cliente pagar sem sair da conversa.

**Antes de usar:** o código Pix de cada cobrança é gerado pelo seu banco ou intermediador de pagamento. Use um bloco de [Integração HTTP](https://help.wizebot.com.br/tutoriais/fluxos/blocos-integracoes.md) antes deste para pedir a cobrança e salvar o código num campo personalizado do contato.

![Painel do bloco Pagamento PIX com Código PIX, Chave PIX e Itens do pedido numerados](https://mintcdn.com/wizebot-d8529edc/npLQJVV8gD5vOhne/images/fluxo-blocos-avancados/08-pagamento-pix.png?fit=max\&auto=format\&n=npLQJVV8gD5vOhne\&q=85\&s=78f11dcaebb6b03142f25a962cb7fc97)

* **Código PIX** (1): o campo personalizado onde a integração salvou o código da cobrança.
* **Nome do titular**: o nome de quem recebe, como aparece para o cliente.
* **Tipo** e **Chave PIX** (2): o tipo da chave (**CPF**, **CNPJ**, **E-mail**, **Telefone** ou **Chave aleatória (EVP)**) e a chave que recebe o pagamento.
* **Mensagem**: o texto da cobrança. Aceita variáveis como `{{nome}}`.
* **Itens do pedido** (3): nome, valor e quantidade de cada item. Clique em **Item** para adicionar outro. O **Total** é calculado sozinho.
* **Configurações avançadas**: **Tipo de pedido** (**Bens digitais** ou **Bens físicos**), **ID de referência**, **Rodapé**, impostos, frete, desconto, **Programa de desconto** e **Expiração (seg)**, com mínimo de 300 segundos.

O fluxo envia a cobrança e segue pela saída na mesma hora. Ele não espera o pagamento ser feito. Se o campo do **Código PIX** estiver vazio, a cobrança não é enviada e o fluxo termina neste bloco.

## Conversão

Avisa a plataforma de anúncios (Meta, Google e outras) que o contato comprou, virou lead ou fez outra ação. Com isso os anúncios aprendem quem converte e você vê o resultado das campanhas.

**Antes de usar:** configure os destinos em **Configurações** > **Pixel**, na aba **Destinos de conversão**. A conversão só é enviada quando o contato chegou por um anúncio: clique rastreado pelo Pixel ou anúncio de clique para o WhatsApp. Para os outros contatos, o bloco não envia nada e o fluxo segue.

![Painel do bloco Conversão com Evento e Valor numerados](https://mintcdn.com/wizebot-d8529edc/npLQJVV8gD5vOhne/images/fluxo-blocos-avancados/09-conversao.png?fit=max\&auto=format\&n=npLQJVV8gD5vOhne\&q=85\&s=e4694897496280a1e6937b81f83b161a)

* **Evento** (1): **Compra (Purchase)**, **Lead**, **Registro completo**, **Início de checkout**, **Adicionou ao carrinho**, **Visualizou conteúdo**, **Assinatura** ou **Contato**.
* **Valor** (2): a moeda e o valor da conversão. Com **Usar variável** ligado, o valor vem de uma variável, como o total do pedido.
* **Identificador de pedido** (opcional): para eventos que se repetem, como Compra, separa uma venda da outra do mesmo cliente. Sem ele, cada vez que o fluxo passa pelo bloco conta como uma conversão.

O fluxo sempre segue pela saída.

## Agendar sequência

Esse bloco aparece só em fluxos antigos e não está mais no menu. Os blocos que já existem continuam funcionando e podem ser editados. Para fluxos novos, use o **Atraso inteligente**, explicado em [Blocos de lógica](https://help.wizebot.com.br/tutoriais/fluxos/blocos-logica.md).

## Problemas comuns

> [accordion] O agente não aparece na lista do bloco Agente de IA
>
> Só agentes ativos aparecem. Abra **Agents**, confira o agente e ative.

> [accordion] O modelo não aparece na lista do bloco Modelo do WhatsApp
>
> Só modelos aprovados pela Meta aparecem. Se ele ainda está em análise, espere a aprovação.

> [accordion] O bloco Formulário do WhatsApp mostra Não publicado ou Aguardando número
>
> Isso acontece quando o fluxo veio de uma cópia de outra empresa e o formulário ainda não foi publicado na sua conta. Até ele ser publicado, o bloco não envia o formulário.
>
> * **Aguardando número**: clique em **Escolher número** e escolha o número de WhatsApp do formulário no estúdio.
> * **Sem conteúdo**: o formulário veio sem telas. Clique em **Abrir formulário**, monte as telas no estúdio e depois escolha o número.
> * **Não publicado**: clique em **Abrir formulário** e publique.
> * **Excluído**: o formulário não existe mais. Clique em **Trocar** e escolha outro.

> [accordion] O fluxo que quero iniciar não aparece em Iniciar automação
>
> A lista mostra só fluxos ativos e esconde o fluxo que você está editando. Ative o fluxo de destino e abra o painel de novo.

> [accordion] A cobrança Pix não chegou ao cliente
>
> Confira se o bloco de Integração HTTP antes do Pagamento PIX salvou o código no campo escolhido em **Código PIX**. Sem o código, a cobrança não é enviada. Lembre também que a cobrança só funciona em conversas do WhatsApp.

## Precisa de ajuda?

Fale com o suporte da WizeBot pelo WhatsApp ou por e-mail.

> [card] [WhatsApp](https://wa.me/559192226534)
>
> Falar com o suporte

> [card] [E-mail](mailto:suporte@wizebot.com.br)
>
> Enviar um e-mail


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