Principal Conhecendo os Fluxos Controlados Como lançar um novo Fluxo Controlado passo a passo

Como lançar um novo Fluxo Controlado passo a passo

Última atualização em Jun 24, 2026

Quando usar

  • Você precisa criar um novo Fluxo Controlado do zero (status de pedido, reset de senha, validação de plano etc.)

  • Você quer entender o caminho completo: do desenho até o teste em produção

  • Você precisa relembrar a estratégia correta de finalização (End Flow, Answer Ticket, Forward to Human, Close Ticket)

Pré-requisitos

  • Workspace no Fluxo Controlado criado para você (ainda não é criado por padrão — solicite ao time Cloud Humans)

  • Acesso ao Hub do projeto ClaudIA correspondente

  • Saber qual a fonte de dados que o Fluxo Controlado vai consultar (API ou Google Sheets)

Sobre este artigo

Este guia cobre todas as etapas de criação de um novo Fluxo Controlado: desde a definição do objetivo, passando pelo rascunho do fluxo, setup no builder, vinculação à ClaudIA, e finalmente os testes. Use-o como checklist ao construir um Fluxo Controlado do zero.

Passo a passo

Etapa 1 — Entender qual fluxo será construído

O primeiro passo para lançar um novo Fluxo Controlado é definir o objetivo. Será um Fluxo Controlado que comunica o status do pedido? Que verifica o plano do cliente? Que exclui a conta do usuário?

Para isso, identifique quais perguntas dos usuários devem acionar o novo Fluxo Controlado, como nos exemplos:

  • "Onde está meu pedido?" → Fluxo Controlado de status de pedido

  • "Esqueci a minha senha" → Fluxo Controlado de reset de senha

  • "Minha conta está bloqueada" → Fluxo Controlado de desbloqueio de conta

  • Validação de informação no início do atendimento → Fluxo Controlado inicial de validação

Etapa 2 — Desenhar o rascunho do fluxo

Recomendamos usar o Miro ou outra ferramenta de "White Board" para fazer o rascunho de cada etapa (uma espécie de fluxograma simplificado).

Você precisa entender:

  • A pergunta que o cliente fará para acionar este Fluxo Controlado

    Exemplo: "Onde está o meu pedido?"

  • As variáveis que devem ser mapeadas

    Exemplo: campo de ID do pedido do cliente

  • As fontes de dados que serão utilizadas pelo Fluxo Controlado

    Exemplo: Google Sheets ou API

  • As respostas que devem ser fornecidas ao cliente com base nas variáveis e nas consultas

    Exemplo: "O status do seu pedido é {{statusPedido}}"

Etapa 3 — Configurar o fluxo no Fluxo Controlado

Siga os passos abaixo no builder visual:

  1. Solicite a criação de um workspace no Fluxo Controlado (se ainda não tiver)

  2. Dentro do workspace, clique em Create a typebot para cada novo fluxo

  3. Selecione Start from scratch

  4. Inicie a construção do Fluxo Controlado

Para detalhes completos da construção, veja:

Etapa 4 — Vincular o fluxo à ClaudIA (seção INTERATIVA)

Para garantir que o Fluxo Controlado seja ativado pela ClaudIA:

  1. Não use textos genéricos na "response" da seção. Ela deve ser específica para o caso, sem se repetir em outras seções — isso otimiza o acionamento do Fluxo Controlado

    • Adequado (response específico):

    • Inadequado (genérico):

  2. Marque o Type da seção como INTERACTIVE (essa opção só fica disponível após o setup no Fluxo Controlado)

  3. Selecione o Flow ID do Fluxo Controlado correspondente

Pronto! Sua seção interativa está configurada. Você pode testar o comportamento integrado no Playground do Hub.

Etapa 5 — Revisar a estratégia de finalização

Cada terminação tem um propósito diferente — escolha com cuidado:

End Flow [N1]

Quando este card é utilizado, o fluxo é encerrado e o atendimento é passado para a ClaudIA. A bubble de texto configurada antes do End Flow é enviada para o cliente, e a ClaudIA continua o atendimento a partir dali.

Por isso, é ideal incluir na bubble algo como "como posso te ajudar?" ou "qual é a sua dúvida?" para que o cliente possa dar continuidade. Não há aproveitamento do contexto anterior da conversa nesse modo.

Ideal para Fluxos Controlados ativados a partir de uma seção específica da ClaudIA.

Answer Ticket [N1]

Quando este card é utilizado, a ClaudIA aproveita o contexto anterior da conversa para continuar o atendimento. Antes do Answer Ticket ser acionado, o cliente já pode ter mandado uma mensagem (um "oi" inicial, alguma dúvida) — a ClaudIA usa esse histórico.

A bubble de texto colocada antes do Answer Ticket não é enviada para o cliente. Ela é consumida pela ClaudIA como contexto interno. Por isso, não escreva uma pergunta nessa bubble — escreva contexto.

É obrigatório haver uma bubble de texto antes do Answer Ticket com algum conteúdo escrito. Sem isso, o funcionamento pode quebrar.

Ideal para casos em que o Fluxo Controlado inicia o atendimento.

Close Ticket [N1]

Encerra o ticket em N1. Se o cliente enviar nova mensagem, um novo ticket será aberto.

Forward to Human [N2]

Encerra o ticket pela ClaudIA e transfere para um agente do cliente (escalado N2).

Cuidados importantes:

  1. Preencha o campo Topic apenas se a ClaudIA possuir seções com diferentes topics (multiprompt)

  2. Sempre coloque uma bubble de texto antes do card Forward to Human [N2]

Etapa Final — Testar o Fluxo Controlado criado

Antes de substituir uma seção importante em produção, teste o Fluxo Controlado de três formas distintas:

1. Pelo próprio workspace do Fluxo Controlado

Use o botão Test no canto superior direito da página.

Tem limitações — não considera todas as integrações com a ClaudIA (ex: variável helpdeskId não está disponível). Mas é o jeito mais rápido de iterar.

2. Pelo Playground do Hub

Crie uma seção na base de conteúdo da ClaudIA que acione o Fluxo Controlado. Como o teste roda em produção, use um título improvável de ser usado por usuários reais — por exemplo: "Teste Fluxo Controlado - como eu faço uma poção polissuco com uma batedeira?".

Com a seção criada, envie a mensagem do título no playground.

3. Pelo canal oficial

Crie a mesma seção e envie a mensagem pelo canal real (WhatsApp, e-mail, widget). Útil para testar fluxos com validação por helpdeskId, que só funciona no canal real.

Observações