Pular para o conteúdo principal
O Fluxo de Conversa (Chat Flow) é o construtor visual nativo de chatbots do PanÐá Zap, com arrastar e soltar, no estilo de ferramentas como o N8N. Ele permite montar, arrastando blocos em um canvas, uma jornada completa de atendimento automático: enviar mensagens e mídia, exibir menus, coletar dados do cliente, aplicar etiquetas, mover contatos entre as colunas do Kanban de atendimento, criar oportunidades no Funil de Vendas, integrar com sistemas externos via webhook e, no momento certo, direcionar o cliente para uma fila ou atendente humano. Tudo isso sem precisar de nenhuma ferramenta externa de automação. Quem usa: Administrador e Supervisor.

Conceitos-base

Antes de montar o primeiro fluxo, vale entender quatro conceitos que aparecem em toda a documentação do Chat Flow:
O ponto mais importante para não travar na primeira tentativa: interação é diferente de conexão. A interação define o que o bot faz dentro daquele bloco; a conexão define para onde o cliente é levado depois de responder. Um bloco de menu só funciona se tiver conexões configuradas para cada opção esperada; sem elas, o fluxo simplesmente não avança e o cliente fica parado.

O Canvas e os Blocos

Ao abrir um fluxo para edição (ícone de lápis Abrir editor do fluxo no cartão do fluxo), você trabalha em um canvas visual. O botão Blocos da barra de ferramentas abre o painel de blocos, com o campo Buscar bloco… e quatro categorias: Cada bloco é uma interação: arraste-o e solte sobre um passo do canvas para incluí-lo nas interações daquele passo. Soltar um bloco em uma área vazia do canvas não cria nada; para criar um passo novo, use o botão Passo. O catálogo completo de interações (o que cada uma faz e quando usar) está mais abaixo, na seção Catálogo Completo de Interações.

Barra de ferramentas do canvas

Na barra de ferramentas do canvas você encontra:
Três elementos são fixos e não podem ser removidos de nenhum fluxo: Início (ponto de entrada), Configurações (painel de controle global) e o primeiro passo, que já vem criado com o nome Boas vindas! (pode ser renomeado). A ligação do Início é fixa e sempre aponta para esse primeiro passo: para começar o fluxo por outro caminho (por exemplo, por uma Tabela de horários), deixe o primeiro passo sem interações e crie nele uma condição Automático (sem aguardar resposta) apontando para o destino.

Categorias de Blocos

Visão rápida do que cada categoria do painel lateral oferece. O detalhamento completo de cada interação, com “o que faz” e “quando usar”, está no Catálogo Completo de Interações mais abaixo.

Mensagens

Blocos que enviam conteúdo diretamente ao contato: Mensagem, Mídia, Botões, Lista, Template (HSM), Formulário do WhatsApp (Flow), Figurinha, Contato, Localização, Vídeo Conferência e Botão PIX.

Roteamento

Blocos que definem o destino do atendimento ou controlam a atuação do bot: Transferir, Carência, Trocar de Canal, Sub-fluxo, Atraso e Bloquear Chatbot.

Integrações

Blocos que passam o controle da conversa para sistemas externos ou acionam automações fora do PanÐá Zap: Webhook, Webhook Avançado, ChatGPT, Agente de IA, Typebot, n8n, VAPI e SMS.
Typebot, ChatGPT, Agente de IA e n8n assumem a conversa a partir do ponto em que entram: coloque-os sempre como a última interação do passo (o próprio editor lembra, em Avisos, que Typebot, ChatGPT, N8N e Bloquear Chatbot devem ser a última interação). Se houver outras ações depois deles no mesmo passo, os dois lados podem responder ao mesmo tempo, gerando mensagens duplicadas ou comportamento imprevisível.

CRM e ações

Blocos que registram informações e avançam processos internos, sem enviar mensagem ao cliente naquele momento: Etiqueta, Kanban, Oportunidade, Google Agenda, Agendamento, Razões, Notas, Consulta Agenda e Notificar equipe.

Conexões entre Blocos

Com o mouse sobre o bloco de origem, um ponto de saída aparece na borda direita. Arraste esse ponto até o bloco de destino: um modal Nova conexão se abre para você escolher o tipo de conexão. Um mesmo passo pode ter várias saídas apontando para destinos diferentes; elas aparecem como pontos rotulados na borda direita do passo, e a conexão automática é sempre marcada com o ícone ⚡. Para aceitar a palavra no meio de uma frase (por exemplo, “quero falar com vendas”), abra o passo e troque o tipo da condição para Contém. A ligação que sai do Início é fixa e não pode ser alterada.
O sistema avalia as conexões por palavras-chave antes da conexão Padrão. Ou seja, se a resposta do cliente bater em uma palavra-chave configurada, esse caminho é seguido primeiro; a conexão Padrão funciona como o “senão” da história, o caminho de reserva para qualquer resposta que não bateu em nenhuma palavra-chave.

Editando um Bloco

Para editar um passo, clique no ícone de lápis do passo (ou dê dois cliques nele). A janela de edição tem o campo Nome do passo e três seções:
  • Interações: as ações executadas em sequência, de cima para baixo, quando o cliente chega naquele passo. Inclua itens pelo seletor Adicionar interação (com busca) e reordene com as setas Mover para cima e Mover para baixo.
  • Condições: as saídas do passo, as mesmas que aparecem como ligações no canvas. Clique em Condição para adicionar uma e escolha o Tipo: Qualquer resposta, Automático (sem aguardar resposta), Variável (contexto), Igual a, Contém, Começa com, Termina com ou Regex. Em Encaminhar para, defina o destino: Próximo passo, Fila, Agente, Fechar (encerra o atendimento, com Mensagem de encerramento opcional) ou Canal.
  • Variável (opcional): guarda a resposta do cliente naquele passo. Preencha a Chave da variável (o nome que você vai usar depois como {{chave}}) e, se quiser, o Rótulo da variável. Em Tipo da variável, escolha Texto, Número, E-mail, CPF, CNPJ, Telefone, Data ou Regex; nos tipos com validação, ajuste as Tentativas de re-pergunta (padrão 3) e a Mensagem de resposta inválida. Se a resposta continuar fora do formato depois das tentativas, o valor é guardado mesmo assim.
As condições podem ser criadas de dois jeitos: arrastando a ligação no canvas ou pela seção Condições do passo. A condição Variável (contexto) compara uma variável do fluxo ou do contato (e não a mensagem), com operadores como Igual a, Diferente de, Maior que, Menor que, Existe (preenchida) e Não existe (vazia), e vem antes das condições de texto; a condição Regex é processada antes de qualquer outra condição. Um passo com condição Automático não coleta variável, porque não espera a resposta do cliente.

Variáveis Disponíveis

