Construindo Fluxos

Orientações práticas sobre construção de fluxos

Por Fabrício Rissetto and 4 outros

• 8 artigos

Como enviar variáveis para fluxos do Eddie (sem perguntar de novo ao cliente)

Quando usar - Você quer que o Eddie aproveite dados que o cliente já deu na conversa com a ClaudIA, sem perguntar de novo - Você precisa entender quais variáveis padrão a ClaudIA envia automaticamente para o Eddie (helpdeskId, channelType etc.) - Você quer ativar o extrator de variáveis para tornar a experiência mais fluida Pré-requisitos - Workspace do Eddie criado e fluxo configurado - Seção interativa na ClaudIA configurada para acionar o fluxo Sobre este artigo O Eddie tem dois mecanismos para receber dados antes mesmo de pedir ao cliente: as variáveis padrão (sempre enviadas pela ClaudIA) e o extrator de variáveis (que lê o histórico da conversa via LLM e preenche campos do fluxo). Este artigo cobre os dois — e explica como funciona o acionamento de um Eddie pela ClaudIA. Detalhes Visão geral — campo Placeholder O campo Placeholder dos cards Input permite que o Eddie aproveite dados já informados pelo cliente na conversa com a ClaudIA, sem precisar perguntar de novo. Basta descrever no Placeholder qual dado você quer capturar. Essa descrição funciona como um "prompt" para a ClaudIA procurar a informação no ticket/conversa e preencher a variável automaticamente. :::info Exemplo: se o Placeholder for "E-mail do usuário" e existir um e-mail no histórico, a ClaudIA o extrai (via LLM) e preenche a variável definida no fluxo. A response daquele Input não é disparada e a pergunta não se repete. ::: Variáveis padrão enviadas pela ClaudIA Estas variáveis chegam automaticamente ao fluxo, sem nenhuma configuração adicional. Todas em formato texto (string). Algumas podem vir vazias, outras sempre têm valor. | Variável | Descrição | | --- | --- | | helpdeskId | Identificador do ticket no help desk. Usado para localizar um ticket específico | | cloudChatId | Código único da conversa no CloudChat. Sempre presente | | activeIntent | Intenção (tópico) detectada na conversa atual. Se nenhuma for identificada, recebe DEFAULT | | channelType | Canal de origem: EMAIL WHATSAPP SMS CHAT FORM FACEBOOK INSTAGRAM NO_TYPE_PROVIDED | | language | Idioma detectado (pode ser nulo): pt-BR en es fr de it ja ko zh ru ar hi nl sv da fi pl tr | | createdAt | Data e hora de início da conversa | | frustrationScore | Nível de frustração calculado pela ClaudIA. 0 = sem frustração; valores maiores = maior insatisfação | | abKey | Chave de teste A/B (pode ser nula — nem toda conversa entra em A/B) | | lastUserMessages | Últimas mensagens enviadas pelo cliente desde a última resposta do agente | | messages | Histórico completo da conversa em formato texto | Formato do histórico de messages: USER: olá AGENT: Oi, eu sou a ClaudIA. Como posso te ajudar? USER: então... queria saber como fazer [...] AGENT: Entendi! Para fazer isso basta [...] Para usar essas variáveis no fluxo, basta criar um card Condition: Extrator de variáveis (do histórico) Por padrão, os fluxos do Eddie pedem ao cliente todas as informações necessárias (número do pedido, e-mail etc.). Mas muitas vezes essas informações já foram dadas antes na conversa. Pedir de novo é UX ruim. O extrator de variáveis analisa o histórico da conversa, coleta os dados necessários e os envia ao Eddie no momento da ativação — eliminando perguntas redundantes. Características: - Verifica o fluxo do Eddie dinamicamente para saber quais variáveis precisam ser coletadas - A extração é feita pelo GPT via prompt definido no código da ClaudIA - Os dados coletados podem ser conferidos na auditoria do Hub Como configurar (dentro do fluxo Eddie): Para que uma variável seja extraída, é necessário: 1. Bloco input com o placeholder preenchido, descrevendo a variável (ex: "Número do pedido no formato IN-XXXXXX") 2. Condicional is set precedendo a variável, que verifica se ela já tem valor — assim você controla o que acontece se o extrator já preencheu Acionamento do Eddie pela ClaudIA 1 — Como o Eddie é acionado Um Eddie é acionado pela ClaudIA via seção utilizada (detalhado em Como funciona a seção utilizada pela ClaudIA). Passo a passo: 1. Usuário envia uma mensagem 2. ClaudIA analisa as responses das seções disponíveis 3. ClaudIA aciona o Eddie da seção com response mais adequada à mensagem do cliente 4. Se duas seções de Eddie forem selecionadas, prevalece a de maior score 2 — Como ocultar a response da seção interativa Para que a response seja omitida, o Eddie precisa ter acesso à primeira variável coletada no fluxo. :::info Exemplo: se a response contiver o texto "Qual o número do seu pedido?", a ClaudIA omitirá a pergunta caso o usuário já tenha informado o número do pedido. Para isso funcionar, é obrigatório preencher o Placeholder no card de coleta da variável. ::: Observações - Para aprender o passo a passo de criar um Eddie do zero: Como lançar um novo Eddie passo a passo - Para usar todos os botões da plataforma: Como usar as funcionalidades e botões básicos do Eddie - Para evitar erros comuns: Como identificar e evitar falhas nos fluxos e requisições do Eddie - Para casos em que a ClaudIA inicia direto em um fluxo: Como configurar a ClaudIA para iniciar em um fluxo do Eddie (Start with Eddie)

