Principal Eddie | Conecte seu backoffice Passo a passo para lançar um novo Eddie

Passo a passo para lançar um novo Eddie

Última atualização em Aug 09, 2025

[Passo 1] Entendendo qual fluxo será construído

O primeiro passo para lançar um novo Eddie é definir qual o seu objetivo. Será um Eddie que comunica o status do pedido do cliente? Será um Eddie que adiciona verifica o plano do cliente? Será um Eddie que excluirá a conta do usuário?

Para tal, deve-se entender quais as perguntas feitas pelos usuários que deverão acionar o novo Eddie, como nos exemplos abaixo de pergunta do usuário/Eddie:

  • "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 alguma informação no início do atendimento → Eddie inicial de validação

[Passo 2] Desenhando o rascunho do fluxo que será construído

Recomendamos o uso do Miro ou alguma ferramenta digital de "White Board" para fazer o rascunho de cada etapa (uma espécie de fluxograma simplificado).

Você precisará entender:

  • A pergunta que o cliente fará que acionará este Eddie

    Por exemplo: "Onde está o meu pedido?"

  • As variáveis que devem ser mapeadas

    Por exemplo: campo de ID do pedido do cliente

  • As fontes de dados que serão utilizadas pelo Eddie

    Por exemplo: Google Sheets ou API

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

    Por exemplo: "O status do seu pedido é {{statusPedido}}"

[Passo 3] Setup do fluxo no Eddie

Este guia fornece instruções passo a passo para o setup de um fluxo no Eddie.

Siga os passos abaixo:

Passo 1: Solicite a criação de um workspace no Eddie para você (ele ainda não é criado por padrão).

Passo 2: Dentro do workspace, clique em "Create a typebot" para cada novo fluxo de Eddie, depois selecione "Start from scratch" para criar um Eddie.

Passo 3: Inicie a construção de um novo Eddie.

Para ver em mais detalhes como construir um fluxo Eddie completo: Como criar um fluxo no Eddie via API ou Como criar fluxo no Eddie via Google Sheets

[Passo 4] Setup na ClaudIA (vincular o fluxo criado a uma seção INTERATIVA)

Este guia explica como garantir que o Eddie será ativado pela ClaudIA.

Passo 1: Não utilize textos genéricos na "response" da seção atualizada/criada. É essencial que ela não se repita em outras seções a fim de otimizar o acionamento do Eddie.

Exemplo de seção adequada (com "response" específico para o caso):

Exemplo de seção inadequada (genérica):

Passo 2: Certifique-se de que o Type da seção esteja marcado como "INTERACTIVE". Esta opção só se torna disponível após o Setup no Eddie.

Passo 3: Selecione o Flow ID do fluxo Eddie no qual você quer que seja acionado quando essa seção for utilizada.

Pronto! Sua seção interativa está completamente configurada. Você pode testar o comportamento integrado entre ClaudIA <> Eddie diretamente na tela de Playgroud do Hub.

[Passo 5] Revisar a estratégia de finalização dos fluxos do Eddie

End Flow [N1]

Quando este card é utilizado, o ticket não será encerrado ao final da atuação do Eddie e o cliente voltará a interagir com a ClaudIA. Ideal para Eddies ativados através de alguma seção da ClaudIA.

Answer Ticket [N1]

Ao ser utilizado, este card impede o encerramento do ticket ao final da atuação do Eddie, permitindo que o cliente retome a interação com a ClaudIA. Se o atendimento for iniciado pelo Eddie, a ClaudIA responderá à primeira mensagem do usuário, tornando-o ideal para casos em que o Eddie inicia o atendimento. É importante destacar que é necessário haver um card de Bubble de texto antes do Answer Ticket, com algum conteúdo escrito. Sem isso, o funcionamento pode ser comprometido, resultando em erro no Eddie.

Close Ticket [N1]

Quando este card é utilizado, o ticket será fechado em N1. Caso o cliente envie uma nova mensagem, um novo ticket será aberto.

Forward to Human [N2]: Quando este card é utilizado, o ticket será encerrado pela ClaudIA e transferido a 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 será necessário colocar um bubble de texto antes do card de Forward to Human [N2] quando este for utilizado.

[Passo Final] Testando o Eddie que foi criado

Testando um novo Eddie

Antes de disponibilizar um novo fluxo e substituir uma seção importante, é fundamental testar o Eddie para mapear oportunidades de melhoria.

Recomendamos realizar testes de três maneiras distintas:

  1. Pelo próprio workspace do Eddie

  2. Pelo Playground do Hub

  3. Pelo canal oficial

1. Pelo próprio workspace do Eddie

Os testes no próprio workspace do Eddie podem ser feitos através do botão "Test", no canto superior direito da página.

Embora tenha algumas limitações por não considerar todas as integrações com a ClaudIA, como não possibilitar testes com a variável helpdeskId, é uma maneira bastante útil por ser mais rápida, permitindo múltiplos testes em um curto período de tempo.

2. Pelo Playground do Hub

Para testar o Eddie pelo Playground do Hub, é necessário criar uma seção na base de conteúdo na ClaudIA que acione o Eddie. A dica aqui é criar uma seção que muito provavelmente não será utilizada pela ClaudIA para responder a um usuário, visto que atualmente este teste ocorre em produção.

Para isso, basta criar um título com um conteúdo que os usuários provavelmente não perguntariam, como "Teste Eddie - como eu faço uma poção polissuco com uma batedeira?".

Com a seção criada, basta enviar a mensagem do título da seção (Teste Eddie - como eu faço uma poção polissuco com uma batedeira?) no playground.

3. Pelo canal oficial

Assim como no teste através do Playground, para testar via canais oficiais, como WhatsApp, e-mail ou widget, é necessário criar uma seção na base de conteúdo na ClaudIA. Para isso, basta seguir os mesmos passos do teste no Playground, mas, ao invés de enviar uma mensagem pelo Playground, a mensagem deve ser enviada através do canal oficial escolhido.

Esta opção é útil para testar fluxos que fazem algum tipo de validação com base no helpdeskId.