Use {{variável}} dentro de qualquer mensagem de texto para personalizar a conversa automaticamente: Nos campos de texto das interações, o botão Inserir variável lista essas opções. As duas últimas aparecem, com os nomes Link de avaliação do Google e Link do WebChat (convite), só nos campos de mensagem enviados ao cliente: Mensagem, legenda da Mídia, Botões, Lista, variáveis do Template (HSM), Transferir, Trocar de Canal, Vídeo Conferência e SMS. Na interação Agendamento só entra o link do Google, porque a mensagem agendada sai sem o link do WebChat. Além delas, as respostas que você captura nos passos (pela Chave da variável), as respostas salvas pelo Webhook Avançado (campo Salvar resposta na variável) e os campos do Formulário do WhatsApp (Flow) (pelo Nome das variáveis do bloco) ficam disponíveis nos passos seguintes, pelo mesmo nome.
O Link do WebChat (convite) só funciona com Receber pelo link de convite ligado num canal WebChat (veja Webchat); sem canal marcado, ele sai vazio, assim como em grupo, no e-mail, no próprio WebChat e em mensagem agendada. Escreva um texto junto da variável e termine o fluxo do WhatsApp encerrando o atendimento depois do link: sem isso, a mensagem de inatividade continua saindo pelo WhatsApp. O link vale 24 horas e uma vez só: o primeiro navegador que abrir fica com a conversa.

Nó de Configurações do Fluxo

Quem usa: Administrador e Supervisor (mesmo perfil de acesso do Chat Flow). O nó Configurações é o painel de controle global do fluxo. Ele não envia mensagens nem aguarda resposta do cliente como uma etapa comum; em vez disso, define como o bot deve se comportar em situações especiais: quando o cliente erra a resposta, quando ele simplesmente não responde, quando digita uma palavra-chave de atalho, e como o atendimento deve ser encerrado. Para acessar, clique no ícone de lápis do nó Configurações dentro do canvas. Todos os campos abaixo são opcionais, mas configurar os principais é o que garante que o fluxo se comporte de forma previsível em qualquer situação, e não apenas no caminho feliz em que o cliente responde exatamente o que se espera. Tabela de opções de distribuição automática de tickets:
Essa distribuição só vale quando um bloco do fluxo envia a conversa para uma fila. Se a conversa passar por um Agente de IA, é o agente quem transfere depois e esta opção não é usada: para distribuir, ligue a Distribuição Automática em Gestão Comercial → Filas, em cada fila para onde o agente transfere. O editor mostra esse aviso no card Distribuição automática de tickets.
Use a palavra-chave de ativação para permitir que o cliente reative o fluxo a qualquer momento, mesmo em meio a um atendimento humano em andamento.
O nó Configurações é o que evita os dois problemas mais comuns em chatbots mal planejados: o cliente ficar sem orientação ao errar uma resposta, e o ticket ficar aberto para sempre quando o cliente simplesmente some da conversa. Configure-o logo na criação do fluxo, antes de montar as etapas de conteúdo.
Todos os campos são opcionais, mas recomendamos configurar sempre, no mínimo, a mensagem de fallback (opção inválida), o máximo de tentativas e o timeout de inatividade; sem eles, o comportamento do bot em situações fora do previsto fica imprevisível. O campo “Fora do horário” aqui é diferente do nó “Tabela de horários” do canvas: não confunda os dois mecanismos.

Agente de IA no Fora do horário

No card Fora do horário do nó Configurações, a opção Agente de IA coloca um agente para responder fora do horário de atendimento (da empresa, da fila, de feriado ou do atendente), no lugar da mensagem de ausência. A opção aparece quando a empresa tem o recurso Agentes de IA.
  1. No canvas, clique no lápis do nó Configurações e, no card Fora do horário, escolha Agente de IA.
  2. Em Agente de IA, escolha o agente. A lista mostra só os agentes ligados que atendem clientes: agentes Só base e desligados não aparecem, e um agente já escolhido que depois foi desligado ou excluído aparece com a marca (inativo).
  3. Em Fila no início do expediente, escolha a fila que recebe a conversa quando o expediente começa.
  4. Clique em Salvar. Os dois campos são obrigatórios: sem eles, o fluxo não salva e avisa Escolha o agente de IA e a fila do início do expediente no “Fora do horário” antes de salvar.
A nota da tela resume: O agente responde fora do horário e sai quando o expediente começa. Quando o cliente escreve já dentro do horário, o agente sai e a conversa vai para a fila escolhida; se um atendente abrir a conversa antes, o agente sai na hora.
O ícone de ajuda ao lado dessa nota lembra quando a opção não age:
  • ela vale só para conversas que estão no fluxo;
  • a conexão precisa seguir o horário de atendimento: com Ignorar horário (atender 24h) em Controle de horário de atendimento, na edição do canal (Administração → Canais), a opção não age;
  • se a conexão tiver um agente de IA vinculado, ele vence o fluxo e esta opção não age;
  • com o agente desligado ou sem créditos de IA, a conversa vai direto para a fila escolhida;
  • LinkedIn, Mercado Livre, OLX, TikTok, YouTube, WooCommerce e Nuvemshop não usam esta opção.
Se o agente escolhido for desligado ou excluído depois, o cartão do fluxo, na lista de fluxos, mostra o selo Transferência inválida.

Criar um Fluxo de Conversa

1

Acesse o Chat Flow

