Principal Eddie | Conecte seu backoffice
💾

Eddie | Conecte seu backoffice

O Agente de comunicação em tempo real que conecta a ClaudIA com seu backoffice e muito mais
Fabrício Rissetto Winderlly Ian Kraskoff
Por Fabrício Rissetto and 3 outros
• 14 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 Aug 09, 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 Aug 09, 2025

Troubleshooting e outras dicas

Potenciais problemas ao utilizar os "Inputs" do Eddie 1. Buttons Atualmente, o Input "Buttons", ou "Botões", não funciona na ClaudIA. Embora os testes funcionam no workspace do Eddie, esta feature não é comportada pela ClaudIA. Neste caso, recomendamos o uso de uma Bubble - Text informando, de maneira numerada, as possibilidades de resposta disponíveis pelo usuário, seguido de um Logic - Condition: 2. Placeholder O campo "Placeholder" contido nos cards de "Input" permitem que o Eddie captura um dado que o cliente já envio no chat para a ClaudIA de forma automática, sem a necessidade de fazer a pergunta. Para isso, basta preencher este campo com uma descrição de qual dado está sendo coletado. Quando preenchemos esse campo, ele funciona como um prompt para busca automática no ticket. Por exemplo, se escrevermos "E-mail do usuário", quando houver um e-mail no ticket, o Eddie vai identificá-lo automaticamente e atribuir à variável definida. Com isso, a response da seção interativa não é acionada, evitando que a informação seja solicitada duas vezes. Variáveis 1. HelpdeskId Por padrão, os fluxos do Eddie são construídos para solicitar ao cliente todas as informações necessárias (como número do pedido, email, etc) para concluir uma solicitação. No entanto, essas informações muitas vezes já foram fornecidas anteriormente na conversa. Isso pode levar o Eddie a perguntar novamente, causando uma experiência de usuário ruim. Desenvolvemos um extrator de variáveis capaz de analisar o histórico da conversa, coletar os dados necessários e enviá-los para o Eddie no momento da ativação, eliminando a necessidade de perguntar novamente aos clientes. Características: - O extrator verifica o fluxo do Eddie dinamicamente para saber quais variáveis precisam ser coletadas. - A extração é feita pelo GPT, por meio de um prompt definido no próprio código da ClaudIA. - Os dados coletados podem ser conferidos na auditoria do Hub. - O helpdeskId sempre é enviado. O helpdeskId é o ID utilizado para localizar um ticket específico. Para que esta informação seja utilizada pelo Eddie, nenhuma integração adicional é necessária. Para isso, basta criar um card de "Condition", como na imagem abaixo: Configurações: A configuração é feita dentro do fluxo do Eddie. Para que uma variável seja extraída, as seguintes condições precisam ser cumpridas: - Deve exisitr um bloco de input com o placeholder preenchido, descrevendo a variável (Ex.: Número do pedido no formato IN-XXXXXX). - A variável precisa ser precedida por um condicional is set, que verifica se ela possui um valor preenchido ou não. Dessa forma, podemos controlar o que acontece no fluxo caso ela já tenha sido preenchida pelo extrator. Importante: A variável "helpdeskId" deve ser criada e escrita exatamente como indicado acima: todas as letras devem ser minúsculas, com exceção do "i" em "Id". Acionamento do Eddie pela ClaudIA 1. Como um Eddie é acionado Um Eddie é acionado pela ClaudIA através da feature de "seção utilizada", detalhada neste artigo. Passo a passo: 1. Usuário envia uma mensagem; 2. ClaudIA analisa as "responses" das seções disponíveis; 3. ClaudIA envia ativa o Eddie da seção com a "response" mais adequada à mensagem do cliente; 4. Caso ClaudIA selecione duas seções de Eddie, será acionado o Eddie da seção de maior score. 2. Como ocultar a "response" da seção interativa Para que a "response" seja omitida, o Eddie precisa ter acesso a primeira variável coletada no fluxo. Por exemplo, caso a "response" contenha o texto "Qual o número do seu pedido?", a ClaudIA omitirá esta pergunta, caso o usuário já tenha informado o número do pedido. Para que este mecanismo funcione, é necessário preencher o campo "Placeholder" no card de coleta da variável.

Última atualização em Aug 09, 2025

