Flow Builder

Visão Geral

O Flow Builder é a ferramenta de automação visual da Paralela. Com ele, você cria fluxos de conversa automatizados usando um editor de arrastar e soltar, sem precisar escrever código.

Com o Flow Builder, você pode:

• Automatizar respostas e saudações
• Direcionar clientes para filas ou atendentes
• Coletar informações do cliente com perguntas
• Criar menus interativos com opções
• Integrar com IA, webhooks e outros recursos

---

Acessando o Flow Builder

1. Abra Automações no menu lateral e use a aba Fluxos. Se o item não aparece, abra Configurações Avançadas e, em Itens Ocultos do Menu, clique em Automações para mostrá-lo no menu (ou procure "Fluxos" na lupa do topo).
2. A tela principal exibe a lista de todos os fluxos da empresa, organizada por categoria.
3. Use a busca e os filtros para localizar fluxos específicos.
4. Clique no nome do fluxo para abri-lo diretamente no editor.
5. Use o botão de ativar/desativar em cada linha para ligar ou desligar um fluxo sem precisar abri-lo.
6. Use a estrela para marcar fluxos como favoritos — eles aparecem no topo da categoria.
7. Use o menu de três pontos (⋮) de cada fluxo para ações secundárias:
   • Renomear
   • Abrir em nova aba
   • Versões
   • Mover para categoria
   • Duplicar
   • Excluir

---

Criando um Fluxo

1. Na tela de fluxos, clique no botão de menu (três pontos) no canto superior direito.
2. Selecione Novo Fluxo.
3. Preencha o nome do fluxo.
4. Após criar, clique no nome do novo fluxo para abrir o editor visual (canvas).

Você também pode criar fluxos a partir de templates ou importar um fluxo em formato JSON.

---

O Canvas (Editor Visual)

O canvas é o editor onde você monta o fluxo visualmente.

Como funciona

• Cada elemento do fluxo é representado por um nó (bloco).
• Você conecta os nós com linhas que definem o caminho da conversa.
• O nó de Início é o ponto de entrada do fluxo. Todo fluxo começa por ele.
• Clique no botão + (flutuante no canto inferior esquerdo) para abrir o seletor de ações.
• Arraste os nós para organizar o layout.
• Clique duas vezes em um nó para editar suas configurações.

Seletor de Ações

O seletor exibe todas as ações disponíveis agrupadas por categoria, com nome e descrição visíveis:

Categoria	Ações
Conteúdo	Conteúdo, Pergunta
Navegação	Menu, Randomizador, Condição
Ações	Ação, Ação Condicionada, Notificação WhatsApp, Ativar IA
Controle de Fluxo	Intervalo, Espera, Encerrar

Use o campo de busca no topo do seletor para filtrar ações por nome ou descrição.

Atalhos de Teclado

Atalho	Ação
Ctrl + S	Salvar fluxo
Ctrl + K	Abrir seletor de ações
Delete / Backspace	Remover nó ou conexão selecionada
Shift + clique	Seleção múltipla

Tipos de Nós

Nó	Descrição
Início	Ponto de entrada do fluxo. Todo fluxo tem exatamente um.
Conteúdo	Envia uma ou mais mensagens ao cliente (texto, imagem, áudio, vídeo, documento).
Menu	Apresenta opções numeradas para o cliente escolher.
Pergunta	Faz uma pergunta e armazena a resposta em uma variável.
Condição	Avalia uma ou mais condições e direciona o fluxo por caminhos diferentes (ver seção detalhada abaixo).
Ação Condicionada	Executa uma ação somente se determinada condição for atendida.
Ação	Realiza operações como transferir fila, adicionar ou remover tag, chamar webhook, atualizar ticket, inserir pedido, gerar link de pagamento e alterar o status do pedido ou do agendamento.
Intervalo	Adiciona um tempo de espera entre etapas, de segundos a 365 dias, com hora de envio opcional (ver Automações de pedido).
Espera	Pausa o fluxo até que o cliente responda ou um tempo limite seja atingido.
Randomizador	Distribui o fluxo aleatoriamente entre caminhos diferentes (útil para testes A/B).
Notificação WhatsApp	Envia uma notificação via WhatsApp para um número digitado ou para uma variável, como o número que recebe os pedidos (ver Automações de pedido).
Enviar Template Oficial	Dispara um template aprovado da API Oficial do WhatsApp, permitindo enviar mensagens fora da janela de 24h (ideal para campanhas). Ver seção detalhada abaixo.
Ativar IA	Ativa um assistente de IA (prompt) para responder ao cliente.
Encerrar	Finaliza o fluxo.

Controles do Canvas

• Minimapa: visão geral do fluxo no canto inferior.
• Zoom: use os controles ou a roda do mouse para aproximar e afastar.
• Arrastar: clique e arraste o fundo para mover a área visível.
• Salvar: o fluxo é salvo automaticamente alguns segundos após qualquer alteração. Um indicador ao lado do botão "Salvar Fluxo" mostra o status (Salvando, Salvo, Erro). Você também pode salvar manualmente clicando no botão.

---

Nó de Conteúdo

O nó de Conteúdo permite enviar múltiplas mensagens e mídias em sequência. Ao editar o nó, você pode adicionar os seguintes tipos de conteúdo:

Tipo	Descrição
Mensagem	Texto simples com suporte a variáveis.
Imagem	Arquivos PNG, JPG, JPEG e similares.
Áudio	Arquivos MP3, OGG, OPUS e similares.
Vídeo	Arquivos MP4, AVI e similares.
Documento	Qualquer tipo de arquivo (PDF, DOCX, XLSX, CSV, TXT etc.), exceto executáveis e scripts, por questões de segurança.
Intervalo	Pausa entre envios (em segundos).

Cada tipo de mídia possui seu próprio botão de upload. Arquivos de imagem, áudio e vídeo devem ser enviados pelos respectivos botões — o botão de Documento aceita apenas arquivos que não sejam mídia.

O tamanho máximo por arquivo é de 100MB.

Legenda da mídia

Imagem, vídeo e documento possuem um campo Legenda (opcional). O texto preenchido vai junto com o arquivo na mesma mensagem do WhatsApp (caption), em vez de uma mensagem de texto separada. Deixe em branco para enviar só o arquivo. Áudio não tem legenda, pois o WhatsApp não exibe caption em áudios.

Variáveis nas mensagens

Abaixo de cada campo de mensagem existe um seletor de variáveis. Clique em uma variável para inseri-la no texto — no envio, ela é substituída pelo valor real daquele contato.

Além das variáveis de sistema (nome, número, e-mail, protocolo etc.) e das variáveis salvas em nós anteriores, todos os campos customizados da empresa aparecem como variáveis. Isso permite que o conteúdo enviado varie por contato conforme o valor preenchido no campo.

• O rótulo do chip é o nome do campo (ex.: Link do Cliente); o texto inserido é a chave normalizada (ex.: {{link_do_cliente}}).
• Os campos são carregados automaticamente a partir de Configurações > Campos Customizados (apenas campos ativos).
• Se o contato não tiver valor naquele campo, a variável fica vazia.

