Tutorial · Streaming
FlowBuilder para operação streaming
Este guia é para empresas com fluxo de teste, credenciais e revendas do painel.
Mostra como combinar o canvas visual com o motor de teste, IA e transferência humana.
Regra curta: o FlowBuilder é o orquestrador visual da conversa.
Ele decide o caminho. Já envio WhatsApp, IA, transferência humana e geração de teste
continuam sendo executados pelo backend do sistema.
O que acontece quando você cria um fluxo
- O fluxo nasce como rascunho.
- Enquanto estiver em rascunho, ele não assume o atendimento.
- Você pode montar os nós, salvar, simular e ajustar com calma.
- Depois de publicar e ativar, esse fluxo passa a controlar o atendimento da empresa.
Regra operacional importante
- A empresa pode ter vários fluxos cadastrados.
- Mas o sistema trabalha com um fluxo ativo por empresa.
- Desativar o fluxo faz o sistema voltar para o comportamento padrão.
Formato das variáveis
- No FlowBuilder, o formato oficial é
{nome_cliente}, {telefone}, {plano}.
- O backend substitui essas variáveis pelos dados da conversa quando elas existirem no contexto.
- Se a variável não existir naquele momento, aquele trecho tende a sair vazio.
O que o FlowBuilder anula quando fica ativo
Quando um fluxo está ativo para a empresa, ele passa a definir a lógica de entrada da conversa.
- A primeira mensagem automática e a triagem inicial deixam de depender só do comportamento padrão.
- O caminho do cliente passa a seguir seus nós e conexões.
- Se você criar menu, condição, IA e handoff no fluxo, esses pontos passam a conduzir a conversa.
Isso não apaga o resto do sistema. O FlowBuilder assume a orquestração.
As execuções especializadas continuam nas rotinas reais do backend.
O que ele não anula
Fluxo de teste
O nó de teste não recria sozinho o fluxo de teste. Ele só entrega a execução para o motor determinístico de teste do backend.
Agente de IA
O nó de IA não conversa por conta própria dentro do canvas. Ele marca o ponto em que a IA assume a conversa real.
Transferência humana
O nó de handoff não substitui a fila humana. Ele apenas manda o backend transferir o cliente.
Envios e integrações
Menus, mensagens e integrações WhatsApp continuam sendo enviados pelo backend.
Como montar um fluxo sem se perder
- Comece com um nó de Início.
- Coloque uma mensagem curta de abertura.
- Adicione um menu interativo se a empresa tiver caminhos claros.
- Use condição quando quiser decidir entre verdadeiro e falso com base em uma variável.
- Use IA quando a conversa pode ficar mais aberta.
- Use Gerar teste quando quiser mandar o cliente para o fluxo de teste oficial.
- Use Humano quando quiser tirar o cliente do fluxo automático.
- Feche com Encerrar quando o fluxo realmente deve terminar ali.
Boa prática: nomeie os nós pelo papel real deles, como Boas-vindas, Menu principal, Ir para teste, Suporte humano.
Atenção: condição sem ramo verdadeiro/falso e menu sem saída ligada são fontes clássicas de travamento.
Exemplo 1: uso normal de atendimento
Cenário: a empresa quer organizar a entrada em três frentes: financeiro, suporte e atendimento humano.
Início
→
Mensagem de boas-vindas
→
Menu interativo
1. Financeiro → Mensagem / cobrança
2. Suporte → IA
3. Humano → Transferência
- Se o cliente escolher financeiro, você pode mandar uma mensagem objetiva e encerrar.
- Se escolher suporte, a IA pode assumir depois de uma triagem curta.
- Se escolher humano, o fluxo transfere para a fila.
Exemplo 2: uso com fluxo de teste
Cenário: a empresa quer manter o fluxo de teste oficial, mas controlar melhor a entrada da conversa.
Início
→
Boas-vindas
→
Menu
→
Gerar teste
- O cliente escolhe
Quero um teste.
- O fluxo visual chega ao nó
Gerar teste.
- Nesse ponto, o FlowBuilder para e o backend entrega a conversa ao fluxo determinístico de teste.
- Dispositivo, apps, confirmação de instalação e credenciais continuam na rotina oficial do teste.
Em resumo: o FlowBuilder decide quando mandar para o teste.
O fluxo de teste real continua sendo o especialista nessa parte.
Exemplo 3: uso com agente de IA
Cenário: a empresa quer uma recepção guiada, mas depois quer que a IA assuma o suporte geral.
Início
→
Mensagem
→
Condição ou menu
→
IA
- O começo da conversa fica mais previsível e alinhado com a empresa.
- Quando o cliente entra no ponto de suporte aberto, o nó de IA faz a conversa ser assumida pela IA.
- Depois disso, a continuação deixa de ser guiada pelo canvas e passa a seguir o agente.
Exemplo 4: fluxo misto de teste + IA + humano
Esse desenho costuma funcionar muito bem para streaming:
Teste → motor de teste
Financeiro → mensagem / cobrança
Suporte técnico → IA
Problema delicado → humano
- Você ganha triagem clara logo no começo.
- Não joga todo mundo no mesmo atendimento.
- Preserva o fluxo de teste que já existe.
- Usa IA onde faz sentido e humano só quando precisa.
Quando usar e quando não usar
Use quando
- você quer padronizar a entrada por empresa
- precisa de menu e triagem clara
- quer decidir em que ponto chamar IA, teste ou humano
- quer um atendimento mais previsível
Não use como
- substituto total do fluxo de teste
- substituto completo do agente de IA
- atalho para fugir da lógica operacional já existente no backend
- canvas decorativo sem validar saídas
Dúvidas comuns da equipe
1. Se eu só salvar, ele já entra em produção?
Não. Salvar rascunho serve para editar. O efeito operacional vem quando o fluxo publicado e ativo passa a controlar o atendimento.
2. Posso ter vários fluxos por empresa?
Sim, mas o controle principal do atendimento fica com o fluxo ativo da empresa.
3. Se eu mandar para o nó de IA, o fluxo visual continua depois?
Na prática, não. O nó de IA é o ponto em que a conversa é entregue para a IA assumir.
4. Se eu mandar para gerar teste, o FlowBuilder faz todo o passo a passo?
Não. Ele só entrega para o fluxo de teste oficial do backend.
Checklist antes de publicar
- Existe um único começo claro para a conversa?
- Todo menu tem as saídas ligadas?
- Toda condição tem verdadeiro e falso?
- Está claro em que ponto a IA assume?
- Está claro em que ponto o humano assume?
- Se houver teste, o nó de teste está no ponto certo?
Resumo final
Pense no FlowBuilder como o roteador visual da conversa. Ele organiza a entrada e decide o próximo passo. Quando chega em teste, IA ou handoff, ele entrega para o especialista do backend continuar.
O melhor caminho quase sempre é começar simples, validar na prática e só depois sofisticar.