Conceitos-base
Antes de montar o primeiro fluxo, vale entender quatro conceitos que aparecem em toda a documentação do Chat Flow: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:Barra de ferramentas do canvas
Na barra de ferramentas do canvas você encontra: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.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.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.
Variáveis Disponíveis
Use{{variável}} dentro de qualquer mensagem de texto para personalizar a conversa automaticamente:
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.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.- No canvas, clique no lápis do nó Configurações e, no card Fora do horário, escolha Agente de IA.
- 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).
- Em Fila no início do expediente, escolha a fila que recebe a conversa quando o expediente começa.
- 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.
Criar um Fluxo de Conversa
Acesse o Chat Flow
Crie o fluxo
- 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.
Monte a estrutura no canvas
Configure cada passo
Crie as conexões
Configure o nó Configurações
Teste com os números para teste
Vincule o fluxo a um canal
Ative o fluxo
- 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.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. 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,
dadosedados_endereco).
Roteamento
Interações que definem o destino do ticket ou controlam a atuação do bot.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.Utilitários
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.Quem entra no rodízio
Sem ninguém online
Ordem do rodízio
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.- 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.
- 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.
- 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.
- 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:
- 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.
- 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. - 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.
- 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.
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)?
- 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?
- 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?
- 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?
- 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:- 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”).
- 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
1leva a Agendamento, Igual a2leva a Financeiro e Igual a3leva 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. - 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.
- 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).
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:- 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. - 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 a1ou contémbásico/basicoleva à etapa Plano Básico; igual a2ou contémproleva à 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. - 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).
- 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. - Etapa Finalização (fecha o ciclo de qualificação): mensagem de agradecimento usando
{{nome_lead}}; interação Oportunidade com nomeLead - {{nome_lead}}, pipeline “Novos Leads” e etapa “Qualificado”; interação Notas com o conteúdoLead 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.
{{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:- 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.
- 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.
- Monte o passo Menu (exibido apenas em horário comercial): mensagem com o menu (1 Comercial, 2 Suporte) e condições Igual a
1e Igual a2roteando para cada setor; respostas fora das opções ficam com a mensagem de Opção inválida do nó Configurações. - Crie as etapas Comercial e Suporte, cada uma com etiqueta própria, transferência para a fila correspondente e Bloquear Chatbot.
- 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.
- 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.
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.- 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.
- 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.
- 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_clientecom 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. - 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.
- 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.
- 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.
- 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.
- Passo Menu principal: conecte ao menu de departamentos normal da operação (por exemplo, o mesmo do Exemplo: Menu Departamentos).
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.Criar o fluxo
Configurar o fluxo do bot
Vincular o fluxo ao canal
Configurar a distribuição sequencial na fila
Regras Importantes a Ter em Mente
- 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.

