Principal Conhecendo o Eddie
📖

Conhecendo o Eddie

Fabrício Rissetto Winderlly Ian Kraskoff
Por Fabrício Rissetto and 3 outros
5 artigos

Como funciona a interação ClaudIA e Eddie

Interação: Cliente <> ClaudIA <> Eddie Explicação Detalhada do Fluxo Cliente envia mensagem: O cliente inicia o contato, enviando uma mensagem para a ClaudIA. A mensagem pode ser uma simples dúvida, uma consulta sobre o status de um pedido ou uma pergunta mais específica que requer um fluxo automatizado. ClaudIA interpreta a mensagem Ao receber a mensagem, a ClaudIA, que é alimentada por um modelo GPT, começa a processar o conteúdo. O modelo realiza uma análise linguística profunda para entender a intenção do cliente, o contexto da mensagem e identificar as entidades importantes. ClaudIA verifica o tipo de conteúdo Com a mensagem processada, a ClaudIA verifica qual é o tipo de resposta necessário: - Conteúdo N1: se a mensagem for simples e direta, a ClaudIA responde automaticamente com uma resposta da base de conhecimento. - Conteúdo N2: se a questão for mais complexa ou precisar de um atendimento humano, a ClaudIA transfere a conversa para a equipe N2. - Conteúdo Interativo: se a questão envolve uma consulta mais complexa (ex: consultar status de pedido, informações via API ou integração com Google Sheets), a ClaudIA ativa o fluxo do Eddie. Fluxo do Eddie (Conteúdo Interativo) Quando o conteúdo é interativo, a ClaudIA aciona o fluxo do Eddie. Este fluxo pode incluir: - Consultas (API, Google Sheets, prompt LLM, fluxos de árvore, java script, etc.): O Eddie faz as consultas definidas no fluxo, como verificar o status de um pedido ou buscar dados específicos. - Geração de resposta: A resposta gerada pelo Eddie é então enviada ao cliente. Finalização do Fluxo Após a execução do fluxo do Eddie, o atendimento pode seguir de diferentes maneiras: - Retorno para ClaudIA: se o fluxo foi configurado para retornar à ClaudIA, ela continua o atendimento. "End Flow [N1]". - Escalado para N2: se configurado, a conversa é escalada para a equipe N2 para um atendimento mais aprofundado "Forward to Human [N2]".

Última atualização em Dec 02, 2025

Passo a passo para lançar um novo Eddie

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

Última atualização em Dec 02, 2025

Básico de como usar as funcionalidades e botões do Eddie

