Quando usar
- Você precisa criar um novo fluxo Eddie 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 Eddie 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 Eddie vai consultar (API ou Google Sheets)
Sobre este artigo
Este guia cobre todas as etapas de criação de um novo Eddie: 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 Eddie do zero.
Passo a passo
Etapa 1 — Entender qual fluxo será construído
O primeiro passo para lançar um novo Eddie é definir o objetivo. Será um Eddie 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 Eddie, como nos exemplos:
-
"Onde está meu pedido?" → Eddie de status de pedido
-
"Esqueci a minha senha" → Eddie de reset de senha
-
"Minha conta está bloqueada" → Eddie de desbloqueio de conta
-
Validação de informação no início do atendimento → Eddie 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 Eddie
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 Eddie
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 Eddie
Siga os passos abaixo no builder visual:
-
Solicite a criação de um workspace no Eddie (se ainda não tiver)
-
Dentro do workspace, clique em Create a typebot para cada novo fluxo
-
Selecione Start from scratch
-
Inicie a construção do Eddie
Para detalhes completos da construção, veja:
Etapa 4 — Vincular o fluxo à ClaudIA (seção INTERATIVA)
Para garantir que o Eddie seja ativado pela ClaudIA:
-
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 Eddie
- Adequado (response específico):

- Inadequado (genérico):

-
Marque o Type da seção como INTERACTIVE (essa opção só fica disponível após o setup no Eddie)
-
Selecione o Flow ID do fluxo Eddie 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 Eddies 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 Eddie 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:
-
Preencha o campo Topic apenas se a ClaudIA possuir seções com diferentes topics (multiprompt)
-
Sempre coloque uma bubble de texto antes do card Forward to Human [N2]
Etapa Final — Testar o Eddie criado
Antes de substituir uma seção importante em produção, teste o Eddie de três formas distintas:
1. Pelo próprio workspace do Eddie
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 Eddie. Como o teste roda em produção, use um título improvável de ser usado por usuários reais — por exemplo: "Teste Eddie - 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
-
Para construir o fluxo via API: Como criar um fluxo no Eddie com API externa
-
Para construir o fluxo via Google Sheets: Como criar um fluxo no Eddie acessando informações em um Google Sheets
-
Para entender em detalhes cada terminação: Diferença entre terminações de fluxo: End Flow, Answer Ticket, Forward to Human e Close Ticket
-
Para usar todos os botões da plataforma: Como usar as funcionalidades e botões básicos do Eddie