Exemplo (campanha com link por contato): cadastre um campo customizado Link Promo, preencha-o em cada contato com a URL específica e use {{link_promo}} na mensagem do nó de Conteúdo. No disparo da campanha, cada contato recebe o seu próprio link.

---

Enviar Template Oficial

O nó Enviar Template Oficial permite disparar um template aprovado pelo WhatsApp Business diretamente de dentro de um fluxo. É o caminho recomendado para enviar mensagens fora da janela de 24h (regra da API Oficial), especialmente em campanhas automatizadas.

Quando usar

• Campanhas em massa via API Oficial: associe um fluxo a uma campanha; o nó envia o template para cada contato sem intervenção manual.
• Reativação de leads frios: contatar quem não interage há mais de 24h.
• Notificações transacionais: confirmações de pedido, lembretes de agendamento, atualizações de status.

Pré-requisitos

• A conexão usada pelo ticket precisa ser do tipo API Oficial. Conexões por QR Code (WhatsApp Web) não suportam templates.
• O template precisa estar APROVADO pela Meta (status APPROVED) e ativo.
• Sincronize seus templates antes de usar: página Templates de WhatsApp > botão Sincronizar.

Configurando o nó

1. Adicione o nó Enviar Template Oficial ao canvas (categoria Ações).
2. Selecione a conexão (apenas conexões da API Oficial são listadas) — usada para listar os templates disponíveis.
3. Escolha o template desejado. A pré-visualização mostra cabeçalho, corpo, rodapé e botões.
4. Para cada parâmetro detectado ({{1}}, {{2}} etc.), defina:
   • Texto literal: um valor fixo (ex.: "Black Friday").
   • Variável do fluxo: usa o valor da variável daquele ticket (ex.: contact_name, ou variáveis salvas em nós anteriores).
5. Salve o nó e conecte as duas saídas:
   • Saída superior (sucesso): caminho seguido quando o template é aceito pela API.
   • Saída inferior (falha): caminho seguido quando o envio falha (template rejeitado, contato sem opt-in, limite de envio, conexão não oficial etc.).

Template pelo nome

Um nó guarda o id do template e também o nome e o idioma. Se o id é de um template de outra conexão, ou se o nó só tem o nome (como nos fluxos prontos da plataforma, criados sem conexão), o sistema procura na conexão do ticket o template aprovado com aquele nome e idioma. Isso permite copiar o mesmo fluxo entre conexões, desde que o template exista com o mesmo nome em cada uma. Em conexão QR o nó não envia nada e segue pela saída de falha.

Substituição de variáveis

• Os parâmetros também leem as variáveis do evento que iniciou o fluxo (por exemplo {{tenant.name}} em um gatilho de plataforma).
• Variáveis do contato (nome, número etc.) e variáveis salvas durante o fluxo podem ser usadas em qualquer parâmetro do template.
• A substituição funciona do mesmo jeito que nas demais mensagens do fluxo.
• Se a variável não existir, o parâmetro fica vazio — recomenda-se sempre testar no simulador antes de ativar.

Tratamento de falhas

Templates podem falhar por vários motivos:

• A conexão do ticket não é API Oficial.
• Template inativo, rejeitado ou pausado pela Meta.
• Contato deu opt-out (bloqueio de 24h / política comercial).
• Limite de envio ou janela diária atingida.
• Erro na API do WhatsApp.

Use o ramo de falha para registrar o ocorrido (webhook), enviar notificação ao atendente ou cair em uma mensagem alternativa por um canal não oficial.

Limitações

• Componentes de cabeçalho com mídia (imagem/vídeo/documento) ainda recebem apenas o tipo text. Para mídia dinâmica, use webhooks que retornem URLs e configure no próprio template.
• Botões do tipo URL ou Phone não requerem parâmetros via fluxo (já são definidos no template). Apenas botões QUICK_REPLY aceitam payload do fluxo.

---

Categorias de Fluxos

Organize seus fluxos em categorias para facilitar a gestão.

• Acesse o gerenciador de categorias pelo ícone de pastas no topo da tela de fluxos.
• Crie categorias com nome, cor e ícone.
• Crie subcategorias (categorias filhas) para hierarquias mais detalhadas.
• Mova fluxos entre categorias.
• Reordene categorias conforme sua preferência.

Fluxos sem categoria aparecem em uma seção separada.

---

Templates de Fluxo

Templates são modelos prontos que facilitam a criação de novos fluxos.

Usando templates

1. Na tela de fluxos, clique em Novo fluxo. A janela mostra o fluxo em branco e os templates.
2. Filtre por categoria ou busque pelo nome. Meus templates mostra só os da sua empresa.
3. Clique em um template para criar um novo fluxo baseado nele. O fluxo nasce desativado.

Templates marcados com Todas as empresas foram publicados pela equipe da plataforma e aparecem para todo mundo, junto com os Oficiais.

Templates prontos de pedido

Na categoria Pedidos, todas as empresas encontram, sem depender de segmento ou preset:

Template	Quando dispara	O que faz
Aviso de novo pedido (para você)	Novo pedido	Avisa no número que recebe os pedidos.
Andamento do pedido (para o cliente)	Status de entrega alterado	Avisa o cliente a cada etapa (aparece como um cartão só).
Lembrete de recompra (para o cliente)	Novo pedido	Espera 30 dias, até as 10h, e chama o cliente para pedir de novo. Um pedido novo durante a espera cancela o lembrete antigo.
Pesquisa pós-entrega (para o cliente)	Status de entrega: entregue	Pede uma nota de 1 a 5.
Confirmação de pagamento (para o cliente)	Pagamento recebido	Confirma que o pagamento foi recebido.

Todos rodam sem abrir conversa e podem ter a mensagem e o prazo editados depois de criados. Para limitar a recompra a um tipo de produto, coloque um bloco Condição com a variável order.categories_text antes do Intervalo.

Criando seus próprios templates

1. Dentro do editor de um fluxo, abra o menu e clique em Salvar como template.
2. Preencha nome, descrição e categoria. Complexidade e tags ficam em Mais opções.
3. O template fica disponível só para a sua empresa.

Editando e excluindo templates

Na janela Novo fluxo, cada template que você pode gerenciar tem um menu (três pontos) no canto do cartão:

• Editar informações: muda nome, descrição, categoria e, se for o caso, para quem aparece.
• Excluir template: pede confirmação. O template some da lista, mas os fluxos que já foram criados com ele não mudam.

Os templates Oficiais (como os de pedido) vêm da plataforma e não têm menu: não podem ser editados nem excluídos.

Templates para todas as empresas (super admin)

Quem é super admin escolhe, ao salvar ou editar um template, Quem pode usar:

• Só a minha empresa: padrão.
• Todas as empresas: o template aparece na lista de todas as empresas, com o selo Todas as empresas. Apenas super admins publicam assim.

O super admin também edita e exclui os templates de qualquer empresa pelo mesmo menu. Para tirar um template do ar sem apagar, edite-o e volte para Só a minha empresa.

Também só o super admin vê a opção Somente super: o template fica na aba Super da janela de templates e nunca aparece, nem pode ser usado, por outras empresas.

