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

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

Última atualização em May 21, 2026

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.

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

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