Principal Conhecendo o Eddie Como lançar um novo Eddie passo a passo

Como lançar um novo Eddie passo a passo

Última atualização em May 21, 2026

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:

  1. Solicite a criação de um workspace no Eddie (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 Eddie


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

Para garantir que o Eddie 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 Eddie

    • 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 Eddie)

  3. 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:

  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 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.

Test no workspace

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