Visão geral
O template Chatbot completo: menu, perguntas, negócio no CRM e tarefas entrega um atendimento automático de ponta a ponta, pronto para produção, que se adapta sozinho ao canal em que a conversa acontece:
- Em canais com suporte a mensagens interativas (WhatsApp, chat do site, Telegram, Messenger, Instagram e API), o menu aparece como botões.
- Em canais somente-texto (e-mail, SMS), o mesmo menu vira automaticamente uma lista numerada — e o contato pode responder com o número ("2"), com o texto da opção ou tocando no botão: todas as formas funcionam.
Todo o conteúdo (mensagens, botões e até as palavras-chave de entendimento) é criado no idioma da sua conta — português, inglês ou espanhol.
Pré-requisitos
- Módulo Flow Builder ativo e permissão de Admin para editar e publicar.
- Módulos CRM e Tarefas ativos para executar todas as trilhas do template.
- Uma caixa de entrada configurada e uma equipe com agente elegível para o handoff humano.
Passo a passo
- Abra Fluxos → Modelos e escolha Chatbot completo.
- Aplique o modelo e revise mensagens, palavras-chave e o funil padrão do CRM.
- Confira as variáveis
lead_name,lead_email,lead_need,lead_valoreduvidano painel de dados. - Use Executar teste com uma conversa de teste e percorra vendas, suporte e handoff.
- Publique e vincule o fluxo às caixas desejadas somente depois de validar todas as saídas.
Configurações & opções
- Menu inicial com três caminhos: Orçamento e vendas · Suporte e dúvidas · Falar com um atendente.
- Trilha de vendas — pergunta o nome, o e-mail (validado), a necessidade e o valor em mente
(somente números). Com as respostas:
- cria um negócio no CRM (funil padrão) com o título "Oportunidade — {nome}", o valor informado, moeda BRL e prioridade alta;
- registra uma nota no negócio com todas as respostas mapeadas;
- cria uma tarefa "Retornar orçamento para {nome}" com prazo de 1 dia;
- confirma ao contato e transfere para um humano.
- Trilha de suporte — pergunta a dúvida e responde automaticamente FAQs de preço e de horário; qualquer outra dúvida vira uma tarefa e vai para um atendente.
- Atendente humano — a qualquer momento, a opção 3 transfere direto.
- Sem resposta válida — depois de 2 tentativas com reorientação, o contato é encaminhado a um humano (nunca fica preso).
Casos de uso
- Qualificação de leads com criação de negócio, nota e tarefa de retorno.
- Triagem de suporte com respostas rápidas e encaminhamento das dúvidas não reconhecidas.
- Menu omnichannel único para WhatsApp, site, e-mail e SMS.
Dicas, limites e boas práticas
- Os botões e as listas usam os mesmos itens: editar o menu num lugar atualiza o comportamento em todos os canais.
- As respostas de FAQ casam por palavras-chave no idioma da conta (ex.: "preço", "valor", "custa") — adicione as suas nos nós de condição.
- O valor informado entra no negócio em unidades inteiras (4900 = R$ 4.900,00).
- Recursos interativos dependem da capability real do canal; configure sempre o fallback de texto.
Solução de problemas
- Se uma ação for omitida, abra o trace e confirme se CRM/Tarefas estão ativos e se o registro-alvo existe.
- Se o handoff falhar, confirme que a equipe pertence à conta e possui agente elegível na caixa.
- Se uma resposta não casar, revise o tipo de entrada, as opções e o limite de tentativas do nó de espera.
Veja também
- Flow Builder: construir fluxos conversacionais visualmente
- Flow Builder: dados do gatilho, mapeamento e transformação
- Flow Builder: formulários de ação
Respostas HTTP grandes e idempotência
Em HTTP request, desative Guardar a resposta completa para salvar apenas os campos de Mapeamento da resposta. O corpo bruto e a variável principal não são gravados na sessão nem no histórico. O padrão dos fluxos existentes permanece ligado. Nesse modo, o total lido da API, incluindo páginas, é limitado a 1 MiB; os valores mapeados somam até 256 KiB. Campo excessivo fica vazio e gera um aviso, preservando os campos pequenos. Os limites de saída do nó e estado da sessão continuam ativos. O teste de requisição ainda mostra a resposta para configurar o mapeamento.
Em Cabeçalhos de idempotência, use X-Idempotency-Key ou Idempotency-Key com uma chave estável por operação. Autenticação e os demais cabeçalhos ficam na credencial do cofre. Uma chave não garante que a API externa suporte idempotência. Timeout e falha depois de uma consulta paga não confirmam ausência de cobrança: trate a saída de erro sem repetir automaticamente.
Timeout HTTP estendido por conta
O timeout padrão continua em 15 segundos, com teto de 30 segundos sem configuração. Um administrador pode alterar flow_builder_http_timeout_seconds pela atualização canônica da conta (PATCH /api/v1/accounts/:id), usando inteiro de 1 a 120; null restaura o teto de 30. O campo timeout_seconds do nó e do teste de requisição respeita esse teto. O corpo do nó não pode elevar a autoridade da conta.
Acima de 30 segundos, o tempo é um orçamento total da operação HTTP, incluindo páginas e leitura da resposta. O lease do passo HTTP cobre esse limite com margem. Os modos legados mantêm o timeout por página; webhooks não mudam. Um timeout pode ocorrer depois de o fornecedor cobrar: siga pelo caminho de erro para registrar uma nota ou transferir, sem repetir uma consulta paga sem reconciliação. Resultados ambíguos de um worker interrompido continuam exigindo revisão manual.
A prévia síncrona também respeita o prazo disponível do servidor web, reservando dois segundos para responder. Se o prazo solicitado não couber, a requisição externa não é iniciada e a prévia explica o motivo. Isso não reduz o prazo do nó no worker. Em paginação, a amostra inteira deve caber nessa janela.