Fluxos (bots de atendimento)

Crie o fluxo

Em Fluxos, clique em Novo fluxo. O editor abre com um fluxo chamado "Novo fluxo", só com o bloco Início, em Rascunho.

O rascunho é salvo sozinho a cada alteração (cerca de 1,5 s depois). No topo você vê o estado: Alterações não salvas, Salvo, Não salvou — tentar de novo ou Conflito.

Defina nome e gatilho (aba Fluxo)

No painel lateral, abra a aba Fluxo. Os ajustes daqui (gatilho, números e prioridade) valem assim que salvos, mesmo sem publicar.

• Identificação — nome e Descrição (opcional). Ex.: "Boas-vindas loja".
• Quando começar — o gatilho:
  • Nova conversa: primeira mensagem de um contato numa conversa nova. Quem já conversou com o número não dispara. Para testar com um contato antigo, use palavra-chave ou qualquer mensagem.
  • Qualquer mensagem: qualquer mensagem recebida quando não há bot rodando na conversa.
  • Palavra-chave: a mensagem tem uma das palavras (sem diferenciar maiúsculas e acentos). Em Como comparar escolha Mensagem exata, Contém ou Expressão regular (uma por linha, até 200 caracteres cada). Ex.: orçamento, preço.
  • Fora do horário de atendimento: mensagem recebida fora do horário configurado abaixo.
• Só quando a conversa não tem responsável — marcado, conversas já atribuídas não recebem o bot. Desmarcado, o bot também atende conversas com responsável; ele só não começa se alguém da equipe respondeu nos últimos 30 minutos.
• Também em grupos — por padrão o bot ignora grupos.
• Não recomeçar na mesma conversa antes de — intervalo mínimo entre duas execuções na mesma conversa (padrão 720 minutos = 12 h; 0 desliga). Evita que o cliente receba o menu de novo a cada "ok".
• Números — marque os números em que o fluxo vale. Sem nenhum número marcado, o fluxo vale para todos.
• Prioridade — quando mais de um fluxo ativo casa com a mensagem, vence a maior prioridade (empate: o mais antigo).
• Horário de atendimento — Fuso horário e faixas por Dia (Abre / Fecha). Sem horários = sempre aberto. É usado pelo gatilho "fora do horário" e pelas condições de horário.
• Falar com atendente — Palavras (ex.: atendente, humano): se o cliente mandar exatamente uma delas enquanto o bot espera resposta, a conversa vai para a equipe. Defina também Atribuir a (ninguém, responsável pelo número ou um Membro), Fila (opcional) (ex.: vendas) e Mensagem ao cliente (opcional) (ex.: "Certo! Vou chamar alguém da equipe.").

Adicione blocos

Na barra Blocos, clique num bloco (ou arraste-o para o quadro). Depois ligue a saída de um bloco à entrada do próximo. Selecione um bloco para editá-lo na aba Bloco.

No Menu de opções e no Perguntar você define ainda a mensagem para resposta inválida, o número máximo de tentativas (1 a 10, padrão 3) e o tempo de espera por resposta (0 = 24 h). Esgotadas as tentativas, o fluxo segue pela saída inválida; se ela não estiver ligada, a conversa é transferida para a equipe.

Use variáveis nos textos

Clique no seletor de variáveis do campo de texto para inserir, por exemplo:

• {{contact.name}} (Nome do contato), {{contact.first_name}} (Primeiro nome), {{contact.phone}} (Telefone);
• {{contact.field.cidade}} (um campo do contato), {{var.origem}} (uma variável do fluxo);
• {{last_input}} (Última resposta do cliente), {{flow.name}}, {{now.date}}, {{now.time}}.

Exemplo: Olá, {{contact.first_name}}! Como posso ajudar? Responda com o número da opção:. Variável desconhecida vira texto vazio.

Configure as ações

Em blocos Ações, em cada opção de menu e em cada resposta de pergunta você pode: Adicionar etiquetas / remover etiquetas (na conversa e, se quiser, no contato), Definir temperatura (frio, morno, quente), Definir qualificação, Definir responsável do contato, preencher um Campo do contato, mover para uma etapa do funil (cria a oportunidade "Oportunidade de {{contact.name}}"), Criar tarefa (com prazo em minutos), mudar o status da conversa, a Fila da conversa, Atribuir conversa e Definir variável.

Ex.: na opção "1 - Orçamento", adicione a etiqueta Lead quente, mova para a etapa Proposta e crie a tarefa "Ligar para {{contact.name}}" com prazo de 60 minutos.

Uma ação que falha fica registrada em Execuções com o erro, mas não derruba o fluxo.

Teste no simulador (aba Testar)

Informe o Nome do contato (ex.: "Maria Teste"), clique em Iniciar e responda como se fosse o cliente. O simulador mostra as mensagens do bot e o caminho percorrido.

O simulador não envia nada e não cobra nada. A Requisição HTTP não é executada nele (segue pela saída de sucesso).

Corrija os problemas

Sem bloco selecionado, a aba Bloco lista os problemas do fluxo (erros e avisos). Clique num item para ir até o bloco. Erros comuns: Bloco solto: nenhum caminho do início chega até ele, Esta saída tem mais de uma conexão, Escreva o texto, A URL precisa começar com https://.

Avisos não impedem a publicação; erros impedem.

Publique e ative

Clique em Publicar. Na janela Publicar versão N escreva as Notas da versão (opcional) ("O que mudou nesta versão?") e deixe marcado Ativar o fluxo para começar a atender assim que publicado.

Novas conversas passam a usar essa versão. Conversas que já estão com o bot continuam na versão em que começaram — editar o rascunho nunca muda uma conversa em andamento.

Acompanhe as execuções

Na aba Execuções (ou na lista de fluxos) veja cada conversa atendida, filtre por estado (Executando, Aguardando resposta, Esperando, Pausado (humano), Concluído, Falhou, Encerrado) e abra a Linha do tempo de passos. Você pode encerrar uma execução: o bot para de responder naquela conversa.