Monitoramento e Melhoria Contínua dos Fluxos no Eddie

Para garantir que os fluxos operem corretamente, é essencial monitorar os processos da ClaudIA e do Eddie. Temos uma plataforma chamada HUB, onde todas as interações que passaram pela ClaudIA ficam registradas. No HUB, é possível visualizar os atendimentos, acompanhar fluxos chamados pelo Eddie e identificar oportunidades de melhoria, garantindo um atendimento cada vez mais eficiente e bem monitorado. Visão geral do HUB: Tela principal exibindo o histórico de conversas da ClaudIA O HUB funciona como um painel central que permite auditar, analisar e aprimorar o atendimento ao cliente. Ele oferece uma visão detalhada do fluxo das conversas, ajudando na identificação de possíveis gargalos e facilitando ações para otimização contínua. Rastreamento de Fluxo no HUB: Exemplo de conversa com a indicação do início do fluxo no Eddie e o sinalizador de retorno para a ClaudIA ao final da interação. Funcionalidades do HUB ✔ Registro completo das conversas: todas as mensagens trocadas entre os clientes e a ClaudIA ficam armazenadas para análise e auditoria. ✔ Monitoramento dos fluxos do Eddie: sempre que a ClaudIA aciona um fluxo do Eddie, o HUB exibe uma sinalização com o nome do fluxo e as mensagens trocadas dentro dele, permitindo rastrear a jornada do cliente. ✔ Indicação do fim de fluxo: quando um fluxo é finalizado, há uma sinalização de retorno para a ClaudIA, permitindo entender em que momento o atendimento voltou para a IA. ✔ Auditorias para melhoria contínua: O HUB possibilita ajustes estratégicos, como refinamento de conteúdos N1 e N2, criação de fluxos interativos e identificação de pontos de falha que impactam a experiência do cliente. ✔ Monitoramento de erros nas requisições do Eddie: Caso ocorra alguma falha em chamadas de API ou integrações dentro do Eddie, o HUB permite a identificação dessas falhas, possibilitando correções ágeis para evitar impacto no atendimento. Um bloco alto nível com um log é exibido no momento da falha para facilitar a identificação do problema. Exemplo de log no Hub: indicação de falha na requisição do Eddie O Hub é uma ferramenta essencial para garantir a eficiência, a transparência e a evolução constante do atendimento, proporcionando uma visão estratégica sobre a interação entre ClaudIA, Eddie e os clientes. Os seguintes recursos estão disponíveis para análise e otimização: Identificação do Momento de Chamada do Eddie - No Hub, é possível visualizar exatamente quando um Eddie foi chamado dentro de uma conversa. - O início e o término do fluxo são registrados, permitindo rastreamento claro do que aconteceu durante a execução. Processo Sugerido para Teste e Melhoria de Eddie Para garantir a qualidade e evolução contínua dos fluxos criados no Eddie, é essencial seguir um processo estruturado de testes e melhorias. Como o Eddie não possui um controle de versão nativo, as boas práticas incluem backup, testes isolados e validação antes da publicação. Construção e Modularização - Sempre que possível, divida fluxos complexos em partes menores e reutilizáveis. - Utilize chamadas entre fluxos para facilitar a manutenção e evitar retrabalho. - Certifique-se de que todas as condições (if/else) estejam corretamente preenchidas para evitar decisões incorretas. Testes Antes da Publicação - Antes de publicar qualquer alteração, duplique o fluxo e realize testes em um ambiente isolado. - Execute simulações completas, verificando a lógica de decisão, as mensagens enviadas e as integrações configuradas. - Valide os tempos de resposta observando o intervalo entre a mensagem do cliente e a resposta da ClaudIA no HUB. Isso ajuda a identificar possíveis lentidões nas requisições, mesmo sem um detalhe exato da duração. Evite requisições que possam ultrapassar o tempo limite de 45 segundos. Backup e Controle de Alterações - Como não há um sistema nativo de versionamento, baixe uma cópia do fluxo antes de qualquer modificação. - Publique apenas após todas as alterações estarem validadas para evitar falhas inesperadas. - Caso seja necessário um downgrade, utilize a versão salva para restaurar rapidamente o fluxo anterior. Monitoramento e Aprimoramento Contínuo - Acompanhe a execução dos fluxos no HUB, verificando quais foram chamados e se houve falhas ou desvios inesperados. - Analise logs e mensagens de erro para identificar pontos de otimização. - Caso ocorram falhas recorrentes, ajuste as condições de decisão e fluxos alternativos para garantir um atendimento mais fluido. Esse processo estruturado minimiza erros, otimiza o desempenho do Eddie e melhora a experiência do cliente, garantindo que cada fluxo funcione da melhor forma possível.

