Fluxos

Os Fluxos permitem montar jornadas visuais com gatilhos, condições, ações, esperas e integrações. Eles são indicados para automações com ramificações ou várias etapas encadeadas.

Localização:

Automações → Criar → Fluxos

---

Lista de fluxos

A biblioteca mostra os fluxos da empresa com:

• nome e descrição
• gatilhos configurados
• quantidade de componentes
• status de rascunho, ativo ou inativo
• indicação de alterações ainda não publicadas
• data da última atualização

Use a busca para localizar um fluxo. Se o carregamento falhar, a página exibe o erro e oferece uma nova tentativa; uma falha nunca aparece como biblioteca vazia.

Criar um fluxo

Clique em Novo fluxo. No editor, adicione primeiro o gatilho e depois os componentes que formam a jornada.

Rascunho e produção

O editor salva um rascunho. A automação em produção só muda quando você publica uma nova versão. Um fluxo que nunca foi publicado não pode aparecer como ativo; publique a primeira versão antes de usar o controle de ativação.

Criar ou editar um fluxo pelo Copiloto segue o mesmo processo. A automação não é ativada automaticamente: primeiro o rascunho é salvo, depois publicado e, por fim, ativado. Ao publicar novamente um fluxo existente, a escolha atual de mantê-lo ativo ou pausado é preservada.

Área de trabalho

O Studio é composto por:

• barra superior — nome, estado do salvamento, execuções, ativação, versões e publicação
• canvas — componentes e conexões do fluxo
• seletor de componentes — aberto pelos botões de adição no canvas
• painel lateral — configuração e resultado do componente selecionado

No desktop, o seletor abre próximo ao ponto de inserção. Em celular, ele usa uma folha inferior com a mesma busca e as mesmas opções.

Adicionar componentes

Clique no botão + depois de uma etapa ou em um ponto vazio do fluxo. O seletor organiza os componentes por categoria e permite buscar sem depender de acentos.

O Studio oferece somente opções compatíveis com aquele ponto:

• gatilhos aparecem apenas no início
• uma etapa seguinte não pode ser outro gatilho
• condições e ramificações mostram suas saídas pelo nome
• componentes inexistentes ou incompatíveis bloqueiam a publicação

O novo componente já é conectado ao caminho escolhido.

Em componentes de decisão, Sim aparece à esquerda e Não à direita. Se houver mais saídas, os caminhos seguem a ordem configurada, inclusive depois de editar, desfazer ou reabrir o fluxo.

Enviar mensagens após finalizar o atendimento

Em Configurações do fluxo, escolha Enviar também após finalizar o atendimento se as ações de mensagem devem continuar para uma conversa finalizada. A opção começa desligada. Com ela desligada, mensagens ainda pendentes no fluxo são ignoradas quando o atendimento é finalizado antes do envio.

A escolha vale para mensagens comuns, mensagens rápidas e templates oficiais. Salve o rascunho e publique uma nova versão para aplicar a alteração ao fluxo ativo. As demais condições de envio continuam valendo.

Nos fluxos criados no editor antigo, use a opção exibida no aviso Fluxo legado detectado e clique em Aplicar ao fluxo ativo. Isso publica apenas essa preferência, sem alterar os componentes do fluxo.

Cancelar envios quando o atendimento mudar

Nas opções avançadas do gatilho, você pode ativar duas proteções para cada fluxo:

• Cancelar ao sair das etapas selecionadas — exige etapas configuradas no gatilho Etapa Alterada ou na condição Em Etapa?. Se o contato sair dessas etapas, as mensagens pendentes são canceladas. A etapa é conferida novamente imediatamente antes de cada envio. Uma negociação ganha ou perdida no mesmo funil também deixa de ser elegível.
• Cancelar se a IA da conversa for pausada — cancela a sequência quando a IA daquela conversa for pausada.

As duas opções começam desligadas nos fluxos existentes. Salve o rascunho e publique uma nova versão para aplicá-las. Publicar um fluxo inativo não o ativa; a ativação continua sendo uma ação separada.

Recomeçar a espera após atividade