---

Versionamento

O Flow Builder mantém um histórico de versões de cada fluxo.

Ação	Como fazer
Ver histórico	No menu de ações do fluxo, clique em Histórico de Versões.
Restaurar versão	Selecione uma versão anterior e clique em restaurar.
Comparar versões	Visualize as diferenças entre versões para entender o que mudou.

A Paralela guarda versões sozinha: depois de uma alteração no fluxo (salva pelo editor ou pelo Copilot), ela registra uma versão Automática, no máximo uma a cada 10 minutos e só se o conteúdo mudou. São mantidas as 50 automáticas mais recentes de cada fluxo. Para marcar um momento importante, use Salvar Versão Atual: versões manuais ficam em destaque, nunca são apagadas, e o filtro Só manuais esconde as demais.

Ao restaurar uma versão, o estado de antes fica guardado em uma versão Antes de restaurar, então a restauração pode ser desfeita restaurando essa versão.

---

Execuções do Fluxo

Cada vez que um fluxo roda para um contato, a Paralela registra a execução: quando começou, o que a iniciou, em qual etapa parou e como terminou. As execuções passam a ser registradas a partir da atualização que traz este recurso; conversas que já estavam em andamento antes dela não entram no histórico.

Onde ver

Onde	Como abrir
Editor do fluxo	No menu de ações (três pontos), clique em Ver execuções. Ao clicar em uma execução, a etapa onde ela parou fica selecionada no canvas.
Visão geral das automações	Clique em um fluxo para abrir o painel lateral e depois em Ver execuções.

O painel mostra, para 7, 30 ou 90 dias, o total de execuções, a taxa de conclusão, a duração média e quantas foram abandonadas. Você pode filtrar pelo desfecho.

Desfechos

Desfecho	Significado
Concluída	O fluxo chegou ao fim ou passou a conversa para a IA.
Aguardando o contato	O fluxo pausou em um menu, pergunta ou intervalo e espera a resposta.
Abandonada	O fluxo ficou aguardando o contato por mais de 24 horas sem resposta.
Interrompida	A conversa foi encerrada, o ticket excluído, o contato pediu para parar ou um nó de Parar fluxo foi acionado.
Falhou	Houve erro, uma etapa não foi encontrada ou o fluxo excedeu o limite de etapas.
Substituída	Uma nova execução começou para o mesmo atendimento.

Relatórios e widgets

A fonte de dados Fluxos (execuções) está disponível nos relatórios personalizados e nos widgets do Dashboard. Agrupe por fluxo, categoria, origem, desfecho, motivo do encerramento, tipo de etapa onde parou, conexão, hora ou dia da semana. Veja Relatórios.

---

Disparos por Frase

A tela Disparos por Frase reúne, num só lugar, todos os gatilhos por frase da empresa, de todos os fluxos. Um gatilho por frase inicia (ou para) um fluxo quando uma mensagem corresponde à frase configurada. Veja como cada gatilho funciona em Gatilhos por frase.

• Abra Disparos por Frase no menu lateral (leva à aba Gatilhos da tela Automações, no tipo Por frase). Se o item não aparece, abra Configurações Avançadas e, em Itens Ocultos do Menu, clique em Disparos por Frase para mostrá-lo no menu (ou procure "Frases" na lupa do topo).
• Cada linha mostra o nome do gatilho, o que ele faz (Disparar um fluxo ou Parar fluxo), quem dispara (Usuário, Atendente ou Ambos) e se está Ativo ou Inativo.
• Clique em Novo gatilho para criar um. No menu de cada linha você pode Abrir no fluxo, Editar ou Excluir.

---

Criar fluxo com IA (antes Flow Copilot)

O Criar fluxo com IA é um assistente de inteligência artificial que ajuda a criar e modificar fluxos.

Como usar

1. Clique em Criar fluxo com IA na tela dedicada ou no painel dentro do editor de fluxo.
2. Descreva em linguagem natural o que você precisa. Exemplos:
   • "Crie um fluxo de boas-vindas com uma mensagem e encerramento."
   • "Crie um fluxo com menu de 3 opções: Vendas, Suporte e Financeiro."
   • "Liste todos os meus fluxos disponíveis."
3. O assistente gera a estrutura do fluxo automaticamente.
4. Você pode refinar o resultado conversando com o assistente.

O assistente também pode criar recursos auxiliares como filas e tags.

---

Campanhas de Fluxo

Fluxos podem ser usados como base para campanhas de envio em massa.

• Crie uma campanha e associe um fluxo existente.
• Selecione o grupo de contatos que receberá a campanha.
• Agende o envio para uma data e horário específicos.
• Acompanhe os resultados da campanha após o envio.

Cada contato da campanha passará pelo fluxo de forma individual, como se fosse uma conversa normal.

---

Gatilhos do Fluxo

Todo fluxo pode ser iniciado automaticamente por gatilhos. Eles são gerenciados dentro do próprio fluxo, sem precisar navegar por outras telas.

Onde configurar

1. Abra o fluxo no editor.
2. No nó de Início, clique no ícone de engrenagem (⚙️).
3. A janela Gatilhos do Fluxo abre com três abas:
   • Por evento — dispara o fluxo a partir de eventos do sistema (nova conversa, cliente sem resposta, tag adicionada, novo pedido, mudança de etapa no Kanban, webhook de entrada etc.). Cada gatilho exige uma conexão WhatsApp, exceto os gatilhos de pedido marcados para rodar sem conversa (ver Automações de pedido).
   • Por frase — dispara o fluxo quando uma mensagem corresponde a uma frase configurada.
   • Padrão da conexão — define este fluxo como Boas-vindas e/ou Fluxo padrão de cada conexão (veja abaixo). Não é um gatilho no sentido estrito: é um vínculo configurado na própria conexão, agora acessível de dentro do fluxo.

Gatilhos por frase

Na aba Por frase você configura tudo sem sair do fluxo:

• Frase de gatilho — o texto a ser detectado.
• Regra — como a frase é comparada: Semelhante, Exatamente igual, Contém a frase, Contém algum (multivalor), Não contém, entre outras.
• Conexão WhatsApp — em qual conexão o gatilho vale.
• Quem dispara — Usuário, Atendente ou Ambos.
• Nome (opcional) — uma etiqueta para identificar o gatilho; quando vazio, usamos a própria frase.
• Disparar a qualquer momento — por padrão, um gatilho por frase só dispara quando o ticket está pendente (sem atendente humano e sem IA atendendo). Ative esta opção para que a frase dispare o fluxo mesmo durante um atendimento humano ou por IA.
  • Parar a IA ao disparar o fluxo — aparece quando "a qualquer momento" está ligado. Ligada (padrão), a IA em atendimento é interrompida antes de o fluxo começar, evitando que IA e fluxo respondam ao cliente ao mesmo tempo. Desligada, a IA continua ativa em paralelo ao fluxo.

Cada gatilho pode ser ativado/desativado, editado ou removido ali mesmo. Ao salvar, o fluxo já passa a responder àquela frase.