Última atualização em Aug 09, 2025

Como Identificar e Evitar Falhas nos Fluxos e Requisições do Eddie

Para garantir um atendimento eficiente e fluido, é essencial entender os principais modos de falha que podem ocorrer nos fluxos do Eddie e na comunicação entre Eddie e ClaudIA. Identificar e mitigar essas falhas permite aprimorar a experiência do cliente e evitar interrupções indesejadas. Timeout e Cancelamento de Requisição A comunicação entre ClaudIA e Eddie precisa ser rápida e eficiente para garantir um atendimento fluido ao cliente. No entanto, existe uma limitação de tempo para a execução de cada requisição dentro do Eddie. Se esse tempo for ultrapassado, a requisição é cancelada automaticamente, interrompendo o fluxo e impedindo que o cliente receba uma resposta adequada. Como Funciona o Timeout? - Quando ClaudIA chama um fluxo do Eddie, a execução das ações dentro do fluxo deve ocorrer dentro de um tempo limite de 45 segundos. - Esse limite existe para garantir que a conversa aconteça em tempo real, sem atrasos perceptíveis para o cliente. - Se uma requisição demorar mais do que esse período, o Eddie não consegue completar a ação, resultando no cancelamento da operação e na ausência de resposta para ClaudIA. Principais Causas de Timeout e Cancelamento de Requisição APIs com Tempo de Resposta Alto - Quando um fluxo do Eddie faz uma chamada a uma API externa, o tempo de resposta pode ser muito longo, ultrapassando o limite permitido. - Algumas APIs não são otimizadas para consultas rápidas e podem demorar para processar e retornar dados. - Se a API não responder dentro dos 45 segundos, a requisição será cancelada automaticamente, prejudicando a experiência do usuário. 🔹 Como evitar: Utilize APIs que tenham tempo de resposta rápido (idealmente menos de 2-3 segundos). Priorize APIs assíncronas ou com respostas em cache para evitar atrasos. Se precisar de uma API lenta, considere dividir a requisição em partes menores ou usar soluções intermediárias (como armazenar dados temporários). Falha no Retrieval - Isso pode acontecer por erro de configuração, alterações recentes no fluxo ou falha na indexação de dados. - Para mitigar esse problema, é essencial revisar e testar regularmente os conteúdos anexados ao fluxo. Erro de Execução Interna no Eddie - O Eddie pode apresentar falhas internas que impedem a execução correta do fluxo. - Isso pode ocorrer devido a configurações incorretas, blocos mal estruturados ou uso inadequado de condições lógicas (IF/ELSE). - Para minimizar esse risco, é recomendado testar cada fluxo antes da publicação e revisar logs de erro no Hub caso ocorra. Erro na Execução de Integrações - Integrações externas (como chamadas de API, Google Sheets) podem retornar mensagens de erro ou falhar completamente. - Quando isso acontece, o Eddie pode seguir um caminho incorreto ou não responder ao cliente. - Para mitigar esse problema, configure tratamentos de erro adequados, como: - Retornar uma mensagem explicativa para o cliente. - Escalar o atendimento para um agente humano (N2). 5. Fluxo Incorreto de Execução - Em fluxos que utilizam LLMs (Modelos de Linguagem como GPT) para definir a rota de execução, pode haver falhas na escolha do próximo passo. - Isso ocorre quando a interpretação do modelo leva a um caminho inesperado ou quando as condições dentro do fluxo não estão bem definidas. - Para evitar esse tipo de erro: - Defina prompts claros e bem estruturados. - Configure respostas condicionais para diferentes cenários. - Teste variações do fluxo para garantir previsibilidade. Falha Total do Eddie - Em casos extremos, o Eddie pode falhar completamente, impedindo a continuidade do fluxo. - Para evitar que o cliente fique preso na conversa, existe uma feature de segurança que escala automaticamente a conversa para N2. - Essa escalabilidade garante que, mesmo em um cenário de falha geral, o atendimento ao cliente não seja interrompido.