Acesse Automação → Chat Flow. A tela mostra um cartão por fluxo, com nome, quantidade de nós, status (Ativo/Inativo), números para teste (quando houver: o cartão mostra os dois primeiros e +N para os demais; passe o mouse para ver todos), selos da audiência e data da última atualização; use Buscar fluxo… e a ordenação (Nome A→Z, Nome Z→A ou Atualizado recentemente) para encontrar um fluxo. Os ícones do cartão são Abrir editor do fluxo, Editar informações (nome, números para teste, ativo e audiência), Duplicar fluxo, Importar JSON e Excluir fluxo. O selo Transferência inválida indica que o fluxo transfere para um atendente, fila, canal ou etapa do Kanban que foi excluído, ou usa um agente de IA que foi excluído ou desligado (a dica mostra, por exemplo, Config. de fora de horário com agente de IA #123 excluído ou desligado): passe o mouse para ver onde está o problema e edite o fluxo apontando para um destino válido.
2

Crie o fluxo

Clique em Novo Fluxo e preencha os dados iniciais:
  • Nome do Fluxo: identificação interna (ex: “Atendimento Inicial”).
  • Números para Teste: deixe vazio para o fluxo funcionar com todos os contatos; preenchido, o bot responde somente para os números informados (ideal para validar antes de liberar). Digite o número completo, com código do país e DDD (ex.: 5511999999999), e aperte Enter ou vírgula: ele vira uma etiqueta e o campo fica livre para o próximo (sair do campo também adiciona o que foi digitado). Cabem até 15 números; para tirar um, clique no x da etiqueta. Dá para colar vários de uma vez, separados por vírgula, ponto e vírgula ou um por linha (como uma coluna de planilha). Tudo o que não é dígito (espaço, parênteses, traço) é descartado e número repetido não entra. Com menos de 8 dígitos, o número fica no campo e a tela avisa Número incompleto. Digite o número completo, com código do país e DDD (mínimo de 8 dígitos).; ao passar de 15, avisa Limite atingido. Remova um número para adicionar outro.
  • Ativo: liga ou desliga o fluxo.
  • Quando ativar (opcional): ligue Ativar filtros de audiência para definir quem dispara o fluxo: Público-alvo (Todos os contatos, Apenas clientes novos, Apenas retornantes ou Personalizado), Considerar novo se criado há até N dias, Tags obrigatórias (qualquer uma), Excluir contatos com tag, Coluna do kanban, Canais de origem e Prioridade. Ligue também Horário de funcionamento para o bot atender só dentro das faixas escolhidas (dias da semana, De e Até); fora delas, ele fica em silêncio.
Clique em Criar Fluxo. Com os filtros de audiência ligados, em cada novo atendimento o sistema percorre os fluxos ativos por prioridade e usa o primeiro que passa em todos os filtros; se nenhum passar, vale o fluxo vinculado ao canal.
3

Monte a estrutura no canvas

Abra o editor pelo ícone de lápis Abrir editor do fluxo. Crie os passos com o botão Passo e, no painel Blocos, arraste cada bloco (Mensagens, Roteamento, Integrações, CRM e ações) e solte sobre o passo em que ele deve acontecer.
4

Configure cada passo

Clique no ícone de lápis do passo (ou dê dois cliques nele) para abrir a edição, ajuste as interações na ordem em que devem acontecer e, se for o caso, configure a captura de variável.
5

Crie as conexões

Crie as conexões entre os blocos arrastando o ponto de saída de um bloco até o bloco de destino, escolhendo o tipo (Padrão, Automático ou Por palavras-chave).
6

Configure o nó Configurações

Configure o nó Configurações com o comportamento global do fluxo (mensagem de saudação, fallback, timeout, palavra de ativação etc.).
7

Teste com os números para teste

Use os Números para Teste cadastrados no passo 2 (por exemplo, o seu celular e o de um colega) para simular a conversa antes de liberar o fluxo para clientes reais.
8

Vincule o fluxo a um canal

Acesse Administração → Canais, clique em Editar no canal desejado, abra a seção Atribuições e escolha o fluxo no campo ChatFlow (bot); depois salve. O campo só fica disponível em canais já criados. A partir desse momento, as novas conversas daquele canal passam a ser conduzidas pelo fluxo (respeitando os filtros de audiência, quando ligados).
9

Ative o fluxo

Marque o fluxo como Ativo quando a configuração e os testes estiverem concluídos.
O Chat Flow permite atendimento contínuo (24 horas por dia, sete dias por semana) sem depender de alguém disponível para responder na hora, padroniza a primeira resposta ao cliente, faz a triagem inicial antes de acionar um humano e já entrega ao atendente um ticket com etiquetas, dados e contexto previamente coletados. É a ferramenta certa sempre que existir um padrão repetitivo de atendimento: menus de departamento, qualificação de leads, verificação de horário de funcionamento, coleta de dados estruturados antes da conversa humana, entre outros.
Dicas e observações importantes:
  • Os três blocos fixos (Início, Configurações, Boas-vindas) não podem ser excluídos do fluxo.
  • Um passo criado no canvas só é alcançado pelo cliente se algum passo anterior tiver uma condição apontando para ele. Antes de ativar o fluxo, confira no canvas se todo passo novo recebeu uma ligação; ao salvar, o editor também bloqueia condições que apontam para passos excluídos e marca o passo com erro.
  • Botões funcionam como elementos clicáveis em canais WABA, UazAPI, Baileys, Instagram e Messenger (até 3 botões; na UazAPI também há Opções extras (UazAPI) e rodapé). Lista funciona como menu clicável nos canais indicados no próprio bloco (WABA, UazAPI e Baileys); no Instagram e no Messenger, o contato recebe apenas o texto.
  • Quando o cliente responde a um story do Instagram com texto, é esse texto que o fluxo, o Agente de IA e as automações recebem. No atendimento, a mensagem aparece com a linha Respondeu ao seu story e o link Ver story, que só funciona enquanto o story está no ar (em geral, até 24 horas).
  • O botão JSON do editor baixa o fluxo, útil para guardar uma cópia de segurança. Por segurança, a chave e o ID da Organização (opcional) do bloco ChatGPT e o Valor de cada item dos Headers do Webhook Avançado saem no arquivo como ***, e a tela avisa Fluxo exportado sem as chaves e cabeçalhos secretos. Importado de volta no mesmo fluxo (Importar JSON no cartão do fluxo, na lista de fluxos), o arquivo mantém os valores já salvos. Para reaproveitar a lógica em outro fluxo, troque no arquivo cada *** pelo valor verdadeiro antes de usar Importar JSON no cartão do fluxo de destino: com *** sem valor salvo naquele fluxo, nada é gravado e a tela avisa Não foi possível salvar: digite de novo a chave oculta nestes passos:, seguido do nome dos passos.
  • No editor, esses mesmos valores, depois de salvos, voltam ocultos (***): deixe como estão para manter o valor salvo ou clique no campo e cole o novo valor por cima.
  • Um fluxo criado não entra em operação sozinho: ele precisa estar Ativo e vinculado a um canal (campo ChatFlow (bot)) ou, com os filtros de audiência ligados, ser o escolhido pela audiência em um novo atendimento.

Duplicar um fluxo

Na lista de fluxos, o botão Duplicar fluxo (ícone de cópia no cartão) cria uma cópia na mesma conta, com o nome do original seguido de “(cópia)”. A cópia mantém os números para teste, o público-alvo, a prioridade, o horário e o estado ativo ou inativo do fluxo original.
Se o original estiver ativo, a cópia também nasce ativa. Revise o público-alvo e desative uma das duas se não quiser dois fluxos disputando os mesmos contatos.
Dentro do editor, também dá para duplicar um único passo. A cópia do passo vem sem as ligações e sem os valores ocultos já salvos (a chave e o ID da Organização (opcional) do ChatGPT e o Valor dos Headers do Webhook Avançado): conecte os destinos dela e digite esses valores de novo antes de salvar.

Catálogo Completo de Interações

Quem usa: Administrador e Supervisor. As interações são as ações que o bot executa dentro de um passo. Um passo pode conter várias interações, executadas sempre em ordem, de cima para baixo. Elas são incluídas pelo seletor Adicionar interação, dentro da edição do passo, ou arrastando o bloco do painel Blocos e soltando sobre o passo. A seguir está o catálogo completo, agrupado por finalidade.
Regra importante para integrações externas: interações que passam o controle da conversa para sistemas externos (ChatGPT, Typebot, n8n, VAPI etc.) devem sempre ser a última interação da etapa. O motivo e os problemas causados por descumprir essa regra estão detalhados em Boas Práticas e Solução de Problemas.
Dentro de uma etapa, clique em “Adicionar interação”, escolha o tipo desejado na lista, preencha os campos específicos daquela interação e posicione-a na ordem correta em relação às demais interações da mesma etapa (mensagens e mídia primeiro, ações de CRM em seguida, integrações externas sempre por último).

Mensagens e mídia

Interações que enviam conteúdo diretamente ao contato.

Formulário do WhatsApp (Flow)

O bloco Formulário do WhatsApp (Flow), da categoria Mensagens, envia um formulário nativo do WhatsApp: o cliente toca no botão e preenche os campos sem sair da conversa. O que ele preencher vira variável do fluxo e, se você quiser, vai para o cadastro do contato. Não confunda com os Formulários de Gestão Comercial, que são páginas abertas por link.
  • O passo com o formulário espera o cliente preencher e segue pela condição Qualquer resposta: ao incluir o bloco, o editor troca a condição Automático (sem aguardar resposta) por Qualquer resposta, com o mesmo destino, ou cria uma Qualquer resposta para você escolher o destino. Esse passo não aceita a condição Automático.
  • Só cabe um formulário por passo, e Botões e Lista não ficam no mesmo passo do formulário (a tela avisa Botões e Lista não podem ficar no mesmo passo de um formulário do WhatsApp.).
  • As variáveis do formulário aparecem na condição Variável (contexto) e podem ser usadas nas mensagens dos passos seguintes.
  • Nos campos gravados no contato, o que o cliente preencher substitui o que está no cadastro. E-mail que já é de outro contato não é gravado, campo vazio nunca apaga o que já existe e o telefone nunca muda.
  • O editor não salva enquanto faltar o formulário, o texto da mensagem, o texto do botão ou um Nome das variáveis válido, nem com Botões ou Lista no passo, mais de um formulário no passo ou a condição Qualquer resposta sem destino; o aviso cita o passo. Dois formulários do mesmo fluxo também não podem ter nomes de variáveis que comecem um pelo outro (por exemplo, dados e dados_endereco).
  • O formulário só sai nos canais oficiais do WhatsApp. Nos outros canais, o Texto da mensagem vai como mensagem comum e o passo vira uma pergunta comum.
  • O formulário só chega com a conversa aberta (o cliente falou com você nas últimas 24 horas). Fora disso, use o bloco Template (HSM) com um template que tenha botão de formulário e ligue Guardar a resposta do formulário.
  • Se o atendimento estiver num número de outra conta do WhatsApp, o sistema tenta achar o formulário pelo nome; se não conseguir, manda o texto da mensagem.
Formulário pelo botão do Template (HSM): quando o template escolhido no bloco Template (HSM) tem um botão de formulário, aparece o quadro Guardar a resposta do formulário, com o aviso de que o template tem esse botão. Ele vem desligado. Ligado, o que o cliente preencher no formulário do botão vira variável do fluxo e pode ir ao cadastro do contato, com os mesmos campos Nome das variáveis, Campos do formulário, Reenvios e Mensagem antes de reenviar, e o passo espera o formulário e segue pela Qualquer resposta. Valem as mesmas regras: um formulário por passo e nada de Botões ou Lista no mesmo passo.

Roteamento

Interações que definem o destino do ticket ou controlam a atuação do bot.
Transferir encaminha o ticket, mas não bloqueia o bot automaticamente. Se o cliente mandar uma nova mensagem depois da transferência, o bot pode reinterpretá-la e responder de novo, por cima do atendente. Sempre que não quiser mais o bot atuando naquele contato, use Bloquear Chatbot logo depois do Transferir.

CRM e automação

Interações que registram informações e avançam processos internos, sem enviar mensagem ao cliente naquele momento.

Integrações externas

Interações que passam o controle da conversa para sistemas externos, ou acionam automações fora do PanÐá Zap.
Regra de ouro: posicione essas interações sempre como a última interação da etapa. Quando o sistema externo assume o controle, o fluxo interno não deve ter nenhuma outra ação depois dela na mesma etapa; caso contrário, os dois respondem ao mesmo tempo, gerando mensagens duplicadas ou comportamento imprevisível.
Chave do ChatGPT e endereço da conexão: se a conexão tiver uma URL Base da API (OpenAI) própria (seção ChatGPT da edição do canal), esse endereço recebe só a chave da própria conexão. Uma chave diferente digitada no bloco ChatGPT vai ao endereço padrão do provedor, salvo quando o endereço da conexão é local (localhost, rede interna) ou um dos gateways públicos OpenRouter, DeepSeek, Together, Groq, Mistral e xAI. Com um endereço sem autenticação (como o Ollama) que não seja local, use no bloco o mesmo texto da chave da conexão ou deixe a chave do bloco vazia.

Utilitários

Ter esse catálogo em mente antes de montar um fluxo evita o erro mais comum de quem está começando, que é tentar resolver tudo com mensagens de texto puro. Combinar blocos de mensagens com ações de CRM e, quando necessário, com integrações externas, é o que transforma o Chat Flow de um “menu automático” em uma ferramenta real de automação de processo.
Existe também uma interação especial chamada Agente de IA, que entrega a conversa para um agente de inteligência artificial configurado no módulo próprio de Agentes de IA. Ela é adicionada da mesma forma, pelo menu “Adicionar interação” dentro de uma etapa, mas por se tratar de uma funcionalidade com configuração própria (perfil, provedor de IA, base de conhecimento, roteamento, ações e ferramentas), ela é documentada em separado, na página Agentes de IA. O caminho também existe ao contrário: um Agente de IA pode devolver a conversa para um fluxo, usando um destino do tipo Fluxo no Roteamento do agente. Agentes marcados como Só base não aparecem na lista do campo Agente de IA da interação, porque não atendem clientes.
Respeite sempre a ordem recomendada dentro de um passo: mensagens e atrasos primeiro, ações de CRM em seguida e, por último, a interação que encerra a atuação do bot naquele passo: Transferir seguido de Bloquear Chatbot, ou uma integração que assume a conversa (Typebot, ChatGPT, Agente de IA ou n8n).

Distribuição Sequencial (Método “S”)

Quem usa: Administrador e Supervisor escolhem a opção Sequencial no campo Distribuição automática de tickets do nó Configurações do fluxo (ou em Estratégia de distribuição, na tela de Filas); a partir daí, a distribuição acontece sozinha a cada novo atendimento. A Distribuição Sequencial entrega os atendimentos que saem do bot em rodízio entre os atendentes online, um de cada vez e sempre na mesma ordem, para que ninguém concentre o volume.
1

Quem entra no rodízio

O sistema considera os atendentes online da fila de destino; se não houver fila, ou se ninguém dela estiver online, considera os atendentes online da empresa. Usuários com perfil Administrador não entram no rodízio, nem quem está marcado como Fora do rodízio de atendimentos no cadastro de usuários (essa pessoa continua online e recebe pela aba Pendentes ou por transferência).
2

Sem ninguém online

Se não houver nenhum atendente online, o atendimento não é atribuído por esse mecanismo.
3

Ordem do rodízio

O fluxo guarda quem recebeu o último atendimento e entrega o próximo ao atendente seguinte da lista; depois do último, a rotação volta ao primeiro.
É a opção certa quando o objetivo é justiça estrita na distribuição (todo atendente recebe, em algum momento, a mesma quantidade de tickets, em ordem), diferente da distribuição Aleatória (sem nenhum critério) ou Balanceada (que olha a carga atual de cada atendente, não a ordem). Veja o passo a passo prático de como habilitar essa opção em Chatbot com Fila Sequencial para Novos Atendimentos.
Administradores nunca entram na rotação, mesmo que estejam online. A distribuição sequencial só encontra para quem atribuir se houver atendentes online no momento; sem ninguém online, nenhum atendimento é atribuído por esse mecanismo.

Boas Práticas e Solução de Problemas

Quem usa: Administrador e Supervisor. Um guia consolidado de prevenção e diagnóstico, reunindo os erros mais comuns observados na operação de fluxos reais e como evitá-los ou corrigi-los.
  1. Planeje antes de montar. Abrir o canvas sem planejar é a causa número um de fluxos com comportamento imprevisível. Antes de criar qualquer etapa, responda: qual é a mensagem inicial? Quais opções o cliente pode escolher? O que acontece com cada resposta? Quando o bot transfere para um humano? O que acontece se o cliente não responder? E se ele responder algo inválido? Como o atendimento é encerrado? Um bom fluxo tem começo, meio e fim claros; fluxos sem finalização definida são a principal causa de bot respondendo quando não deveria.
  2. Garanta que toda etapa nova esteja conectada. Criar uma etapa no canvas não a torna visível para o cliente automaticamente: ela só passa a existir de fato quando alguma condição de uma etapa anterior aponta para ela. O erro clássico é criar, por exemplo, a etapa “Suporte”, mas esquecer de adicionar, na etapa “Menu principal”, uma condição que aponte para ela; o resultado é que o cliente nunca chega lá. A correção é sempre a mesma: volte à etapa anterior, adicione a condição faltante e aponte para a nova etapa. Ao salvar, o editor bloqueia condições que apontam para passos excluídos e marca o passo com erro; mesmo assim, confira no canvas se todo passo novo recebeu uma ligação, porque o botão Avisos mostra apenas lembretes gerais.
  3. Respeite a ordem das interações dentro de uma etapa. O bot executa as interações de cima para baixo, na ordem exata em que foram configuradas; essa é a ordem que o cliente efetivamente vive. A ordem recomendada é: primeiro mensagens e atrasos (o que o cliente vai receber), depois ações de CRM (etiqueta, kanban, oportunidade, notas), em seguida integrações externas (webhook, n8n, IA, quando necessário) e, por último, a transferência, sempre como ação final. Nunca coloque uma integração externa (Typebot, IA, n8n, VAPI) no meio de uma etapa com outras ações depois dela: quando a integração assume o controle, o fluxo interno pode continuar executando as interações seguintes em paralelo, gerando mensagens duplicadas, tickets extras ou comportamento inesperado.
  4. Impeça o bot de continuar respondendo depois da transferência, o problema mais relatado na operação. As causas mais comuns e a correção de cada uma:
  5. Cuide da posição de integrações externas. Interações como Typebot, ChatGPT, n8n, Dify ou VAPI passam o controle da conversa para fora do fluxo interno; a partir desse momento, o PanÐá Zap não deve continuar executando ações em paralelo na mesma etapa. Posicionar essas interações errado (com algo depois delas na mesma etapa) costuma causar: mensagens duplicadas (o bot interno e o Typebot respondendo juntos), tickets duplicados (o n8n reenviando o evento como se fosse uma nova mensagem), a IA respondendo depois que o atendimento já foi transferido para um humano, ou um webhook disparando várias vezes para a mesma conversa. A prevenção é sempre a mesma: deixe claro qual sistema controla cada momento da conversa, e quando o sistema externo assumir, encerre o bot interno naquele ponto.
  6. Use variáveis de forma sequencial. As variáveis capturadas em uma etapa ficam disponíveis apenas nas etapas seguintes. A regra prática é: capture na etapa N, use na etapa N+1. Funciona bem, por exemplo, capturar o nome na Etapa 1 e usar {{nome_cliente}} na mensagem da Etapa 2; evite capturar cinco variáveis em etapas diferentes para só montar um resumo final várias etapas depois, porque o comportamento pode variar dependendo de como o fluxo se ramifica pelo caminho. Quando o objetivo é enviar todos os dados coletados para um sistema externo, use um Webhook Avançado ao final do fluxo: ele monta o payload completo, com todas as variáveis capturadas até aquele ponto.
  7. Configure sempre o fallback e o máximo de tentativas, no nó Configurações do fluxo. Sem uma mensagem de fallback, o cliente que digitar algo fora do esperado simplesmente fica sem orientação nenhuma (exemplo de mensagem: “Não entendi sua resposta. Por favor, escolha 1 para Comercial ou 2 para Suporte.”). Sem um limite de tentativas (o padrão sugerido é 3), o mesmo cliente pode ficar preso indefinidamente em loop, respondendo coisas que o bot nunca vai entender.
  8. Fique atento a dois chatbots respondendo ao mesmo tempo. Isso acontece quando o canal tem mais de uma automação ativa simultaneamente, por exemplo o Chat Flow e, ao mesmo tempo, um Typebot ou uma IA configurada à parte. Os sinais são: o cliente recebe mensagens duplicadas ou fora de ordem, o bot responde depois que o atendente já assumiu, ou o atendente vê mensagens que não enviou. Para diagnosticar, verifique as configurações do canal e confirme quais automações estão realmente ativas nele, desativando ou organizando a prioridade entre elas.
Aplicar este checklist antes de ativar qualquer fluxo evita praticamente todos os problemas de comportamento imprevisível relatados na operação real (bot que não para de responder, mensagens duplicadas, tickets extras, clientes presos em loop).

Checklist de revisão antes de ativar um fluxo

Configuração básica
  • O fluxo está vinculado ao canal correto?
  • O fluxo está marcado como Ativo?
  • Os números para teste foram apagados (ou são só os certos para o ambiente de testes)?
Estrutura do fluxo
  • Todas as etapas têm ao menos uma condição apontando para algum lugar?
  • Existe uma condição “Qualquer resposta” como última opção em cada etapa com menu?
  • Nenhuma etapa criada ficou sem conexão com a etapa anterior?
Configurações do fluxo (nó Configurações)
  • Mensagem de fallback (opção inválida) configurada?
  • Máximo de tentativas definido, com uma ação de saída associada?
  • Timeout (ausência de resposta) configurado, com tempo e ação definidos?
  • Mensagem de despedida configurada, para quando o bot encerra o ticket?
  • Se o Fora do horário usa Agente de IA: o agente e a Fila no início do expediente estão escolhidos, a conexão segue o horário de atendimento (sem Ignorar horário (atender 24h)) e não tem um agente de IA vinculado?
Finalização
  • O fluxo tem uma saída clara para cada caminho possível?
  • “Bloquear Chatbot” está sendo usado depois das transferências?
  • As integrações externas estão na última posição de cada etapa?
  • Não sobrou nenhuma etapa “solta” no canvas, que o cliente nunca alcança?
Se o fluxo não funcionar como esperado, verifique também
  • O canal está conectado e ativo?
  • A conversa foi iniciada pelo cliente (e não pelo sistema)?
  • O atendimento já tinha sido assumido por um usuário antes de o bot agir?
  • Existe outra automação ativa no mesmo canal (Typebot, IA, n8n, Dify)?
  • A resposta do cliente corresponde exatamente ao valor configurado na condição?

Exemplos Prontos de Fluxo

Exemplo: Menu Departamentos

O que resolve: este é o fluxo mais comum de todos e serve de base para a maioria das operações: um menu inicial que direciona o cliente para um entre vários setores de atendimento. Cenário usado como referência: uma clínica odontológica com três setores (Agendamento, Financeiro e Suporte). Estrutura do fluxo:
Passo a passo para montar:
  1. Configure primeiro o nó Configurações, antes mesmo de montar as etapas: mensagem de saudação (“Transferindo para um atendente. Em breve alguém irá te atender!”), opção inválida (“Opção inválida. Por favor, escolha 1, 2 ou 3.”), tempo de inatividade (10 minutos, ação Fechar), mensagem ao encerrar por timeout (“Atendimento encerrado por inatividade. Se precisar, é só chamar!”) e máximo de tentativas (3, encaminhando para a fila “Geral”).
  2. Monte a etapa Boas-vindas (o menu principal, primeira coisa que o cliente vê): mensagem de texto do tipo “Olá, ! Seja bem-vindo(a) à Clínica Sorriso. Por favor, escolha uma opção: 1) Agendamento 2) Financeiro 3) Suporte”. Configure as condições: Igual a 1 leva a Agendamento, Igual a 2 leva a Financeiro e Igual a 3 leva a Suporte. Não é possível apontar uma condição para o próprio passo: respostas fora das opções são tratadas pela mensagem de Opção inválida e pelo Máximo de tentativas do bot, configurados no passo 1.
  3. Crie a etapa Agendamento com três interações em ordem: aplicar a etiqueta “Agendamento”, transferir para a fila “Agendamento” e, por fim, Bloquear Chatbot. Essa etapa não precisa de nenhuma condição de saída: é uma etapa terminal, o fluxo encerra ali para aquele cliente.
  4. Repita a mesma lógica para as etapas Financeiro (etiqueta “Financeiro”, transferir para a fila “Financeiro”, Bloquear Chatbot) e Suporte (etiqueta “Suporte”, transferir para a fila “Suporte”, Bloquear Chatbot).