Bem-vindo(a) ao guia definitivo sobre como construir fluxos com o Eddie, o builder visual do Cloud Chat. Aqui você vai entender o que cada botão faz, quando usar e como configurar — com exemplos práticos que te ajudam a decidir o melhor caminho para o seu caso. 🧱 Como funciona um fluxo? Um fluxo é como uma conversa guiada, com começo, meio e fim. - Ele pode começar com uma mensagem (ex: “Olá! Em que posso te ajudar?”) - O cliente responde (ex: “Quero saber o status do meu pedido”) - O Eddie entende e decide o que fazer com essa informação - E segue adiante: buscando dados, encaminhando, ou finalizando a conversa 💡 Cada etapa é um bloco, e você pode ligar blocos como quem monta um quebra-cabeça. 🔢 Tipos de blocos disponíveis 💬 Bubbles (Mensagens) 📌 Text (Texto) - O que é? Bloco usado para enviar mensagens visíveis ao cliente (ou usuário interno). - O que faz: Envia uma mensagem para o cliente. - Quando usar? Sempre que quiser exibir uma informação, confirmação, aviso ou instrução. - Como usar? Arraste o bloco para o fluxo, escreva sua mensagem no campo “Text” e pronto. - Exemplo: “Olá! Preencha o formulário a seguir para prosseguir com sua solicitação.” ✏️ Inputs (Coleta de dados) 📌 Text (Texto) - O que é? Coleta dados digitados pelo usuário: nome, código, número do pedido, etc. - Quando usar: Para saber o número do pedido, CPF, e-mail, ou qualquer outro dado. - Como usar? Posicione o bloco no fluxo, escreva a pergunta e defina a variável que vai armazenar a resposta (ex: nome_cliente). Exemplo: - “Qual o número do seu pedido?” - Armazene como: numero_pedido Logic (Lógica) Aqui começam as “decisões” do fluxo — como num “se isso, então aquilo”. 🔁 Set Variable (Definir variável) - O que é? Cria ou atualiza uma variável — uma “caixinha” onde você guarda um valor para reutilizar mais tarde no fluxo. - Por que é útil? - Reutilização: Você define uma vez e usa em vários lugares. - Organização: Deixa o fluxo mais limpo e legível. - Automação: Pode guardar o resultado de cálculos, integrações ou inputs. - Tomada de decisão: Pode ser usada em condições para decidir caminhos diferentes. - Como usar? 1. Arraste o bloco “Set Variable” para o fluxo. 2. Escolha uma variável existente ou crie uma nova (ex: tipo_usuario). 3. Atribua um valor: - Manual (ex: "cliente") - Vindo de outro ponto do fluxo (ex: resultado de uma API ou input) - Exemplos: - status_fluxo = "aguardando_validação" - desconto = 0.15 - mensagem_final = nome_cliente + ", sua solicitação foi recebida!" 🔍 Condition (Condição) - O que é? Verifica uma condição lógica (ex: se status == "aprovado") e direciona o fluxo com base na resposta. Ou seja, cria bifurcações: Se o valor X for Y, siga por este caminho; senão, vá por outro. - Como usar? 1. Arraste o bloco “Condition” 2. Escolha a variável a ser testada 3. Defina o valor a ser comparado (ex: status == "aprovado") 4. Configure o que acontece no “Sim” e no “Não” - Exemplo: Se cliente_tipo == "vip" → mostrar uma mensagem personalizada Senão → seguir com o fluxo padrão 💻 Script - O que é? - Bloco para quem sabe programar um pouco (JavaScript). - Permite rodar um código JavaScript dentro do fluxo — útil para cálculos, formatações, lógica avançada, etc. - Pode ser usado para calcular prazos, formatar números, ou coisas mais técnicas. - Como usar? - Arraste o bloco “Script” - Insira seu código JS - Defina variáveis de entrada e saída - Exemplo: Calcular dias entre duas datas, ou formatar um CPF com pontos. Atalhos e organização 🔄 Jump (Pular) - O que é? - Faz o fluxo “saltar” para outra parte sem passar pelos blocos intermediários. - Útil para reaproveitar partes ou encurtar caminhos. - Quando usar? - Para reaproveitar partes do fluxo - Para redirecionar em um “loop” - Para pular etapas desnecessárias com base em uma condição - Exemplo: Se tipo_usuario == "interno", pule direto para o bloco “Encerrar” 🔁 Typebot - O que é? - Permite embutir outro fluxo dentro do fluxo atual. - Permite encaixar um fluxo dentro de outro. - Quando usar? - Reaproveitar um fluxo genérico (ex: verificação de dados) - Modularizar o fluxo e facilitar manutenção - Exemplo: - Você pode criar um mini fluxo de “validação de CPF” e usá-lo em vários fluxos diferentes. 🔗 5. Integrações (conectar com outros sistemas) 🧠 ClaudIA - O que é? Integra com a IA da Cloud Humans para automação e inteligência nas respostas. Conecta com a ClaudIA para: - Transferir conversa para N1 ou N2 - Encerrar a conversa - Alterar o tópico ou contexto do atendimento - Como usar? Arraste o botão para o fluxo, defina a interação desejada com ClaudIA (ex.: transferir para N2, transferir de volta pra ClaudIA / N1, definir um tópico, etc.). 🌐 HTTP Request - O que é? Permite que o Eddie se conecte com APIs externas (GET, POST, etc.) - Como usar? - Arraste para o fluxo, configure o método (GET, POST, etc.), URL e parâmetros necessários. - Configure o método, a URL, os headers e o corpo da requisição - Use variáveis para enviar e receber dados - Exemplo de uso: Buscar status de pedido no seu ERP Pegar o status de um pedido em outro software 📊 Google Sheets - O que é? Integra com Google Sheets para ler ou escrever dados em planilhas. - Como usar? Arraste o botão, conecte à sua conta do Google, escolha a planilha e defina a operação (ler ou escrever dados). - Exemplo de uso: - Verificar se o CPF do usuário está em uma lista - Salvar os dados preenchidos no atendimento 🤖 OpenAI / Anthropic - O que é? - Permite enviar prompts para modelos LLM como GPT ou Claude e usar a resposta no fluxo. - Permite usar modelos de IA avançada para gerar respostas ou processar dados. - Como usar? Arraste, conecte ao serviço de IA desejado, e configure os prompts e parâmetros. - Exemplo de uso: - Resumo de uma explicação técnica - Geração de respostas com linguagem natural - Validação se o cliente escreveu é a opção 1, 2 ou 3 pra casos em que os clientes costumam mandar a opção errada 📅 Cal.com - O que é? - Permite agendamento de reuniões diretamente pelo fluxo - Integra com o Cal.com para gerenciar e agendar reuniões automaticamente. - Como usar? - Arraste o botão, conecte à sua conta Cal.com e configure as opções de agendamento. - Conecte sua conta Cal.com - Escolha o tipo de reunião e horários disponíveis 📤 Email - O que é? - Envia e-mails automáticos dentro do fluxo, diretamente pelo Eddie - Envia e-mails para o cliente ou equipe. - Como usar? Arraste, configure o destinatário, assunto e conteúdo do e-mail. - Exemplo de uso: Enviar um resumo da conversa ou um link de contrato ⚙️ Make / Zapier - O que é? - Conecta o Eddie com plataformas externas usando automações prontas - Essas plataformas de automação externa que ampliam ainda mais as possibilidades do Eddie. - Como usar? Arraste para o fluxo, conecte à sua conta da plataforma escolhida, e defina as automações e fluxos desejados. - Exemplo de uso: - Disparar uma automação no CRM - Atualizar uma base de leads 🛠️ Como montar seu primeiro fluxo do zero Exemplo: “Quero saber o status do meu pedido” 1. Mensagem inicial (Text) “Olá! Posso te ajudar a consultar o status do seu pedido.” 2. Pergunta (Input) “Qual o número do seu pedido?” → Guarde isso como numero_pedido 3. Condição (Condition) Se o número estiver preenchido, vá para o próximo passo. 4. Integração (HTTP Request) Faça uma consulta à sua API ou planilha com o número informado. 5. Mensagem final (Text) “O status do seu pedido é: {{status_pedido}}.” 🧠 Dicas para quem está começando - Use nomes claros para as variáveis. Exemplo: nome_cliente, tipo_plano, resposta_email - Pense como um roteiro: o que você diria se estivesse conversando com o cliente? - Teste no Playground sempre que terminar um trecho. - Comece simples: você pode ir melhorando aos poucos. - Se tiver dúvidas, pense: “o que eu quero que aconteça depois disso?” Agora você já sabe tudo sobre como aproveitar ao máximo cada botão e funcionalidade do Eddie! 🚀✨