Última atualização em Aug 09, 2025

Como abrir uma conversa paralela no Zendesk via Eddie

O que é uma conversa paralela no Zendesk? É uma funcionalidade que permite abrir um novo canal de comunicação dentro de um ticket existente, normalmente usada para envolver outros times ou departamentos. Passo a passo para configurar no Eddie 1. Adicione um bloco HTTP Request No final da ramificação do fluxo onde deseja abrir a conversa paralela, adicione um bloco do tipo "HTTP Request". 2. Configure o método - Método: POST 3. Configure a URL https://conta.zendesk.com/api/v2/tickets/{{helpdeskId}}/side_conversations - Substitua conta.zendesk.com pela sua URL do Zendesk. - Substitua {{helpdeskId}} pela variável do ID do ticket (ela pode vir do fluxo sendo coletada da ClaudIA) 4. Headers Adicione os seguintes cabeçalhos: { "Authorization": "Bearer SEU_TOKEN_AQUI", "Content-Type": "application/json" } Substitua SEU_TOKEN_AQUI pelo seu token de API Zendesk (convertido em base64). 5. Body (corpo da requisição) Use o seguinte conteúdo em formato JSON: { "message": { "subject": "Titulo", "body": "corpo", "to": [ { "support_group_id": ID_DO_GRUPO } ] } } - Titulo: título da conversa. - corpo: mensagem a ser enviada. - ID_DO_GRUPO: ID do grupo de suporte que receberá a conversa. Você pode usar variáveis do Eddie como {{nome}}, {{mensagem}}, etc., para personalizar. Exemplo com variáveis Eddie: { "message": { "subject": "Novo pedido de {{nome}}", "body": "O cliente {{nome}} fez um novo pedido com os seguintes detalhes: {{detalhes}}", "to": [ { "support_group_id": 123456 } ] } } Onde adicionar? Adicione esse bloco HTTP na ramificação do fluxo onde deseja que a conversa paralela seja criada no Zendesk. Exemplo de fluxo com abertura de conversa paralela usando API do Zendesk

Última atualização em Aug 09, 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 começa 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 Aug 15, 2025

Como criar um fluxo no Eddie com API externa (via Eddie)

https://www.loom.com/share/dff35323278948c8bb6f48181c95e859 O que você vai aprender aqui? Essa FAQ ensina, passo a passo, como usar o Eddie com o Eddie + API externa para construir um fluxo que: - Recebe uma entrada do usuário (ex: CEP ou número do pedido) - Faz uma requisição para uma API externa - Extrai e salva os dados retornados em variáveis - Retorna uma resposta formatada para a Cláudia ou direciona o fluxo para N2 Etapa 1 – Crie um novo fluxo no Eddie 1. Acesse o Eddie e clique em “Criar um Typebot” 2. Comece do zero (blank bot) Etapa 2 – Defina o ponto de partida (input do usuário) 1. Crie um bloco de input de texto 2. Salve a entrada do usuário (ex: CEP) numa variável chamada cep Etapa 3 – Configure a chamada de API 1. Adicione um bloco do tipo HTTP Request 2. No campo de URL, cole o endpoint da API (exemplo: https://viacep.com.br/ws/{{cep}}/json) 3. Certifique-se de que a variável esteja entre chave ("{{}}"), como, no exemplo, {{cep}}. 4. Método: GET Etapa 4 – Teste o request 1. Clique em “Test Request” 2. Adicione um valor real de teste (ex: 01025-020) 3. Se o teste falhar, verifique se o link começa com https:// Etapa 5 – Mapeie os campos de resposta Depois que o request funcionar, extraia os dados relevantes do JSON retornado. No exemplo, ele retorna o abaixo: Etapa 6 – Monte a resposta formatada Crie um bloco de texto com a resposta para o cliente, usando as variáveis extraídas. Exemplo: “O CEP {{cep}} corresponde à rua {{endereco}}, no bairro {{bairro}}, cidade de {{cidade}}/{{uf}}, DDD {{ddd}}.” Etapa 7 – Lidando com CEPs inválidos 1. Use um bloco condicional 2. Verifique se a variável endereco existe: - Se sim, siga com a resposta - Se não, envie uma mensagem como, por exemplo, “Não encontramos esse CEP” e retorne para a Cláudia ou redirecione para N2 Etapa 8 – Enviando de volta para a Cláudia - No final do fluxo, use o bloco “Retornar para a Cloud” - Se o dado foi encontrado, retorne uma resposta amigável - Se não foi encontrado, envie um texto que sinalize que a Cláudia deve escalar para N2 (ex: “Não encontrei o status. Por favor, transfira.”) Etapa 9 – Publicar e testar com tickets reais 1. Clique em “Publicar” no topo da tela 2. O fluxo estará disponível para testes reais com tickets na IDS Etapa 10 – Tratamento de entradas com formatação incorreta Se o usuário digitar o CEP com traços, espaços ou pontos (ex: 01.025-020), use blocos intermediários para sanitizar a entrada (remover caracteres especiais). Dica: use blocos de transformação de texto ou scripts JavaScript no Eddie, se necessário. Conclusão Com esse fluxo no Eddie: - Você automatiza buscas externas via API - Personaliza a resposta para o cliente - Escala apenas quando necessário - Pode replicar esse modelo para consultas de status de pedidos, rastreios, CPFs, etc. Outros artigos que podem ser úteis - Básico de como usar as funcionalidades e botões do Eddie - Como Identificar e Evitar Falhas nos Fluxos e Requisições do Eddie - Troubleshooting e outras dicas - Monitoramento e Melhoria Contínua dos Fluxos no Eddie - Passo a passo para lançar um novo Eddie - Como funciona a interação ClaudIA e Eddie