No componente Aguardar, a opção avançada Reiniciar espera após atividade na conversa conta o prazo novamente a partir da mensagem mais recente, recebida ou enviada. Ela começa desligada. Use-a quando o próximo contato deve ocorrer apenas depois de um período sem mensagens. Salve e publique o fluxo para aplicar a mudança.

O fluxo também confere se houve nova atividade antes de enviar uma mensagem associada a essa espera. As proteções de etapa e pausa configuradas no gatilho continuam valendo.

IA nos componentes do fluxo

Os componentes Decisão IA e Enviar mensagem com geração por IA levam em conta o prompt principal publicado para a conexão da conversa, as mensagens recentes e a instrução escrita no componente. Quando não houver prompt ativo específico para a conexão, é usado o prompt global ativo da empresa.

A instrução do componente define a tarefa daquela etapa. Uma decisão da IA precisa resultar claramente em Sim ou Não; se não houver uma decisão clara, o fluxo não segue pelo caminho que envia a mensagem.

Configurar uma etapa

Clique em um componente para abrir o painel lateral. Use:

• Configurar — campos executados pela etapa
• Resultado — último resultado seguro ou resultado selecionado no histórico

As setas do cabeçalho percorrem os componentes anterior e seguinte sem fechar o painel.

Usar dados das etapas anteriores

Campos compatíveis abrem o seletor Usar dados ao receber foco ou pelo botão de inserção. Ele mostra:

• dados do gatilho
• resultados das etapas anteriores que chegam ao componente atual
• tipo e exemplo do valor
• objetos e listas em uma árvore expansível

Use a busca ou navegue pela árvore. Ao escolher um campo, o valor é inserido no ponto atual do texto, o seletor fecha e o foco volta ao campo de destino.

Somente dados disponíveis

Etapas futuras, ramos que não chegam ao componente e etapas desativadas não são oferecidos como fonte, pois não produzem um valor válido naquele ponto.

Dados do contato nas mensagens

Nas mensagens das etapas Enviar mensagem, Notificar equipe, Enviar WhatsApp para número e Enviar WhatsApp para grupo, os dados do contato aparecem como etiquetas com nome, por exemplo Nome do contato ou Última nota do negócio, em vez de códigos entre chaves.

• Clique em Inserir dado ou digite / no meio do texto para abrir a lista de dados. Use a busca; cada opção mostra um exemplo do que vai aparecer.
• Cada etiqueta se apaga inteira com uma tecla, então não tem como digitar o dado errado.
• Abaixo do campo, a prévia mostra como a mensagem vai chegar no WhatsApp, preenchida com um contato de exemplo.

Quando o contato não tem um dado usado na mensagem, o fluxo envia o texto sem esse dado. O cliente nunca recebe um código entre chaves. Fluxos criados antes continuam funcionando e passam a mostrar as etiquetas.

Campos em vez de código

As configurações mais comuns usam controles visuais:

• Requisição HTTP — URL, método, query, cabeçalhos, tipo de corpo, campos mapeados, timeout e tentativas
• Integração — conexão, operação e campos esperados pela integração
• Responder webhook — status, cabeçalhos e corpo
• Template oficial — parâmetros na ordem exigida pelo template
• Mapear/definir campos — destino e valor em linhas editáveis

Os dados técnicos completos continuam disponíveis de forma recolhida para diagnóstico, mas não são a forma principal de configurar a etapa.

Linhas com chave repetida, valor inválido ou campo obrigatório ausente mostram o erro no próprio controle e bloqueiam o teste daquela etapa.

Assinar requisições HTTP (HMAC)

Alguns sistemas externos, como CRMs, só aceitam envios assinados com uma chave secreta. Na etapa Requisição HTTP, em Autenticação, escolha Assinatura HMAC e preencha:

• Chave secreta — informada pelo sistema de destino
• Algoritmo e codificação — normalmente SHA-256 e hex
• Cabeçalho da assinatura e cabeçalho do timestamp — os nomes pedidos pelo sistema de destino
• Texto a assinar — o padrão é método, caminho, timestamp e corpo, um por linha; ajuste conforme a documentação do sistema de destino