Sempre que um gatilho por frase inicia um fluxo, um registro interno é adicionado ao ticket — por exemplo: Gatilho por frase "Teste_Gatilho" disparou o fluxo "Teste_Fluxo" — visível no histórico da conversa, junto aos demais eventos do atendimento.

Prospecção — comportamento do contato

Na aba Por evento, a categoria Prospecção traz o gatilho Prospecção — comportamento do contato (no seletor aparece como Comportamento na prospecção). Ele inicia o fluxo para quem recebeu uma prospecção e fez (ou deixou de fazer) alguma coisa depois do disparo, como lembrar quem não respondeu ou agradecer quem fechou. Não há lista para montar: o sistema confere as prospecções a cada 5 minutos e inicia o fluxo para cada contato que se encaixa.

Campos do gatilho:

• Comportamento — o que o contato fez:

Comportamento	Quem entra	O prazo conta a partir de
Não respondeu	Recebeu a mensagem e não respondeu	Do disparo
Respondeu	Respondeu, menos quem pediu para não receber mais	Da resposta
Demonstrou interesse	Respondeu e a IA entendeu que a pessoa tem interesse	Da resposta
Fechou	Fez um pedido concluído depois do disparo	Do pedido concluído
Não fechou	Ainda não tem pedido concluído depois do disparo	Do disparo

• Dias de espera — de 0 a 90. Só dispara depois desse número de dias contados a partir do evento da tabela acima. Com 0, o fluxo inicia assim que o comportamento é detectado. Exemplo: Não respondeu com 3 dias manda o lembrete a quem ficou 3 dias sem responder.
• Prospecção — qual prospecção vale. Escolha uma: o gatilho só inicia fluxos para os contatos da prospecção escolhida, e um gatilho sem prospecção não inicia nenhum fluxo.

O comportamento vale para o último disparo do contato dentro da prospecção. Se ele receber uma nova rodada de uma prospecção recorrente, o disparo novo passa a ser o que conta e o gatilho pode iniciar o fluxo de novo, uma vez por disparo. Quem pediu para não receber mensagens (opt-out) e quem teve o envio com falha nunca entram.

Como o fluxo roda:

• Ele inicia numa conversa com o contato, pela conexão escolhida no gatilho. Se a conexão da prospecção for outra, o contato é pulado.
• Só inicia dentro do horário de funcionamento da conexão (ou da empresa); fora dele, a próxima varredura tenta de novo. Sem horário configurado, vale das 9h às 20h.
• Cada contato recebe o fluxo uma vez por disparo, mesmo que a varredura rode várias vezes. Cada varredura inicia no máximo 200 fluxos por gatilho; o resto fica para a seguinte.
• Variáveis extras no fluxo, além das do contato: {{prospection_name}} (nome da prospecção) e {{prospection_behavior}} (o comportamento que disparou: no_reply, replied, interested, closed_won ou not_closed).

Regras criadas na tela de Prospecção

As regras "Quando... então..." criadas na tela Prospecção (e nas buscas de leads recorrentes) também são gatilhos deste tipo: elas aparecem aqui, marcadas como Criado pela regra de uma prospecção, e são somente leitura. Para mudar ou remover, edite a regra na própria prospecção. Quando a ação da regra é "enviar mensagem", o sistema cria sozinho um fluxo de um bloco de mensagem, na categoria Prospecção, e o apaga junto com a regra. Já numa regra que executa um fluxo seu, o fluxo nunca é apagado.

Atendimento para revisar

O gatilho Atendimento para revisar inicia o fluxo uma vez a cada ticket que a nota automática de qualidade marcar para revisão. O fluxo roda sem abrir conversa com o cliente: serve para avisar o gestor, não para falar com quem foi atendido. Se o ticket for reaberto, fechado de novo e marcado outra vez, o fluxo roda de novo.

Variáveis disponíveis nos blocos:

Variável	O que traz
{{quality.score}}	Nota de 0 a 100
{{quality.verdict}}	Bom, Pode melhorar ou Problemático
{{quality.reasons}}	Motivos, por extenso e separados por vírgula
{{quality.agentName}}	Nome do atendente ou do assistente de I.A.
{{quality.agentKind}}	Humano ou IA
{{quality.contactName}}	Nome do cliente
{{quality.ticketLink}}	Link para abrir o ticket
{{quality.evaluatedAt}}	Data e hora da avaliação
{{ticketId}}, {{contactId}}	Ids do ticket e do contato

O jeito mais rápido é usar o modelo pronto Aviso de atendimento para revisar, em Modelos de fluxo: ele já vem com o gatilho e um bloco de notificação com nota, motivos, quem atendeu, cliente e link. Ao usar o modelo, informe o número do gestor (ou o id de um grupo) que vai receber o aviso; sem isso, preencha o número no bloco de notificação antes de ativar. Número de grupo só funciona em conexão QR.

Fluxo padrão da conexão (Boas-vindas / Padrão)

Além dos gatilhos, cada conexão WhatsApp pode ter um fluxo executado automaticamente em duas situações:

• Boas-vindas — executado quando um contato novo inicia uma conversa (saudação).
• Fluxo padrão — executado quando a mensagem não corresponde a nenhum gatilho por frase.

Na aba Padrão da conexão, cada conexão aparece com dois interruptores (Boas-vindas e Fluxo padrão). Ligue um interruptor para usar este fluxo naquela função; desligue para remover o vínculo. Se a conexão já usava outro fluxo naquela função, o sistema avisa qual fluxo será substituído. Cada conexão usa apenas um fluxo por função.

Essa mesma configuração continua disponível na tela de Conexões (edição da conexão) — agora ela também pode ser feita de dentro do fluxo.

Indicadores visuais

• No editor: o nó de Início exibe chips com tudo que inicia aquele fluxo — gatilhos por evento, por frase (ex.: "quero orcamento") e os vínculos de conexão (Boas-vindas / Fluxo padrão, com o nome da conexão). Assim você sabe, de relance, como aquele fluxo é acionado.
• Na lista de fluxos: fluxos usados por gatilhos por frase mostram um selo com a quantidade. Clique no selo para abrir o fluxo direto na aba Por frase.

Visão geral (aba "Gatilhos por Frase")

A aba Gatilhos por Frase (na tela de Fluxos) continua disponível como uma visão consolidada de todos os gatilhos por frase da empresa. Cada item mostra o fluxo vinculado e oferece a ação Abrir no fluxo, que leva direto ao editor com a aba de gatilhos por frase aberta.

Gatilhos de plataforma (cobrança e ciclo de vida dos clientes)

Disponível apenas para a empresa administradora da plataforma (por exemplo, a de um licenciado white label). As demais empresas não veem esta categoria.

Na aba Por evento, a categoria Plataforma (clientes) traz gatilhos sobre as empresas clientes da plataforma. O evento acontece na empresa cliente, mas o fluxo roda na empresa administradora, numa conversa com o telefone cadastrado da empresa cliente, pela conexão escolhida no gatilho. Por ser uma conversa de verdade, todos os blocos funcionam (mensagem, menu, pergunta, IA, template oficial) e as respostas do cliente caem na caixa de entrada.