Por que usar “Bloquear Chatbot” depois de transferir: sem essa interação, se o cliente mandar qualquer mensagem nova depois da transferência (mesmo algo simples como “Olá” ou “Ok”), o bot pode reinterpretar essa mensagem e responder de novo, por cima do atendente que já assumiu o ticket. Com o Bloquear Chatbot, o bot fica desativado para aquele contato especificamente, e o atendente segue sem interferência.
Resultado esperado: o cliente inicia a conversa, recebe o menu de boas-vindas com as três opções, responde por exemplo 2, recebe a etiqueta “Financeiro”, é transferido para a fila “Financeiro”, o bot é bloqueado para aquele contato, e o atendente do Financeiro recebe o ticket já com a etiqueta aplicada. Variações / dicas extras:
  • Adicionar um quarto setor: crie uma nova etapa, adicione uma nova condição “Igual a 4” apontando para ela e configure as interações da mesma forma que as demais.
  • Coletar o nome antes do menu: adicione uma etapa anterior à Boas-vindas com uma pergunta de nome, capture a variável correspondente e use {{nome_cliente}} no texto do menu; veja o passo a passo completo em Exemplo: Qualificação de lead com captura de dados.
  • Restringir o menu ao horário comercial: como a ligação do Início é fixa no primeiro passo, deixe esse primeiro passo sem interações, com uma condição Automático (sem aguardar resposta) apontando para um nó Tabela de horários, e direcione dele para o menu durante o expediente e para uma mensagem de ausência fora dele; veja Exemplo: Fluxo com horário de atendimento.