A chave é digitada uma única vez. Depois de salvar o fluxo, ela aparece apenas com os primeiros caracteres (por exemplo, 9bfr••••••••). Use Trocar chave para informar outra ou Remover chave para apagá-la.

Chave vinculada ao destino

Se você alterar o endereço de destino ou o texto a assinar, a chave salva é descartada e precisa ser digitada de novo. Isso impede que a assinatura seja enviada para outro endereço.

No campo avançado Repetir nos status, informe quais respostas de erro devem gerar uma nova tentativa. Cada tentativa é assinada de novo.

Tipos de componentes

Gatilhos

Iniciam a automação a partir de eventos como mensagem recebida, tag adicionada, mudança de etapa, contato ou negociação criada, entrada em lista ou webhook.

Condições

Avaliam conteúdo, tags, etapa, horário, decisão da IA ou vários casos por meio de Switch. Cada saída recebe um nome estável para que reordenar casos não troque o caminho existente.

Ações

Enviam mensagens, enviam WhatsApp para um grupo, usam template oficial ou mensagem rápida, adicionam ou removem tags, notificam a equipe, movem uma negociação, criam uma negociação, pausam a IA, chamam integrações ou fazem requisições HTTP.

Enviar WhatsApp para grupo

A etapa Enviar WhatsApp para grupo avisa um grupo do WhatsApp quando algo acontece no fluxo, por exemplo a recepção quando um paciente agenda. O contato do fluxo não recebe nada.

1. Em Enviar pelo número, escolha um número conectado por QR Code.
2. Em Grupo que vai receber, procure pelo nome. A lista mostra os grupos em que esse número participa, com a quantidade de participantes. Grupos que você não tem permissão para ver não aparecem.
3. Escreva a Mensagem. Use Inserir dado para incluir dados do contato ou da negociação, e confira a prévia antes de salvar.
4. Deixe ligada a opção Enviar uma vez por entrada na etapa para o grupo receber uma mensagem só, mesmo que a negociação dispare o fluxo duas vezes ao entrar na etapa.

A mensagem enviada aparece na conversa do grupo, não dispara fluxos de Mensagem enviada e a IA não responde em grupos. Se o número sair do grupo ou o grupo for apagado, a etapa falha com o motivo no histórico de execução, sem tentar de novo.

Todos do grupo leem

Todos os participantes do grupo leem a mensagem. Se ela tiver dados de saúde ou outros dados sensíveis do contato, use apenas grupos da sua equipe.

Criar Negociação

A etapa Criar Negociação escolhe o contato da negociação em Origem do contato:

• Contato do contexto (gatilho) — usa o contato da conversa ou do evento que iniciou o fluxo. É o padrão.
• Dados recebidos no payload — usa o telefone enviado por um gatilho de webhook (por exemplo, o formulário do site). Informe o caminho do telefone nos dados recebidos e, se quiser, os caminhos de nome, e-mail e empresa. Use o seletor de dados para inserir o campo correto sem digitar JSON.

Com a origem vinda do payload, o fluxo:

1. procura um contato pelo telefone recebido, aceitando formatos com ou sem +55, com máscara, com 0 inicial ou prefixo 00;
2. reutiliza o contato encontrado, completando nome, e-mail e empresa sem apagar o que já estava preenchido (a opção Atualizar contato existente pode ser desligada para não alterar nada);
3. cria um contato novo quando não encontra nenhum. Nesse caso, as automações de Contato Criado são disparadas.

O telefone é obrigatório nesse modo: sem um telefone válido nos dados recebidos, a etapa falha com uma mensagem clara na execução. No teste do fluxo, a etapa mostra se o contato seria reaproveitado ou criado, e avisa quando faltaria contato ou quando já existe uma negociação aberta para ele.

Publicação protegida

Fluxos iniciados por webhook que usam etapas dependentes de contato (enviar mensagem, tag, mudar etapa ou criar negociação sem payload) só podem ser publicados quando existe uma etapa Criar Negociação resolvendo o contato pelos dados recebidos. O editor mostra a pendência antes de publicar.