Gatilho	Quando dispara
Nova empresa cadastrada	Uma empresa se cadastra (pelo site ou pelo painel). No máximo uma vez por telefone a cada 24h, e no máximo 40 por hora, para que um ataque ao cadastro não use o seu número para mandar mensagens a desconhecidos. Esses tetos valem só para os fluxos que abrem conversa com o cliente; um fluxo por evento (aviso à equipe) tem um teto próprio de 300 por hora, que não depende do telefone do cliente. A boas-vindas e o aviso das Configurações têm contadores à parte. É o único gatilho de plataforma que pode rodar por evento, sem abrir conversa.
Vencimento de fatura (D-N, D0, D+N)	Uma vez por dia, a partir das 9h no fuso da empresa, para cada fatura em aberto que está num dos dias escolhidos em relação ao vencimento.
Fatura de cliente paga	Uma fatura de cliente é paga, pelo gateway ou marcada como paga no Financeiro.
Empresa cliente bloqueada	O sistema bloqueia uma empresa por plano ou fatura avulsa vencidos.
Acompanhamento do teste	Uma vez por dia, dentro do horário de funcionamento, para cada empresa ativa que nunca pagou e que está num dos dias escolhidos desde o cadastro.
Teste vencido sem pagar	Uma vez por dia, para cada empresa que nunca pagou e está num dos dias escolhidos depois do fim do teste. Inclui empresas já bloqueadas.
Cliente perdido	Uma vez por dia, para cada cliente que já pagou alguma fatura, hoje está bloqueado e está num dos dias escolhidos depois da perda.

Régua de cobrança com o gatilho de vencimento

Ao escolher Vencimento de fatura, marque os dias da régua. Negativo é antes do vencimento, D0 é o próprio dia e positivo é depois. O padrão já vem com D-3, D0 e D+3; outros dias podem ser adicionados no campo Outro dia (de -60 a +90).

• Fatura paga antes do dia não dispara. Fatura de empresa marcada como interna (teste, demo, cortesia) também não.
• Cada fatura dispara uma vez por dia da régua.
• Para mensagens diferentes em cada etapa, há dois caminhos: um fluxo por etapa (cada um com o seu dia) ou um fluxo só, com um Nó de Condição sobre a variável daysFromDue.

Marcar o cliente como pago

Para que a IA e os follow-ups da empresa administradora parem de vender ou cobrar quem já pagou, use o gatilho Fatura de cliente paga com dois blocos de Ação:

1. Adicionar tag com a tag de cliente pago (por exemplo, pago).
2. Remover tag com as tags de funil que deixam de valer (por exemplo, trial e em teste).

As tags são aplicadas ao contato da empresa administradora criado a partir do telefone da empresa cliente, mesmo que ela nunca tenha conversado antes: o contato é criado quando o fluxo dispara. Pagar duas vezes não duplica a tag, e remover uma tag que o contato não tem não gera erro. Depois disso, use o bloco Condição com Contato possui tag para desviar quem já pagou das mensagens de cobrança.

Funil de vendas automático (teste, teste vencido e cliente perdido)

Três gatilhos permitem montar uma sequência de vendas sem lista de disparo: Acompanhamento do teste, Teste vencido sem pagar e Cliente perdido. Cada um tem uma lista de dias, no mesmo campo da régua de cobrança.

Gatilho	Dias contados a partir de	Quem entra
Acompanhamento do teste	Cadastro da empresa, no fuso da empresa administradora (de 1 a 90)	Empresa ativa que nunca pagou. Cobre também planos de valor zero, que não geram fatura.
Teste vencido sem pagar	Fim do teste: vencimento da primeira fatura do plano; sem fatura, cadastro mais os dias de teste do plano (de 0 a 90)	Empresa que nunca pagou, mesmo bloqueada.
Cliente perdido	Perda do cliente (de 0 a 90)	Empresa bloqueada que já pagou alguma fatura.

Como funciona:

• Parou de pagar, parou de receber. "Nunca pagou" (e, no cliente perdido, "está bloqueado") é conferido de novo a cada varredura horária. Quem paga sai da sequência sozinho, sem depender de tag. Faturas de recarga de créditos de IA não contam como pagamento.
• Repetição. Não há agendador à parte: a repetição é a lista de dias. No campo de dias, A cada X dias até o dia Y gera a lista (por exemplo, a cada 3 dias até 30: 3, 6, 9... 30) e você ainda pode ajustar dia a dia.
• Horário. O fluxo só inicia dentro do horário de funcionamento da conexão escolhida no gatilho (ou, se ela não tiver, o da empresa administradora). Fora dele, a próxima varredura horária dentro da janela envia. Sem nenhum horário configurado, vale das 9h às 20h.
• Conexão. Cada gatilho envia pela conexão escolhida, QR ou API Oficial, e ela pode ser trocada depois pelo botão de dias. Na API Oficial, quem não falou com você nas últimas 24h só recebe template aprovado: comece o fluxo com Enviar Template Oficial.
• Quem pediu para não receber mensagens (opt-out) é pulado. Os gatilhos de cobrança e de fatura paga não fazem essa checagem, por serem avisos da conta.
• Limite por varredura. No máximo 30 fluxos são iniciados por hora, somando os três gatilhos; o resto fica para a hora seguinte, desde que ainda seja o mesmo dia da lista. Ao ligar um gatilho pela primeira vez, só entra quem está num dos dias de hoje e foi criado depois da data de entrada em operação (veja as travas abaixo): não há envio retroativo.
• Cada empresa recebe uma vez por dia da lista.
• Data da perda. O sistema não registra o dia em que uma empresa foi bloqueada. O dia da perda é o vencimento da fatura em aberto mais antiga; sem fatura em aberto, o vencimento do plano e, por último, a data de cancelamento. Se essa fatura for cancelada ou trocada, a contagem muda.

Para decidir o que enviar em cada etapa, use o bloco Condição (por exemplo, sobre daysSinceSignup, daysFromDue ou daysSinceLost) e as tags do contato.

Travas de segurança do funil (proteção contra spam de base antiga)

Os três gatilhos de funil vêm desligados por padrão e só disparam depois que o super admin liga as travas nas configurações da empresa administradora:

• Interruptor geral do funil. Enquanto estiver desligado, nenhuma mensagem de funil sai.
• Data de entrada em operação. Cadastro e Teste vencido só olham empresas criadas a partir dessa data; Cliente perdido só olha quem teve a perda a partir dela e cujo cadastro foi atualizado depois dela. Quem foi bloqueado antes não entra automaticamente, e quem se cadastra depois percorre o funil inteiro. Sem data válida, nada dispara.
• Limite de mensagens por empresa. Teto de mensagens de funil (os três gatilhos mais a boas-vindas) que uma empresa recebe ao todo. Quem atingiu o limite nunca mais recebe.
• Teto diário. Máximo de mensagens frias do funil, somando os três gatilhos, em 24 horas. O teto de 30 por varredura continua valendo.
• Pausa por excesso de opt-out. Se muitas pessoas já contatadas pelo funil pedirem para não receber mensagens em 24 horas, o funil pausa sozinho e retoma quando a contagem volta ao limite. Enquanto isso, revise o fluxo, o texto e a base.
• Uma mensagem por empresa a cada 24h. Se uma empresa cai em dois gatilhos no mesmo dia, ou acabou de receber a boas-vindas, a segunda espera a varredura seguinte do mesmo dia da lista; se o dia da lista passar, essa etapa não é enviada.