Exemplo: Qualificação de lead com captura de dados

O que resolve: um fluxo que coleta nome, interesse (plano) e e-mail do contato, aplica etiquetas ao longo do caminho e cria automaticamente uma oportunidade no Funil de Vendas, sem nenhuma intervenção humana até o momento certo de repassar o lead qualificado. Cenário de referência: uma empresa de software B2B que recebe leads pelo WhatsApp. Estrutura do fluxo:
Passo a passo para montar:
  1. Etapa Boas-vindas: mensagem pedindo o nome do cliente (ex: “Olá! Obrigado pelo interesse no nosso sistema. Vou te fazer algumas perguntas rápidas. Pode começar me dizendo seu nome?”). Configure a variável opcional com a chave nome_lead. Condição: “Qualquer resposta” leva à etapa seguinte, Captura de interesse. A variável salva exatamente o que o cliente digitar, por isso vale a pena fazer perguntas diretas, que esperem respostas curtas e objetivas.
  2. Etapa Captura de interesse: mensagem usando {{nome_lead}} e perguntando o plano de interesse (1 Básico ou 2 Pro). Configure as condições: igual a 1 ou contém básico/basico leva à etapa Plano Básico; igual a 2 ou contém pro leva à etapa Plano Pro; “Qualquer resposta” leva direto à Captura de e-mail, sem plano definido. Usar a condição Contém (em vez de apenas “Igual a”) é o que permite capturar variações naturais como “quero o básico” ou “estou interessado no Pro”, tornando o fluxo mais robusto sem precisar prever cada combinação possível de resposta.
  3. Etapas Plano Básico e Plano Pro: crie uma etapa para cada plano, e em cada uma delas configure apenas a interação de Etiqueta correspondente (“Plano Básico” ou “Plano Pro”), sem nenhuma mensagem. A condição de ambas é Automático (sem aguardar resposta) levando à Captura de e-mail: assim elas aplicam a etiqueta e passam adiante na hora, sem o cliente perceber a transição (com Qualquer resposta, o bot ficaria esperando uma nova mensagem do cliente).
  4. Etapa Captura de e-mail: mensagem pedindo o e-mail (ex: “Para finalizar, pode me informar seu e-mail?”). Configure a variável opcional com a chave email_lead. Condição: “Qualquer resposta” leva à etapa Finalização.
  5. Etapa Finalização (fecha o ciclo de qualificação): mensagem de agradecimento usando {{nome_lead}}; interação Oportunidade com nome Lead - {{nome_lead}}, pipeline “Novos Leads” e etapa “Qualificado”; interação Notas com o conteúdo Lead qualificado pelo bot. E-mail: {{email_lead}}; interação Transferir para a fila “Comercial”; e por fim Bloquear Chatbot. Esta etapa é terminal, sem condições de saída.