Última atualização em Aug 09, 2025

Como criar um fluxo no Eddie acessando informações em um Google Sheets

https://www.loom.com/share/23e057bb1692482c89e9b56e05a49ff0 O que é essa funcionalidade? Essa integração permite que você conecte o Eddie a uma planilha do Google Sheets e crie fluxos automáticos com base nos dados contidos nela — como consultar status de pedidos, valores de saldo, agendamentos, entre outros. É especialmente útil quando você atualiza a planilha com frequência, seja manualmente ou via automação (ex: dumps horários do sistema). Exemplo de uso Vamos usar uma planilha com duas colunas: - id: código do pedido - status: situação atual (ex: “em andamento”, “entregue”, “atrasado”) Etapa 1 – Criar um novo Eddie Crie um novo fluxo no Eddie e defina o ponto de entrada com um input de texto, para que o cliente informe o número do pedido. Dê à variável um nome descritivo, como status_pedido. Etapa 2 – Conectar o Google Sheets Na aba Integrações, selecione “Sheets”. - Se sua conta ainda não estiver conectada, peça para o time da Cloud Humans te passar o e-mail de serviço para compartilhar sua planilha. - Escolha a planilha, a aba correta e a linha de cabeçalho (geralmente 1). - Use a operação Get data. - Aplique um filtro, como por exemplo "coluna id" == {{status_pedido}} Etapa 3 – Extrair a informação desejada Escolha a coluna status como saída e armazene em uma nova variável (ex: status_resposta). Etapa 4 – Retornar uma resposta ao cliente Use um bloco de texto para formatar a mensagem de retorno. Exemplo: “Seu pedido está com o seguinte status: {{status_resposta}}.” Para testar, basta clicar em Visualizar. Você pode testar colocando, por exemplo, o ID “234567” e validando se a resposta vem correta de acordo com a planilha. Etapa 5 – Definir regras de encaminhamento para N2 Use blocos condicionais para redirecionar automaticamente: - Se status_resposta for “atrasado”, envie a conversa para N2 (atendimento humano). - Caso contrário, siga com o atendimento padrão. Etapa 6 – Encerrar ou transferir o atendimento Ao final do fluxo, use o bloco “Retornar para a Cloud” e defina: - “Nenhum” → apenas encerra o fluxo com a resposta para o cliente - “N2” → sinaliza que a Cláudia deve transferir para um humano Etapa 7 – Publicar e testar com tickets reais Depois de finalizar, clique em Publicar. Só após isso o fluxo estará disponível para testes reais com a ClaudIA, inclusive no Hub / Playground. Conclusão Com esse fluxo: - Você automatiza a busca de dados no Google Sheets. - Evita respostas manuais e erros. - Escala apenas quando necessário (ex: atrasos). - Pode adaptar para outros usos como consulta de CPF, agendamentos, elegibilidade, etc.