Ao desligar o interruptor geral, aguarde cerca de 1 minuto antes de considerar o funil parado. A boas-vindas ao novo cadastro é transacional e não depende dessas travas: com o funil desligado, ela continua funcionando, mas conta para o limite por empresa e para a regra de uma mensagem por 24h.

Antes de ligar, confira a lista de quem receberia mensagem hoje (sem enviar nada) e só ligue se ela tiver apenas quem você espera.

Fluxo para o novo cadastro (opcional)

A boas-vindas e o aviso de novo cadastro para a equipe não dependem de fluxo: são configurados em Configurações > Sistema da empresa administradora, com conexão, mensagem ou template (veja Boas-vindas e aviso de novo cadastro). Nenhum fluxo é criado automaticamente, porque nem todo licenciado tem a API oficial do WhatsApp.

Quem quiser ir além (marcar o contato com uma tag, ativar um assistente, avisar por outro caminho) monta o próprio fluxo no gatilho Nova empresa cadastrada. A galeria de templates (aba só do super) traz dois modelos prontos, que você usa se quiser:

Modelo	O que faz	Modo
Boas-vindas ao novo cadastro	Manda as boas-vindas ao telefone cadastrado, marca o contato com a tag trial e ativa um assistente de vendas	Conversa
Alerta de novo cadastro para a equipe	Avisa a equipe por WhatsApp (um bloco Notificação por pessoa)	Por evento (não abre conversa com o cliente)

Usar o modelo é opcional. Ele nasce desligado: escolha a conexão e ligue o gatilho. Se você usar o modelo e deixar a configuração da empresa administradora ligada, o cliente recebe as duas mensagens; isso é escolha sua. O gatilho de nova empresa é o único de plataforma que roda por evento, sem abrir conversa.

Os fluxos desse gatilho leem as variáveis {{signup.*}} (company, companyId, userName, email, phone, plan, affiliate, origin, date), as mesmas das Configurações, sempre em uma linha só, com no máximo 80 caracteres e nunca vazias. Os tetos do gatilho são próprios: no máximo uma vez por telefone a cada 24h e 40 por hora nos fluxos que abrem conversa, e 300 por hora no fluxo por evento; eles contam em contadores separados dos tetos das Configurações.

Fluxos prontos do funil (só para o super)

O super encontra na galeria de templates, na aba exclusiva de super usuários, fluxos oficiais para a empresa administradora: boas-vindas ao cadastro, aviso de novo cadastro para a equipe, acompanhamento do teste, teste vencido, cliente perdido, régua de cobrança e marcação de cliente pago. Template não carrega ids da empresa: os blocos citam tags e assistentes pelo nome, e ao usar o template o sistema procura, na empresa, a tag com aquele nome (cria trial e pago se faltarem; em teste só é removida se existir) e o assistente indicado. Se o assistente não existir, o fluxo é criado desligado, com o aviso "Pendente de configuração" na descrição. Os gatilhos também nascem desligados: escolha a conexão que envia no gatilho e ligue-o. Em conexão da API Oficial, troque os blocos de mensagem por Enviar Template Oficial com um template aprovado na Meta, ou a primeira mensagem fora das 24h não será entregue (os modelos de boas-vindas e de aviso à equipe já vêm com o template configurado).

Os fluxos de venda fria (acompanhamento, teste vencido e cliente perdido) começam com um bloco Condição que encerra sem mensagem quem tem uma tag de parada (como nao-agora, numero-errado ou sem-interesse) ou já tem um ticket aberto. As tags são só lidas: se não existirem na empresa, o bloco as ignora. O texto do primeiro contato é sempre fixo; o assistente só é ativado se a pessoa responder.

Variáveis disponíveis

Variável	Conteúdo
{{tenant.name}}, {{tenant.email}}, {{tenant.phone}}, {{tenant.document}}	Dados cadastrais da empresa cliente
{{signup.company}}, {{signup.userName}}, {{signup.plan}}, {{signup.affiliate}}, {{signup.origin}}, {{signup.date}}	Só no gatilho de nova empresa: dados do cadastro, já em uma linha só (veja acima)
{{daysSinceSignup}}, {{trialEndsAt}}, {{trialDaysLeft}}, {{paymentLink}}	Funil de teste: dias desde o cadastro, fim do teste (DD/MM/AAAA), dias que faltam e link da fatura em aberto (vazio se não houver)
{{daysSinceLost}}, {{lastPaidAt}}, {{lastPlanName}}	Cliente perdido: dias desde a perda, data do último pagamento e plano pago
{{tenant.planName}}, {{tenant.dueDate}}, {{tenant.active}}	Plano, vencimento do plano e se a empresa está ativa
{{invoice.valueFormatted}}, {{invoice.dueDate}}, {{invoice.detail}}	Valor (R$), vencimento e descrição da fatura
{{invoice.paymentLink}}	Link de pagamento da fatura (só no gatilho de vencimento)
{{daysFromDue}}	Dias em relação ao vencimento: -3 faltam três dias, 3 atrasada há três
{{blockReasonLabel}}	Motivo do bloqueio (só no gatilho de empresa bloqueada)

Exemplo de mensagem D-3: Olá, {{tenant.name}}! Sua fatura de {{invoice.valueFormatted}} vence em {{invoice.dueDate}}. Pague por aqui: {{invoice.paymentLink}}

Empresa cliente sem telefone válido no cadastro não recebe a mensagem. Em conexões da API Oficial do WhatsApp, a primeira mensagem para quem não falou com você nas últimas 24h precisa ser um template aprovado (use o bloco Enviar Template Oficial).

---

Automações de pedido

O aviso de novo pedido ao dono, o lembrete de recompra e a pesquisa pós-entrega são fluxos comuns, montados com os gatilhos de pedido e os nós abaixo. Os segmentos que trazem essas automações já recebem os fluxos prontos; a mensagem, o prazo e o liga/desliga são editados neles.

Rodar sem abrir conversa

Os gatilhos Novo pedido, Status do pedido alterado, Status de entrega alterado e Pagamento recebido têm a opção Rodar sem abrir conversa. Ligada, o fluxo roda a partir do evento, sem criar nem mexer em atendimento: serve para avisos internos e lembretes. Os nós que dependem de conversa (mensagem ao contato, menu, pergunta, IA) são pulados nesse modo; notificação, condição, intervalo, webhook e e-mail funcionam.

• Um pedido feito pela loja, que não tem conversa, sempre roda assim.
• Cada evento roda o fluxo uma vez: o mesmo pedido não dispara o aviso duas vezes, mesmo que o evento chegue repetido.
• Na lista de gatilhos, o chip Sem conversa mostra quem roda nesse modo. O botão de ajuste do gatilho muda o modo depois de criado.