Resultado esperado: Variações / dicas extras: a regra das variáveis sequenciais se aplica aqui como em qualquer fluxo: capture a variável em uma etapa e use na etapa seguinte; não tente usar {{nome_lead}} etapas antes de efetivamente capturá-lo, porque o valor ainda não existe naquele ponto do fluxo. Para enviar todos os dados coletados a um CRM externo, adicione um Webhook Avançado na etapa de Finalização: ele monta o payload completo com {{nome_lead}}, {{email_lead}} e qualquer outra variável capturada durante a conversa.

Exemplo: Fluxo com horário de atendimento

O que resolve: direcionar o cliente de forma diferente dependendo do horário e do dia da semana, usando o nó Tabela de horários, sem precisar ativar e desativar o bot manualmente. Cenário de referência: empresa com atendimento humano de segunda a sexta, das 08h às 18h; fora desse período, o bot envia uma mensagem de ausência e encerra o ticket. Estrutura do fluxo:
Passo a passo para montar:
  1. No canvas, clique no botão Tabela de horários da barra de ferramentas para adicionar esse nó. Como a ligação do Início é fixa no primeiro passo (Boas vindas!), deixe esse passo sem interações e crie nele uma condição Automático (sem aguardar resposta) apontando para a Tabela de horários.
  2. Configure as faixas da Tabela de horários, clicando no lápis do nó: em Adicionar faixa, marque os Dias da semana de segunda a sexta, De 08:00 Até 18:00, com Rotear para Próximo passo: Menu; no Padrão (fallback) (aplicado quando nenhuma faixa bate), escolha Próximo passo: Mensagem de ausência.
  3. Monte o passo Menu (exibido apenas em horário comercial): mensagem com o menu (1 Comercial, 2 Suporte) e condições Igual a 1 e Igual a 2 roteando para cada setor; respostas fora das opções ficam com a mensagem de Opção inválida do nó Configurações.
  4. Crie as etapas Comercial e Suporte, cada uma com etiqueta própria, transferência para a fila correspondente e Bloquear Chatbot.
  5. Crie a etapa Mensagem de ausência, explicando o horário de funcionamento, seguida de uma Transferir para uma fila de acompanhamento (opcional, para registrar o lead e fazer follow-up depois) ou, se preferir simplesmente fechar o ticket, de uma condição Automático (sem aguardar resposta) com Encaminhar para: Fechar. Outra opção é escolher, no próprio Padrão (fallback) da Tabela de horários, Rotear para: Encerrar, com uma Mensagem de encerramento.