Última atualização em Aug 09, 2025

Testes de Fluxos no Eddie via API

A API do Eddie permite iniciar e continuar conversas automaticamente com fluxos criados, por meio de chamadas HTTP. Essa funcionalidade é ideal para realizar testes automatizados, validar interações e garantir que os fluxos estejam funcionando conforme o esperado. Esse guia apresenta o processo completo para uso da API. Visão Geral da Integração A comunicação com o Eddie é feita em duas etapas principais: 1. Início da conversa: cria uma nova sessão de chat. 2. Continuidade da conversa: envia mensagens dentro da sessão criada. Essas chamadas são feitas através de endpoints HTTP, utilizando um token de autenticação e o ID do fluxo criado no Eddie. Passo a Passo para Integração 1. Obtenha o ID do fluxo Cada fluxo criado no Eddie possui um identificador único (ID), que é utilizado para iniciar a sessão via API. Esse ID pode ser copiado diretamente na URL de edição do fluxo ou na tela de publicação. 2. Inicie uma nova sessão de conversa Endpoint: POST https://eddieeyes.us-east-1.prd.cloudhumans.io/api/v1/typebots/ID_DO_FLUXO/startChat Headers obrigatórios: - Content-Type: application/json - Authorization: Bearer {{apiToken}} Resposta esperada: { "sessionId": "abc123xyz"} Esse sessionId é essencial para os próximos passos. 3. Envie mensagens para continuar o chat Endpoint: POST https://eddieeyes.us-east-1.prd.cloudhumans.io/api/v1/sessions/{{sessionId}}/continueChat Headers: - Content-Type: application/json - Authorization: Bearer {{apiToken}} Body: { "message": "mensagem do usuário"} Resposta: um objeto JSON com a próxima interação gerada pelo Eddie com base na lógica do fluxo. Como gerar um token Para autenticar as chamadas via API, você precisa de um API Token. Siga os passos abaixo para gerar: 1. Clique em Configurações e membros no canto superior direito da tela. 2. No menu lateral, selecione Minha conta. 3. Na seção API tokens, clique em Criar para gerar um novo token. Boas práticas para uso da API Armazenamento e reuso do sessionId Guarde o sessionId gerado para cada conversa. Ele é necessário para manter a continuidade da interação com o mesmo contexto. Testes antes da integração final Utilize ferramentas como Postman ou Insomnia para validar os endpoints, headers, corpo e respostas. Isso evita erros no ambiente de produção. Monitoramento de erros Falhas em chamadas (como dados inválidos, endpoints incorretos ou timeout) aparecem no HUB com sinalização de erro. Utilize essas informações para diagnóstico rápido.

Última atualização em Aug 09, 2025

🚀 “Minha Planilha, Minha API” — Transforme seu Google Sheets em Serviço Web em 5 Minutos!