Controle e dados

Incluem espera, espera por resposta, fim, merge, mapeamento de campos e resposta de webhook.

Em Aguardar, Pausar Bot, Aguardar Resposta e Sem Resposta, escolha a duração em minutos, horas ou dias. O resumo no componente mostra a unidade selecionada. Ao reabrir um fluxo antigo, a duração continua valendo como foi configurada.

Testar com segurança

Antes de publicar, abra o teste do fluxo e escolha um cenário compatível com o gatilho. É possível informar uma mensagem, dados do contato ou montar o corpo de um webhook por campos, sem escrever JSON.

O teste é sempre seguro:

• mensagens não são enviadas a contatos reais
• alterações de tags, campos e etapas são simuladas
• negociações não são criadas
• chamadas externas não são disparadas
• decisões da IA recebem uma prévia determinística

O resultado informa claramente quando algo foi Simulado, Pulado, Desativado, concluído ou falhou.

Para testar um componente isolado, o rascunho precisa estar salvo e válido. Se houver pendências, use Corrigir pendências para ir ao campo bloqueador.

Resultado e histórico de execução

A aba Resultado prioriza uma leitura humana, com campos de negócio e listas organizadas. Os dados completos ficam recolhidos por padrão.

Em Execuções, selecione um teste ou execução para ver:

• status e duração
• linha de execução
• entrada e saída de cada componente
• motivo de falha ou de ação pulada
• chamadas externas registradas

Se a IA pulou uma ação, o motivo disponível aparece na linha do tempo. Uma etapa desativada é identificada separadamente.

O resultado de uma espera por resposta aparece somente quando esse componente fez parte do caminho executado. Outros fluxos não recebem um aviso de tempo esgotado sem terem aguardado uma resposta.

Desativar uma etapa sem excluir

Uma ação linear compatível pode ser desativada pelo menu do componente ou pelo painel lateral. A etapa permanece no desenho, mas a automação segue diretamente para sua única saída sem executar o efeito.

Não podem ser desativados:

• gatilhos
• condições e Switch
• espera por resposta
• fim
• etapas sem uma única saída segura

Se outra etapa usa o resultado daquela ação, o Studio bloqueia a desativação e oferece Revisar campo. Para voltar a executar, use Reativar etapa.

Editar e desfazer

O editor mantém histórico local de alterações. Use desfazer e refazer para recuperar configuração, conexões, posição, exclusão ou desativação. Uma nova edição depois de desfazer inicia uma nova sequência.

Ao excluir uma ação intermediária simples, o Studio reconecta o caminho quando isso é seguro. O gatilho não pode ser excluído.

Publicar e ativar

Clique em Publicar para abrir a revisão. A tela apresenta pendências e o estado de ativação que será aplicado.

• Publicar ativo — a nova versão passa a receber eventos
• Publicar inativo — salva a versão em produção sem iniciar novas execuções

O histórico de versões permite consultar, restaurar ou publicar uma versão anterior. Execuções que já começaram continuam vinculadas à versão usada no início, mesmo que o rascunho ou a produção sejam alterados depois.

WhatsApp Oficial

Mensagens livres dependem da janela de 24 horas. Fora dela, configure explicitamente um template oficial aprovado; o fluxo não faz troca automática.

Entradas de sistemas externos em segundo plano

Quando um fluxo recebe uma entrada externa sem precisar responder com o resultado imediatamente, o recebimento e a execução acontecem em etapas separadas. A entrada é registrada primeiro e o fluxo é executado em segundo plano. Uma confirmação de recebimento não significa que todas as ações do fluxo já terminaram.

Em períodos de maior movimento, as entradas aguardam processamento. Se o limite de recebimento for atingido, o sistema que envia os dados deve tentar novamente mais tarde, preservando a identificação do evento para evitar duplicações.

Fluxos configurados para devolver uma resposta imediata ao sistema de origem mantêm esse comportamento. Acompanhe a execução antes de repetir manualmente uma ação que possa enviar mensagens ou alterar cadastros.