Principal Construindo Fluxos Como criar um Fluxo Controlado acessando informações em um Google Sheets

Como criar um Fluxo Controlado acessando informações em um Google Sheets

Última atualização em Jul 01, 2026

Quando usar

  • Você tem dados em uma planilha Google Sheets (status de pedidos, agendamentos, saldo, elegibilidade) e quer que o Fluxo Controlado 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

  • Planilha Google Sheets com cabeçalho na primeira linha e dados estruturados

  • Uma conta Google (Gmail pessoal ou corporativo — não precisa ser um e-mail @cloudhumans) com acesso a essa planilha, para conectar a integração

Sobre este artigo

A integração Google Sheets permite que o Fluxo Controlado consulte uma planilha como se fosse uma base de dados — útil quando você precisa retornar status, valores ou flags simples sem expor uma API.

📌 Atualização: o vídeo acima menciona a necessidade de conectar um e-mail com domínio @cloudhumans. Isso não é mais necessário — você pode conectar qualquer conta Google (Gmail pessoal ou corporativo) que tenha acesso à planilha.

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 Fluxo Controlado

Crie um novo Fluxo Controlado 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, conecte sua própria conta Google (qualquer Gmail — pessoal ou corporativo) que tenha acesso à planilha. Não é mais necessário usar um e-mail @cloudhumans nem solicitar um e-mail de serviço ao time da Cloud Humans

  • 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