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

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

Última atualização em May 21, 2026

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.

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.

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