Substitua todos os textos EM MAIÚSCULO pelos seus valores reais YOUR_SHEET_ID • YOUR_SHEET_NAME • YOUR_KEY_NAME (ex.: id, phone, cpf…) 1️⃣ Visão Geral 🚀 Web App Expõe sua planilha Google Sheets como endpoint HTTP (GET ou POST). ⚡ Cache em memória Índice em Map para respostas em ms. 🔍 Busca por chave Consulta por YOUR_KEY_NAME (ex.: id=123) usando índice + fallback rápido. ♻️ Rebuild & Incremental Você controla quando reconstruir o índice (manual ou trigger de 1 min). 2️⃣ Script-base (anonimizado) /** * Web App – API de Planilha * Troque TODOS os marcadores EM MAIÚSCULO pelos seus dados reais! */ /* ⚙️ CONFIGURAÇÃO */ const PLANILHA_ID = 'YOUR_SHEET_ID'; const SHEET_NAME = 'YOUR_SHEET_NAME'; /* 🗺️ Mapeie só as colunas que quer expor (A=1, B=2, …) */ const COL = { key : 1, // YOUR_KEY_NAME (chave de busca) field01 : 2, field02 : 3, field03 : 4 }; const NUM_COLS = Object.keys(COL).length; const TTL_CACHE_MS = 15 * 60 * 1000; // 15 min const CHUNK_ROWS = 8000; // leitura em blocos /* 🛢️ Cache */ let cache = { map:new Map(), last:0, building:false }; /* 🌐 ENDPOINTS */ function doGet(e){ return handle(e); } function doPost(e){ if (e.postData && e.postData.type === 'application/json') Object.assign(e.parameter, JSON.parse(e.postData.contents||'{}')); return handle(e); } /* 🧠 LÓGICA PRINCIPAL */ function handle(e){ const id = (e.parameter['YOUR_KEY_NAME'] || '').trim(); if (!id) return out({found:false,error:`Parâmetro 'YOUR_KEY_NAME' ausente`}); try{ if (Date.now() - cache.last > TTL_CACHE_MS) buildIndex(); const hit = cache.map.get(id); if (hit) return out({found:true, ...hit}); const obj = searchSheet(id); return out(obj ? {found:true, ...obj} : {found:false}); }catch(err){ return out({found:false,error:err.toString()}); } } /* 🔍 Busca direta (fallback) */ function searchSheet(id){ const sh = SpreadsheetApp.openById(PLANILHA_ID).getSheetByName(SHEET_NAME); const rng = sh.getRange(1, COL.key, sh.getLastRow(), 1) .createTextFinder(id).matchEntireCell(true).findNext(); if (!rng) return null; const vals = sh.getRange(rng.getRow(), 1, 1, NUM_COLS).getValues()[0]; const obj = rowToObj(vals); cache.map.set(id, obj); // salva no cache return obj; } /* 🔄 Constrói OU renova o índice completo */ function buildIndex(){ if (cache.building) return; cache.building = true; try{ const sh = SpreadsheetApp.openById(PLANILHA_ID).getSheetByName(SHEET_NAME); const rows = sh.getLastRow() - 1; const map = new Map(); for (let i=2;i<=rows+1;i+=CHUNK_ROWS){ const end = Math.min(i+CHUNK_ROWS-1,rows+1); sh.getRange(i,1,end-i+1,NUM_COLS).getValues().forEach(r=>{ const id = (r[COL.key-1]||'').toString().trim(); if (id) map.set(id, rowToObj(r)); }); } cache = { map, last:Date.now(), building:false }; }finally{ cache.building=false; } } /* 🧩 Helpers */ function rowToObj(r){ const o={}; for (const k in COL) o[k]=r[COL[k]-1]; return o; } const out = o=>ContentService.createTextOutput(JSON.stringify(o)) .setMimeType(ContentService.MimeType.JSON); /* ⏰ Trigger incremental (1 min) */ function criarTriggerIncremental(){ ScriptApp.newTrigger('buildIndex') .timeBased().everyMinutes(1).create(); } 3️⃣ Passo a Passo Essencial 🔧 A. Configure & cole o script 1. Abra script.google.com → Novo projeto. 2. Cole o template acima. 3. Troque TODOS os marcadores YOUR_…. ⚡ B. Construa o primeiro índice manualmente 1. No editor ➜ Executar buildIndex() uma vez. 2. Isso carrega todas as linhas em memória (mais rápido para a primeira requisição). 💡 Dica rápida Se preferir, basta chamar a API com &rebuild=true logo após o deploy – o efeito é o mesmo. ⏰ C. Crie o gatilho incremental 1. Una vez construído o índice inicial, selecione a função criarTriggerIncremental no menu suspenso de execução. 2. Clique Run → autorizar. 3. Um trigger de 1 min manterá o cache sincronizado sem esforço. 🌐 D. Publique e gere a URL 1. Deploy ▸ New deployment ▸ Web app. 2. Execute as: Me • Who has access: Anyone (ou link). 3. Deploy ➔ Authorize ➔ Copy URL. https://script.google.com/macros/s/SEU_DEPLOY_ID/exec 4️⃣ Testes Rápidos 5️⃣ Problemas Comuns & Soluções 🔒 Segurança Rápida - Web App roda com suas credenciais → clientes só veem JSON. - Para limitar, mude acesso para Only myself e exija token / API Key. ✨ Pronto! 1. 👉 Construa o primeiro índice (buildIndex ou rebuild=true). 2. 👉 Crie o trigger incremental. 3. 👉 Publique e use! Qualquer dúvida, fale com a gente. 😉

Última atualização em Aug 06, 2025