Última atualização em Dec 02, 2025

Edição Colaborativa no Eddie

🔄 Como funciona a edição colaborativa no Eddie? O Eddie utiliza um sistema de fila para organizar múltiplos usuários no mesmo fluxo. - Apenas um usuário por vez pode editar (modo Editor) - Os demais ficam em modo Somente Leitura, acompanhando em tempo real. Quando o editor sai ou é removido por inatividade, o próximo da fila assume a edição automaticamente. 👥 Quem pode editar um fluxo? A ordem é definida pela chegada: 1. O primeiro usuário que abre o fluxo torna-se o Editor 2. Os demais entram automaticamente na fila de espera 3. Quando o editor atual sai, o próximo da fila recebe o controle de edição 🖥️ Quais são os modos de acesso? - Modo Edição → você pode arrastar blocos, alterar configurações e publicar alterações normalmente - Modo Somente Leitura → você pode visualizar todo o fluxo e até testá-lo, mas não pode editar 🔎 Como sei em qual modo estou? A interface mostra indicadores claros: - Modo Edição → aparece a barra lateral com blocos disponíveis e o botão Publicar: - - Modo Somente Leitura → aparece o aviso "SOMENTE LEITURA" na parte superior: - - O ícone de usuários conectados (👥) mostra quantas pessoas estão acessando o fluxo; passando o mouse, você vê: - O Editor em destaque (negrito) - Os demais usuários em visualização - - ⏳ O que acontece se eu ficar inativo? Para evitar bloqueios: - O Eddie monitora sua atividade - Se você ficar ~10 minutos inativo, perde a posição de edição - O próximo usuário na fila assume o modo Editor 🔄 Como passo a vez para outro usuário? Se quiser liberar a edição: 1. Salve suas alterações 2. Saia do fluxo 3. O próximo na fila ganha automaticamente acesso à edição 📑 Posso duplicar um fluxo para editar separadamente? Sim. Se não quiser esperar na fila para testar alguma alteração, você pode clicar em Duplicar e criar sua própria cópia editável. 💾 Minhas alterações são perdidas quando outro assume? Somente se você ficar inativo após os 10 minutos e não houver publicado as alterações.

Última atualização em Dec 02, 2025