Filtrar pelo status do pedido

Em Status do pedido alterado e Status de entrega alterado, escolha para quais status o gatilho dispara (por exemplo, só Entregue, para a pesquisa pós-entrega). Nenhum marcado dispara em qualquer status.

Nó Notificação

• Número: digite o número (de 10 a 15 dígitos, com ou sem máscara) ou use uma variável. Os atalhos abaixo do campo inserem Número que recebe os pedidos (company.orderNotificationPhone, o número salvo em Configurações > Pedidos) e, em fluxos de pedido, Telefone do cliente do pedido (order.customer_phone). A variável é lida na hora do envio, então trocar o número vale até para um lembrete que já estava esperando.
• Conexão: vazia, o envio usa a primeira conexão conectada, as lidas por QR Code antes da oficial. Numa conexão da API oficial, a notificação só sai com um template aprovado; sem template, ela é pulada e o motivo fica registrado.
• Template pelo nome: um bloco que guarda só o nome do template (e o idioma) acha, na conexão que realmente envia, o template aprovado com esse nome, sem precisar escolher um id. É assim que os fluxos prontos da plataforma funcionam sem conexão definida. Se o bloco tem o id de um template de outra conexão, vale o do mesmo nome na conexão que envia.
• Mensagem: aceita as variáveis do pedido, como order.id, order.customer_name, order.customer_first_name, order.items_text (um item por linha), order.first_item_title, order.categories_text, order.total_formatted, order.address_text, order.payment_label, order.observation e order.link, além de company.name. Use cada uma entre chaves duplas, como nas demais mensagens.
• Para quem não envia: um número que é de uma conexão da própria empresa é recusado, para a mensagem não voltar para a própria conexão. Falha do WhatsApp num fluxo sem conversa é tentada de novo algumas vezes antes de desistir.
• Enviar teste: com o nó salvo e o fluxo salvo, o botão manda agora a notificação com um pedido de exemplo e mostra o resultado: o final do número que recebeu ou o motivo de não ter saído (número vazio ou inválido, número de uma conexão da empresa, conexão oficial sem template, nenhuma conexão ou recusa do WhatsApp).

Intervalo em dias e hora do envio

• O nó Intervalo aceita a unidade Dias, até 365.
• Enviar a partir das (hora): opcional, de 0 a 23. Depois do intervalo, o fluxo espera até essa hora no fuso da empresa. O nó mostra o resumo, por exemplo "30 dias, às 10h".
• Cancelar se o mesmo contato entrar de novo neste fluxo: só vale para fluxos que rodam sem conversa. Se o cliente fizer outro pedido durante a espera, o lembrete antigo é cancelado e só o do pedido mais recente segue.
• Espaçar um contato do outro: desligado por padrão. Sem ele, cada contato espera o intervalo por conta própria; se 50 contatos entram juntos (por exemplo, um webhook em lote), os 50 saem quase ao mesmo tempo, após o intervalo. Ligado, quem chega junto sai um intervalo depois do outro (o 1º após 5 min, o 2º após 10 min, e assim por diante). A fila vale por fluxo e por nó de Intervalo.

---

Integração com Outros Recursos

O que pode disparar um fluxo

Origem	Descrição
Gatilho por frase	Uma mensagem que corresponde a uma frase configurada inicia o fluxo. Configurável direto no fluxo (veja Gatilhos do Fluxo).
Gatilho por evento	Um evento do sistema (nova conversa, sem resposta, tag adicionada, novo pedido etc.) inicia o fluxo.
Boas-vindas / Fluxo padrão da conexão	A conexão WhatsApp usa este fluxo como saudação (contato novo) ou como fluxo padrão (sem correspondência de frase). Configurável na aba Padrão da conexão ou na tela de Conexões.
Webhook	Um sistema externo envia uma requisição que inicia o fluxo.
Automações de IA	Um assistente de IA direciona a conversa para um fluxo.
Automações do Kanban	Uma mudança de etapa no Kanban dispara o fluxo.
Campanhas	Uma campanha de envio executa o fluxo para cada contato.

O que um fluxo pode fazer

Ação	Descrição
Enviar mensagens	Texto, imagens, áudios, vídeos e documentos para o cliente.
Transferir fila	Direcionar o atendimento para uma fila específica.
Gerenciar tags	Adicionar ou remover tags do contato.
Chamar webhooks	Enviar dados para sistemas externos via HTTP.
Ativar IA	Acionar um assistente de IA para continuar a conversa.
Enviar notificações	Disparar notificações via WhatsApp.
Atualizar ticket	Modificar informações do ticket de atendimento.
Salvar info do contato	Atualizar campos padrão ou customizados do contato.

---

Nó de Condição

O nó de Condição permite avaliar critérios sobre o contato, ticket ou conversa e direcionar o fluxo por caminhos diferentes conforme o resultado.

Tipos de condição disponíveis

Condição	Descrição
Pergunta	Avalia a resposta dada a uma pergunta anterior do fluxo
Contato possui tag	Verifica se o contato possui ou não determinadas tags
Estágio do kanban	Verifica em qual etapa do kanban o contato se encontra
Quantidade de tickets	Avalia a quantidade de tickets do contato
Status do ticket	Verifica o status do ticket atual (aberto, pendente, fechado)
Conexão do ticket	Verifica por qual conexão (WhatsApp) o ticket chegou
Número do contato	Avalia o número de telefone do contato
Horário atual	Compara a hora atual com um valor (ex.: maior ou igual a 08:00)
Dia da semana	Verifica se o dia da semana atual é um (ou é qualquer um de) vários dias selecionados
Aniversário do contato	Verifica se o aniversário do contato é hoje, neste mês, nos próximos N dias (mês/dia), ou antes/depois/entre datas específicas (data completa, útil para filtros por idade)
Minutos desde a última execução do fluxo	Quantos minutos se passaram desde a última vez que este fluxo foi iniciado, por qualquer contato ou ticket (ver abaixo)

Minutos desde a última execução do fluxo

Conta o fluxo como um todo, não o contato nem o ticket: se o fluxo foi iniciado para o contato A há 10 minutos, o contato B que entra agora vê "10 minutos".

Exemplo: SE minutos desde a última execução do fluxo for maior que 30, envia o aviso para a equipe; senão, segue sem avisar. Assim o aviso sai no máximo uma vez a cada 30 minutos, mesmo que o fluxo seja disparado muitas vezes.

• A medida é feita contra a execução anterior: a execução atual nunca conta a si mesma, mesmo que a condição fique depois de uma pergunta ou de um intervalo.
• Um fluxo que nunca rodou conta como "muito tempo atrás", então Maior que sempre passa na primeira execução.
• O valor é em minutos inteiros (30 minutos e 59 segundos contam como 30).
• Testes no simulador não contam como execução.

Operadores disponíveis

Os operadores variam conforme o tipo de condição. Os principais são:

Operador	Descrição
Igual a	Valor exato
Diferente de	Valor diferente
Contém	Texto contém o valor informado
Não contém	Texto não contém o valor informado
Começa com	Texto começa com o valor informado
Não começa com	Texto não começa com o valor informado
Entre	Valor numérico dentro de um intervalo
Maior que / Menor que	Comparação numérica