Resultado esperado: uma mensagem recebida às 14h de uma quarta-feira cai na branch “Seg-Sex 08h-18h” e segue normalmente para o menu; uma mensagem recebida às 20h de sexta-feira, ou no sábado às 10h, não encontra nenhuma branch de horário correspondente e cai na branch Padrão, recebendo a mensagem de ausência (e o ticket sendo encerrado, ou movido para a fila de acompanhamento, conforme configurado). Variações / dicas extras:
  • Aviso diferente no fim de semana: adicione uma segunda branch (Sábado e Domingo, dia inteiro) apontando para uma etapa própria de mensagem de final de semana.
  • Encaminhar para plantão fora do horário: na etapa “Mensagem de ausência”, troque o Encerrar por um Transferir para a fila “Plantão”.
  • Encadear tabelas de horário: a ação de uma branch pode apontar para outra Tabela de horários, em vez de uma etapa comum, permitindo regras mais complexas (por exemplo, uma tabela verifica o dia e outra verifica o turno). O sistema suporta até 3 tabelas encadeadas.
Atenção à janela de horário: o intervalo configurado é [início, fim), ou seja, início incluído e fim excluído; uma mensagem recebida exatamente às 18:00 não entra em uma janela configurada como 08h-18h. Além disso, a Tabela de horários usa o fuso horário do servidor onde o PanÐá Zap está instalado; confirme esse fuso antes de configurar as janelas, porque se o servidor estiver em UTC, por exemplo, as 08h do servidor podem não corresponder às 08h da sua operação.

Exemplo: Múltiplos horários e captura de nome

O que resolve: um uso mais avançado da Tabela de horários, com várias janelas diferentes, aproveitando o intervalo de pré-abertura para já capturar o nome do cliente antes mesmo de a equipe humana chegar. Cenário de referência: atendimento das 08h às 18h; fora desse período o bot informa a ausência; entre 07h e 07h59 (a “pré-abertura”) o bot avisa que vai abrir em breve e já coleta o nome do cliente, agilizando o atendimento assim que a equipe chegar.
Um conceito chave para montar este fluxo: a Tabela de horários funciona como um switch de programação. As faixas são avaliadas em ordem, de cima para baixo, e a primeira que casar com o horário atual determina o caminho seguido; quando nenhuma casa, vale o Padrão (fallback). Por isso, cadastre primeiro as faixas mais específicas.
Estrutura do fluxo:
Passo a passo para montar:
  1. Primeiro passo (Boas vindas!): a ligação do Início é fixa nesse passo. Deixe a lista de interações vazia e crie uma condição Automático (sem aguardar resposta) apontando para a Tabela de horários. Assim, o primeiro contato do cliente (por exemplo, ele mandando “Oi”) já leva direto à Tabela de horários, sem o bot precisar falar nada antes.
  2. Adicione o nó Tabela de horários pelo botão da barra de ferramentas e configure as faixas (Adicionar faixa), nesta ordem:
    • Faixa 1, pré-abertura: todos os dias, De 07:00 Até 07:59, Rotear para Próximo passo: Pré-abertura.
    • Faixa 2, madrugada: todos os dias, 00:00 às 06:59, Próximo passo: Fora de horário.
    • Faixa 3, noite: todos os dias, 18:00 às 23:59, Próximo passo: Fora de horário.
    • Faixa 4, almoço: segunda a sexta, 12:00 às 13:59, Próximo passo: Almoço.
    • Padrão (fallback), horário comercial: Próximo passo: Menu principal.
  3. Passo Pré-abertura: mensagem “Olá! Logo abriremos. Bom dia! Qual é o seu nome?”. Na seção Variável, preencha a Chave da variável nome_cliente com Tipo da variável Texto e crie a condição Qualquer resposta levando ao passo Confirmação. A chave é o nome pelo qual a resposta fica disponível no restante do fluxo ({{nome_cliente}}); use os tipos Número, E-mail, CPF, Telefone ou Data quando quiser validar o formato.
  4. Passo Confirmação: mensagem “Bom dia, ! Você será atendido(a) assim que nossa equipe chegar.”. Condição Automático (sem aguardar resposta) levando ao passo Aguardar.
  5. Passo Aguardar (passo de absorção): sem nenhuma interação configurada e com uma condição Qualquer resposta que não leva a lugar nenhum (permanece no próprio passo). Esse passo existe porque, depois da confirmação, o cliente pode mandar algo mais (“obrigado”, um emoji); sem um passo para “engolir” essas mensagens extras, o bot ficaria sem saber o que fazer. O bot permanece ali até um atendente assumir o ticket.
  6. Passo Fora de horário: mensagem explicando o funcionamento (segunda a sexta, 08h às 18h) e condição Automático (sem aguardar resposta) com Encaminhar para: Fechar.
  7. Passo Almoço: mensagem avisando do horário de almoço da equipe e condição Automático (sem aguardar resposta) com Encaminhar para: Fechar.
  8. Passo Menu principal: conecte ao menu de departamentos normal da operação (por exemplo, o mesmo do Exemplo: Menu Departamentos).