Última atualização em May 21, 2026

Como criar um fluxo no Eddie com API externa

Quando usar - Você precisa conectar o Eddie a uma API externa (status de pedido, consulta de CEP, validação de CPF etc.) - Você quer aprender o fluxo completo — input do cliente → request HTTP → mapeamento da resposta → resposta formatada - Você precisa lidar com entradas inválidas ou retornos vazios da API Pré-requisitos - Workspace Eddie criado - URL e método (GET/POST) da API externa que será consultada - (Se aplicável) Headers de autenticação prontos (token, API key) Sobre este artigo Este guia ensina, passo a passo, como construir um fluxo Eddie que recebe uma entrada do usuário, faz uma requisição HTTP, extrai os dados retornados, retorna uma resposta formatada para a ClaudIA — ou direciona para N2 quando algo não dá certo. Vídeo do passo a passo Passo a passo Etapa 1 — Criar um novo fluxo no Eddie 1. Acesse o Eddie e clique em Criar um Typebot 2. Comece do zero (Blank bot) Etapa 2 — Definir 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 (ex: cep) Etapa 3 — Configurar a chamada de API 1. Adicione um bloco do tipo HTTP Request 2. No campo URL, cole o endpoint da API (ex: https://viacep.com.br/ws/{{cep}}/json) 3. Certifique-se de que a variável esteja entre chaves duplas: {{cep}} 4. Método: GET (ou POST conforme a API) Etapa 4 — Testar 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 — Mapear os campos de resposta Depois que o request funcionar, extraia os dados relevantes do JSON retornado em variáveis individuais (ex: endereco, bairro, cidade, uf, ddd). Etapa 6 — Montar a resposta formatada Crie um bloco de texto com a resposta para o cliente, usando as variáveis extraídas: "O CEP {{cep}} corresponde à rua {{endereco}}, no bairro {{bairro}}, cidade de {{cidade}}/{{uf}}, DDD {{ddd}}." Etapa 7 — Lidar com entradas inválidas (CEP que não existe) 1. Use um bloco Condition 2. Verifique se a variável endereco existe: - Se sim, siga com a resposta - Se não, envie "Não encontramos esse CEP" e retorne à ClaudIA ou redirecione para N2 Etapa 8 — Devolver para a ClaudIA - No final do fluxo, use o bloco Retornar para a Cloud - Se o dado foi encontrado: retorne uma resposta amigável - Se não: envie texto sinalizando que a ClaudIA deve escalar para N2 "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 — Tratar 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). :::info Dica: use blocos de transformação de texto ou scripts JavaScript no Eddie para sanitização customizada. ::: Conclusão :::success Com esse fluxo, você: - Automatiza buscas externas via API - Personaliza a resposta para o cliente - Escala para humano apenas quando necessário - Replica o modelo para consultas de status de pedido, rastreio, CPF etc. ::: Observações - Para fluxo via Google Sheets em vez de API: Como criar um fluxo no Eddie acessando informações em um Google Sheets - Para evitar falhas em chamadas de API: Como identificar e evitar falhas nos fluxos e requisições do Eddie - Para reduzir erros e aumentar retenção: Como reduzir erros de chamada do Eddie para aumentar a retenção - Para entender as variáveis padrão enviadas pela ClaudIA: Como enviar variáveis para fluxos do Eddie

Última atualização em May 21, 2026

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

Quando usar - Você tem dados em uma planilha Google Sheets (status de pedidos, agendamentos, saldo, elegibilidade) e quer que o Eddie consulte direto na planilha - Você atualiza essa planilha manualmente ou via automação (dump horário do sistema, por exemplo) - Você não tem (ou não quer expor) uma API para esse caso de uso Pré-requisitos - Workspace Eddie criado - Planilha Google Sheets com cabeçalho na primeira linha e dados estruturados - Acesso ao e-mail de serviço da Cloud Humans para compartilhar a planilha (peça ao time se ainda não tiver) Sobre este artigo A integração Google Sheets permite que o Eddie consulte uma planilha como se fosse uma base de dados — útil quando você precisa retornar status, valores ou flags simples sem expor uma API. Vídeo do passo a passo Exemplo de uso Vamos usar uma planilha com duas colunas: - id — código do pedido - status — situação atual (ex: "em andamento", "entregue", "atrasado") Passo a passo 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 id_pedido. Etapa 2 — Conectar o Google Sheets Na aba Integrações, selecione Sheets: - Se sua conta ainda não estiver conectada, peça ao time da Cloud Humans 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: coluna id == {{id_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 a resposta ao cliente Use um bloco de texto para formatar a mensagem: "Seu pedido está com o seguinte status: {{status_resposta}}." Para testar, basta clicar em Visualizar e usar um ID real (ex: 234567). Etapa 5 — Definir regras de encaminhamento para N2 Use blocos condicionais para redirecionar automaticamente: - Se status_resposta == "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 ClaudIA deve transferir para um humano Etapa 7 — Publicar e testar com tickets reais Clique em Publicar. Só após isso o fluxo estará disponível para testes reais com a ClaudIA, inclusive no Hub / Playground. Conclusão :::success Com esse fluxo você: - Automatiza a busca de dados no Google Sheets - Evita respostas manuais e erros de digitação - Escala para humano apenas quando necessário (ex: atraso) - Replica o modelo para consulta de CPF, agendamentos, elegibilidade, e outros casos ::: Observações - Para fluxo via API externa: Como criar um fluxo no Eddie com API externa - Para transformar Google Sheets em uma API consultável: Como transformar seu Google Sheets em uma API - Para boas práticas de Google Sheets como fonte de dados: Requisitos de Google Sheets para utilização no Eddie - Para evitar falhas em integrações: Como identificar e evitar falhas nos fluxos e requisições do Eddie

Última atualização em May 21, 2026

Como configurar a ClaudIA para iniciar em um fluxo do Eddie (Start with Eddie)

Quando usar - Você quer que toda nova conversa abra direto em um fluxo Eddie (e não na ClaudIA conversacional) - Sua operação tem fluxos curtos e controlados (triagem inicial, coleta de leads, validação obrigatória) - Você precisa ler ou atualizar dados em sistemas externos logo no início do atendimento Pré-requisitos - Acesso de administrador ao Hub do projeto ClaudIA - Um fluxo Eddie publicado que receberá todas as conversas - Flow ID do fluxo (encontrado na tela de publicação no Eddie) Sobre este artigo Por padrão, a ClaudIA direciona as interações para o Eddie apenas em casos de seções interativas. Mas é possível configurá-la para que todas as sessões sejam iniciadas diretamente em um fluxo Eddie — útil para triagens simples (coleta de leads) ou operações automatizadas que se beneficiam de um caminho fixo no início. :::info Embora a ClaudIA seja projetada como uma IA conversacional avançada — afastando-se do conceito tradicional de "bots de árvore de decisão" — fluxos curtos e controlados podem ser muito vantajosos quando precisamos acessar sistemas externos para leitura ou atualização de dados, garantindo operações rápidas e precisas. ::: Passo a passo Etapa 1 — Acessar a configuração no Hub Na tela de configurações do Hub, localize a seção Start With Eddie. Etapa 2 — Habilitar o redirecionamento 1. Marque o checkbox para habilitar o redirecionamento 2. Insira o Flow ID do Eddie no campo correspondente Configuração Start with Eddie :::success Pronto! Agora toda conversa nova começará pelo fluxo Eddie selecionado, mantendo o equilíbrio entre automação eficiente e uma experiência de atendimento dinâmica. ::: Boas práticas :::warning - Use fluxos curtos no Start with Eddie. Fluxos longos transformam o atendimento em "bot de árvore" e prejudicam a experiência - Sempre termine o fluxo com End Flow ou Answer Ticket para que a ClaudIA possa retomar a conversação - Teste antes de ativar em produção — toda conversa começará pelo fluxo, então qualquer bug afetará 100% dos clientes ::: Observações - Para criar um fluxo Eddie do zero: Como lançar um novo Eddie passo a passo - Para entender as terminações de fluxo (End Flow vs Answer Ticket): Diferença entre terminações de fluxo: End Flow, Answer Ticket, Forward to Human e Close Ticket - Para usar variáveis padrão (helpdeskId, channelType etc.): Como enviar variáveis para fluxos do Eddie

Última atualização em May 21, 2026

Como testar fluxos do Eddie via API

Quando usar - Você quer automatizar testes de fluxos Eddie em CI/CD ou via Postman/Insomnia - Você precisa validar interações programaticamente antes de publicar em produção - Você está integrando o Eddie com outro sistema que precisa enviar mensagens via HTTP Pré-requisitos - Workspace Eddie com pelo menos um fluxo criado - API Token do Eddie gerado (passo a passo abaixo) - Cliente HTTP (Postman, Insomnia, curl etc.) Sobre este artigo A API do Eddie permite iniciar e continuar conversas automaticamente com fluxos criados, via chamadas HTTP. Essa funcionalidade é ideal para testes automatizados e validação de fluxos antes de publicar. Visão geral da integração A comunicação com o Eddie é feita em duas etapas: 1. Início da conversa — cria uma nova sessão de chat 2. Continuidade da conversa — envia mensagens dentro da sessão criada As chamadas usam endpoints HTTP autenticados com token Bearer e o ID do fluxo criado no Eddie. Passo a passo Etapa 1 — Obter o ID do fluxo Cada fluxo criado no Eddie possui um identificador único (ID), usado para iniciar a sessão via API. Esse ID pode ser copiado: - Diretamente da URL de edição do fluxo - Ou da tela de publicação Onde encontrar o ID do fluxo Etapa 2 — Iniciar 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" } :::warning O sessionId é essencial para os próximos passos. Guarde-o assim que receber. ::: Etapa 3 — Enviar 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: objeto JSON com a próxima interação gerada pelo Eddie com base na lógica do fluxo. Como gerar um API Token Para autenticar as chamadas via API, você precisa de um API Token. Siga os passos abaixo: Geração do API Token 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 :::error Trate o token como uma senha — qualquer pessoa com acesso a ele pode iniciar e continuar conversas em todos os fluxos do seu workspace. Não cole em commits, logs ou Slack público. ::: 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 Use Postman ou Insomnia para validar: - Endpoints - Headers - Corpo (body) e respostas Isso evita erros no ambiente de produção. Monitoramento de erros Falhas em chamadas (dados inválidos, endpoints incorretos, timeout) aparecem no Hub com sinalização de erro. Use essas informações para diagnóstico rápido. Observações - Para entender as chamadas de API que o Eddie faz internamente: Como criar um fluxo no Eddie com API externa - Para reduzir falhas em chamadas: Como reduzir erros de chamada do Eddie para aumentar a retenção - Para entender requisitos de API que o Eddie consome: Requisitos de API para utilização no Eddie

Última atualização em May 21, 2026

Como configurar um fluxo de Status Page (Atlassian Statuspage e Instatus) no Eddie

Quando usar - Você usa Statuspage by Atlassian ou Instatus para reportar status do seu produto - Você quer que o Eddie consulte automaticamente a status page e responda ao cliente sobre instabilidades em curso - Você quer que tickets sobre instabilidade sejam encerrados automaticamente quando há uma incidência reportada (e devolvidos à ClaudIA caso contrário) Pré-requisitos - Workspace Eddie criado - URL da Status Page pública do produto - (Se for Atlassian Statuspage ou Instatus) o modelo pronto disponibilizado abaixo :::error A Status Page precisa ser pública (acessível sem autenticação). Páginas privadas ou que exijam credenciais não são suportadas pelo modelo. ::: Sobre este artigo Esta FAQ e os modelos foram criados exclusivamente para consultar e retornar o estado de páginas de status hospedadas no Statuspage by Atlassian e no Instatus. Não funciona com outras soluções de status page. O fluxo retorna informações úteis ao usuário: se há componentes não-operacionais, ele lista e fecha o ticket; caso contrário, devolve à ClaudIA. O que já disponibilizamos Modelos prontos para download — arquivos com fluxo configurado para importação no Eddie. Os modelos já incluem variáveis, mensagens e scripts pré-configurados: - Download do modelo — Atlassian Statuspage - Download do modelo — Instatus :::warning Atente-se ao modelo escolhido — Atlassian Statuspage e Instatus têm formatos de API diferentes; um modelo não funciona para o outro. ::: Passo a passo Vídeo do passo a passo Etapa 1 — Baixar o modelo Acesse o arquivo .json do fluxo no Drive (links acima). Etapa 2 — Importar no Eddie Entre no Typebot e clique em Create a Flow. Create a Flow Etapa 3 — Fazer o upload do fluxo Selecione Import a file e importe o arquivo modelo baixado. Import a file Etapa 4 — Localizar a variável STATUSPAGE_URL Abra o fluxo importado e encontre a variável STATUSPAGE_URL no editor. Variável STATUSPAGE_URL Etapa 5 — Inserir a URL real Cole, dentro das aspas, o link real da Status Page que você quer monitorar. Inserindo a URL Etapa 6 — Publicar o fluxo Quando estiver satisfeito, publique o fluxo para que ele esteja disponível para criar conteúdos interativos. :::success Pronto. Daqui em diante, todo ticket que cair nesse fluxo consulta a status page em tempo real e devolve a resposta correta — instabilidade reportada → fecha o ticket; tudo operacional → devolve à ClaudIA. ::: Limitações conhecidas :::warning - Páginas privadas ou protegidas por autenticação não podem ser lidas pelo fluxo — o modelo não implementa OAuth nem API keys - Formato dos dados — alterações profundas na API do Statuspage/Instatus ou no formato público da página podem exigir atualização do fluxo ::: Observações - Para entender HTTP Requests no Eddie: Como criar um fluxo no Eddie com API externa - Para usar todos os botões da plataforma: Como usar as funcionalidades e botões básicos do Eddie - Para evitar falhas em chamadas externas: Como identificar e evitar falhas nos fluxos e requisições do Eddie

Última atualização em May 21, 2026

Como abrir uma conversa paralela no Zendesk via Eddie

Quando usar - Você usa Zendesk e quer que o Eddie abra uma conversa paralela (Side Conversation) dentro de um ticket existente - Você precisa envolver outro time/departamento automaticamente quando o Eddie identifica determinado caso - Você quer personalizar título, corpo e grupo de destino com variáveis do fluxo Pré-requisitos - Conta Zendesk com permissão para criar Side Conversations via API - Token de API Zendesk convertido em base64 (formato email/token:API_TOKEN) - ID do support_group que receberá a conversa paralela - helpdeskId (ID do ticket no Zendesk) disponível no fluxo Eddie — vem da ClaudIA via variável padrão Sobre este artigo A Side Conversation é uma funcionalidade do Zendesk que permite abrir um novo canal de comunicação dentro de um ticket existente. Esse artigo mostra como disparar uma Side Conversation a partir do Eddie usando um bloco HTTP Request — útil para envolver times de retaguarda, suporte avançado ou outras áreas conforme o caso identificado pelo fluxo. Passo a passo Fluxo com Side Conversation Etapa 1 — Adicionar bloco HTTP Request No final da ramificação do fluxo onde você quer abrir a conversa paralela, adicione um bloco do tipo HTTP Request. Etapa 2 — Configurar o método - Método: POST Etapa 3 — Configurar a URL https://conta.zendesk.com/api/v2/tickets/{{helpdeskId}}/side_conversations - Substitua conta.zendesk.com pela URL do seu Zendesk - {{helpdeskId}} é a variável do ID do ticket (vem automaticamente da ClaudIA — ver Como enviar variáveis para fluxos do Eddie) Configuração URL Etapa 4 — Adicionar headers { "Authorization": "Bearer SEU_TOKEN_AQUI", "Content-Type": "application/json" } :::error Substitua SEU_TOKEN_AQUI pelo seu token de API Zendesk convertido em base64. Não comite o token em fluxos compartilhados publicamente. ::: Etapa 5 — Configurar o body (corpo da requisição) Use o seguinte JSON: { "message": { "subject": "Titulo", "body": "corpo", "to": [ { "support_group_id": ID_DO_GRUPO } ] } } | Campo | O que colocar | | --- | --- | | subject | Título da conversa paralela | | body | Mensagem a ser enviada | | support_group_id | ID do grupo de suporte que receberá a conversa | Você pode usar variáveis do Eddie como {{nome}}, {{mensagem}}, {{detalhes}} etc. para personalizar. Etapa 6 — 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 no fluxo Adicione o bloco HTTP na ramificação do fluxo onde você quer que a conversa paralela seja criada (depois de uma condição que identifique o caso). Exemplo de fluxo com abertura de conversa paralela Exemplo de fluxo com abertura de conversa paralela usando API do Zendesk Observações - Para entender variáveis padrão como helpdeskId: Como enviar variáveis para fluxos do Eddie - Para conectar Eddie a APIs externas em geral: Como criar um fluxo no Eddie com API externa - Para evitar falhas em chamadas: Como identificar e evitar falhas nos fluxos e requisições do Eddie

Última atualização em May 21, 2026

Diferença entre terminações de fluxo: End Flow, Answer Ticket, Forward to Human e Close Ticket

Quando usar - Você está construindo um fluxo Eddie e precisa escolher como ele termina - Você quer entender a diferença prática entre as 4 opções de finalização - Você está debugando um fluxo onde a finalização se comporta diferente do esperado Pré-requisitos - Conhecimento básico de construção de fluxos no Eddie - Saber a partir de onde o fluxo começa: por uma seção da ClaudIA ou direto na entrada do cliente Sobre este artigo Ao construir um fluxo no Eddie, você precisa definir como ele será encerrado. Essa escolha determina o que acontece com o atendimento depois que o Eddie termina sua execução. Existem quatro opções de finalização, cada uma com efeitos diferentes em bubble visível ao cliente, continuidade na ClaudIA e uso de contexto anterior. Detalhes End Flow [N1] Quando este card é utilizado, o fluxo é encerrado e o atendimento é passado de volta para a ClaudIA. A bubble de texto configurada antes do End Flow é enviada para o cliente. Após o envio, a ClaudIA continua o atendimento a partir dali, sem aproveitar o contexto anterior da conversa. Por isso, é importante incluir na bubble algo como "Como posso te ajudar?" ou "Qual é a sua dúvida?", para que o cliente saiba que pode continuar interagindo. Quando usar: ideal para Eddies ativados a partir de uma seção da ClaudIA (o atendimento já havia começado pela ClaudIA antes de entrar no Eddie). 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 enviado alguma mensagem — seja um "oi" que ativou um fluxo inicial, ou uma pergunta que acionou algum conteúdo. A ClaudIA usa esse histórico para seguir as respostas de forma contextualizada. :::warning 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 é obrigatório fazer uma pergunta na bubble — a ClaudIA já usa o histórico da conversa. ::: :::error É obrigatório haver uma bubble de texto antes do Answer Ticket com algum conteúdo escrito. Sem isso, o funcionamento pode quebrar e gerar erro no Eddie. ::: Quando usar: ideal para casos em que o Eddie inicia o atendimento (antes de qualquer interação com a ClaudIA). Close Ticket [N1] Quando este card é utilizado, o ticket é encerrado em N1 ao final da execução do Eddie. O atendimento é considerado resolvido e finalizado. Caso o cliente envie uma nova mensagem depois do encerramento, um novo ticket será aberto. Quando usar: ideal para fluxos em que a resposta do Eddie já é suficiente para resolver a demanda do cliente, sem necessidade de continuidade com a ClaudIA. Forward to Human [N2] Quando este card é utilizado, o ticket é escalado para um agente humano (N2). A ClaudIA encerra a sua atuação e transfere o atendimento para a equipe de suporte humano do cliente. Quando usar: ideal para fluxos que identificam casos complexos ou sensíveis que precisam de atenção humana. :::warning Sempre coloque uma bubble de texto antes do card Forward to Human [N2]. ::: Resumo comparativo | Finalização | Encerra o ticket? | Bubble vai ao cliente? | Aproveita contexto anterior? | Continua com ClaudIA? | | --- | --- | --- | --- | --- | | End Flow | Não | ✅ Sim | ❌ Não | ✅ Sim | | Answer Ticket | Não | ❌ Não (contexto interno) | ✅ Sim | ✅ Sim | | Close Ticket | ✅ Sim | ✅ Sim | — | ❌ Não | | Forward to Human | ✅ Sim (vai p/ N2) | ✅ Sim | — | ❌ Não | Observações - Para o passo a passo de criar um Eddie do zero (incluindo escolha de finalização): Como lançar um novo Eddie passo a passo - Para entender a interação ClaudIA + Eddie: Como funciona a interação entre ClaudIA e Eddie - Para fluxos onde a ClaudIA inicia direto no Eddie: Como configurar a ClaudIA para iniciar em um fluxo do Eddie (Start with Eddie)

Última atualização em May 21, 2026