Para a condição Número do contato, os operadores disponíveis são: Começa com, Não começa com, Contém, Não contém, Igual a e Diferente de. Isso é útil para segmentar fluxos por DDD ou país (ex.: números que começam com "5511").

Não está em nenhuma etapa / Não possui nenhuma tag

As condições Estágio do kanban e Contato possui tag têm um operador especial que não exige selecionar etapas ou tags:

Condição	Operador	Quando o caminho positivo é seguido
Estágio do kanban	Não está em nenhuma etapa	O contato não está em nenhuma etapa de nenhum kanban
Contato possui tag	Não possui nenhuma tag	O contato não possui nenhuma tag

Use esses operadores quando quiser verificar a ausência total de etapa ou tag, sem precisar listar todas as opções disponíveis. Diferente de Não está em nenhuma das selecionadas (que só considera as etapas/tags que você escolher), o novo operador considera todas as etapas/tags da empresa automaticamente — inclusive as criadas depois de salvar o fluxo.

Os operadores que dependem de seleção continuam disponíveis e tiveram o rótulo ajustado para "...das selecionadas", deixando claro que avaliam apenas a lista escolhida.

---

Ação Condicionada: Salvar Informações do Contato

Esta ação permite atualizar os dados do contato diretamente pelo fluxo. Você pode salvar tanto campos padrão quanto campos customizados, usando valores fixos ou variáveis coletadas durante a conversa.

Como funciona

1. No canvas, adicione um nó de Ação Condicionada.
2. Selecione a ação Salvar informações do contato.
3. Clique no botão + para adicionar mapeamentos de campos.
4. Para cada campo, configure:
   • Tipo: Campo padrão ou Campo customizado.
   • Campo: Selecione qual campo será atualizado.
   • Valor: Informe um valor fixo ou use uma variável do fluxo (ex.: {{nome_informado}}).

Campos padrão disponíveis

Campo	Descrição
Nome	Nome do contato
E-mail	Endereço de e-mail
Documento (CPF/CNPJ)	Número de documento
Endereço	Em campos separados: CEP, rua, número, bairro, cidade, UF e complemento. O CEP é conferido nos Correios e completa a cidade e a UF. Ver Endereço de entrega
Data de nascimento	Data de nascimento

Campos customizados

Além dos campos padrão, você pode salvar valores em qualquer campo customizado cadastrado na sua empresa. Os campos customizados disponíveis são carregados automaticamente ao selecionar o tipo "Campo customizado".

Para gerenciar os campos customizados disponíveis, acesse Configurações > Campos Customizados.

Usando variáveis

Você pode usar variáveis coletadas durante o fluxo como valor dos campos. Por exemplo:

• Use um nó de Pergunta para coletar o e-mail do cliente e armazene na variável email_cliente.
• No nó de Salvar informações do contato, mapeie o campo E-mail para o valor {{email_cliente}}.

O seletor de variáveis na parte inferior do formulário mostra todas as variáveis disponíveis. Clique em uma variável para copiá-la e cole no campo de valor.

Resultado da ação

Caminho	Quando
Conexão A (sucesso)	Todos os campos foram salvos com sucesso.
Conexão B (falha)	Ocorreu um erro ao salvar (ex.: contato não encontrado, campo obrigatório sem valor).

---

Ação Condicionada: Webhook

O nó de Ação Condicionada com a ação Webhook faz uma requisição HTTP para um sistema externo e segue por uma de duas saídas conforme o resultado.

Configuração

Campo	Descrição
URL	Endpoint a ser chamado (aceita {{variaveis}})
Método	GET, POST, PUT, PATCH ou DELETE
Cabeçalhos	Headers personalizados
Autenticação	Nenhuma, Basic ou Bearer token
Corpo	Conteúdo da requisição em JSON (aceita {{variaveis}})
Timeout	Tempo máximo de espera
Variáveis de resposta	Extrai campos do JSON de resposta para variáveis do fluxo

Roteamento das saídas

Por padrão, a saída é decidida pelo código HTTP da resposta:

Caminho	Quando
Conexão A (verdadeiro)	Resposta com status de sucesso (2xx).
Conexão B (falso)	Qualquer outro status ou erro na requisição.

Roteamento inteligente (IA)

Você pode ativar a opção Usar IA para decidir A/B. Nesse modo, em vez de olhar apenas o código HTTP, a I.A. lê a resposta do webhook e decide a saída com base em um critério em linguagem natural que você escreve.

Exemplos de critério:

• "a resposta indica que o pedido foi aprovado"
• "o campo status é 'ativo' e o saldo é maior que zero"

Quando o critério é atendido, o fluxo segue pela Conexão A; caso contrário, pela Conexão B. Se a I.A. falhar ou ficar em dúvida, o fluxo volta automaticamente a usar o código HTTP como critério, garantindo que o fluxo nunca trave.

O roteamento inteligente usa o assistente de I.A. padrão da empresa. É necessário ter ao menos um assistente com chave de API configurada.

---

Nó Ativar IA

O nó Ativar IA entrega a conversa a um assistente de I.A. (prompt) a partir daquele ponto do fluxo.

Opção	Comportamento
IA responde imediatamente (ligada)	A I.A. envia a primeira mensagem assim que é ativada, sem esperar o cliente escrever de novo.
IA responde imediatamente (desligada)	A I.A. é ativada em silêncio e só responde quando o cliente enviar a próxima mensagem.

Com IA responde imediatamente ligada, a abertura se ajusta ao estado real da conversa, independentemente de haver ou não um bloco de conteúdo antes da ativação:

• O cliente já escreveu e ainda não foi respondido — a I.A. responde diretamente à mensagem dele seguindo o prompt (não envia uma saudação genérica por cima).
• O fluxo (ou um bloco de conteúdo) acabou de falar — a I.A. avalia o contexto e decide se dá sequência ao atendimento ou aguarda em silêncio.
• Ticket novo, sem nenhuma mensagem — a I.A. envia a saudação inicial roteirizada.

Não é mais necessário colocar um bloco de conteúdo antes do nó Ativar IA para a abertura sair correta: a I.A. segue o prompt em qualquer estrutura de fluxo.

---

Importação e Exportação

Você pode compartilhar fluxos entre ambientes usando arquivos JSON.

Ação	Como fazer
Exportar	No menu de ações do fluxo, clique em Exportar JSON. Um arquivo será baixado.
Importar	No menu superior da tela de fluxos, clique em Importar e selecione o arquivo JSON.

O arquivo exportado contém todos os nós e conexões do fluxo, permitindo recriá-lo em outra conta ou ambiente.

---

Dicas de Uso

• Nomeie seus fluxos de forma descritiva para facilitar a busca.
• Use categorias para separar fluxos por departamento ou finalidade.
• Favorite os fluxos mais usados para acesso rápido.
• Teste o fluxo antes de ativá-lo, verificando cada caminho possível.
• Use o versionamento para reverter alterações indesejadas.
• Comece com templates e adapte conforme sua necessidade.