Depois que um atendente assume: quando alguém assume o ticket ainda durante o período de pré-atendimento, o nome do cliente já aparece visível no ticket, sem precisar perguntar de novo. Para encaminhar automaticamente para uma fila específica assim que o horário comercial começar, adicione as interações Transferir e Bloquear Chatbot no próprio passo Confirmação. Resultado esperado: uma mensagem às 07:30 cai na Pré-abertura, o bot pergunta o nome, o cliente responde “João” (variável nome_cliente = João), o bot confirma o bom dia e qualquer mensagem adicional do cliente cai na etapa Aguardar, sem resposta do bot. Uma mensagem às 03:00 cai na branch de madrugada e o ticket é encerrado com a mensagem de ausência. Uma mensagem às 12:30 em dia de semana cai na branch de almoço, também encerrando o ticket. Uma mensagem às 10:00 não casa com nenhuma branch específica e cai no Padrão, indo para o Menu principal. Variações / dicas extras:
  • Depois de salvar alterações no fluxo, limpe o cache da plataforma antes de testar novamente: mudanças recentes podem não aparecer de imediato em conversas já em andamento.
  • Para testar do zero, garanta que o ticket anterior esteja encerrado: um ticket ainda aberto retoma de onde parou, não recomeça pelo Início.
  • A mesma lógica de “janela de pré-visualização” pode ser reaproveitada para outros momentos, como uma mensagem diferente nos 15 minutos antes do almoço, ou nos últimos 30 minutos antes do encerramento do expediente.
  • Uma branch da Tabela de horários pode apontar para uma segunda Tabela de horários, útil quando as regras ficam muito complexas, por exemplo dias úteis com comportamento diferente de feriados.

Chatbot com Fila Sequencial para Novos Atendimentos

O que resolve: um chatbot simples que, ao receber um novo contato, envia uma mensagem de boas-vindas e coloca o lead em uma fila com distribuição sequencial entre os atendentes, ou seja, todo novo atendimento pendente é primeiro respondido automaticamente pelo bot, recebe a mensagem de boas-vindas e é direcionado, em ordem, ao próximo atendente disponível na fila. Pré-requisitos: pelo menos uma fila já criada com atendentes atribuídos, e um canal de WhatsApp configurado e ativo.
1

Criar o fluxo

Acesse Automação → Chat Flow, clique em Novo Fluxo, informe o Nome do Fluxo, deixe Números para Teste vazio (assim o fluxo vale para todos os contatos) e ligue Ativo. Clique em Criar Fluxo.
2

Configurar o fluxo do bot

Abra o editor (ícone de lápis Abrir editor do fluxo). No passo Boas vindas!, adicione uma interação Mensagem com as boas-vindas e uma pergunta simples (ex.: “Olá, como vai? Estamos direcionando você para um atendente. Qual é o seu nome?”). Em Condições, adicione uma condição Qualquer resposta com Encaminhar para: Fila e escolha a fila desejada. É na configuração da própria fila que o rodízio entre atendentes é definido; o bot apenas coloca o contato na fila escolhida. Salve o fluxo.
3

Vincular o fluxo ao canal

Acesse Administração → Canais, clique em Editar no canal desejado, abra a seção Atribuições e, no campo ChatFlow (bot), selecione o fluxo criado no passo 1. Salve o canal.
4

Configurar a distribuição sequencial na fila

Acesse Gestão Comercial → Filas, edite a fila escolhida no passo 2, ligue Distribuição Automática e, em Estratégia de distribuição, escolha a opção Sequencial (rodízio entre atendentes). Ajuste também o Limite de conversas por atendente e a Prioridade de envio e salve.
Estratégias disponíveis na tela de Filas (com Distribuição Automática ligada): Com a Distribuição Automática desligada, a fila não atribui sozinha: alguém precisa puxar a conversa na aba Pendentes. O funcionamento da opção Sequencial do Chat Flow está descrito em Distribuição Sequencial (Método “S”). Como validar: envie uma mensagem de teste para o canal pelo WhatsApp; verifique na aba Pendentes se o bot respondeu com a mensagem de boas-vindas; responda à pergunta do bot; confirme que o ticket foi para a fila e foi atribuído a um atendente. Repita com outro contato para conferir que o próximo atendente da vez recebeu.
Na fila, a Distribuição Automática só coloca uma conversa no rodízio se ela estiver sem atendente (não defina um atendente padrão no canal), sem automação em andamento, dentro do horário da fila e se houver um atendente online abaixo do limite que não esteja marcado como Fora do rodízio de atendimentos. A aba Pendentes continua funcionando: você ainda pode puxar conversas manualmente.

Regras Importantes a Ter em Mente

Transferir não interrompe o bot automaticamente. A ação Transferir apenas encaminha o ticket para uma fila ou usuário; se o cliente enviar uma nova mensagem depois da transferência, o bot pode reinterpretá-la e responder por cima do atendente. Sempre que não quiser mais o bot atuando naquele contato, adicione a interação Bloquear Chatbot logo depois do Transferir.
  • Typebot, ChatGPT, Agente de IA e n8n assumem a conversa: coloque-os sempre como a última interação do passo (o editor lembra disso em Avisos, junto com o Bloquear Chatbot).
  • Variáveis capturadas em uma etapa só ficam disponíveis a partir da etapa seguinte.
  • O sistema avalia conexões por palavras-chave antes da conexão Padrão; a Padrão é sempre o caminho de reserva.
  • Antes de ativar o fluxo, confira no canvas se todo passo novo recebeu uma ligação; ao salvar, o editor bloqueia condições que apontam para passos excluídos.
  • Para o checklist completo de revisão antes de ativar um fluxo, veja Boas Práticas e Solução de Problemas.