Quais são os requisitos de Google Sheets para utilização no Fluxo Controlado

Quando usar

Você quer usar Google Sheets como fonte de dados para um Fluxo Controlado (sem precisar de API)
Você está preparando a especificação técnica e precisa saber o que fornecer ao AM
Você quer um template de instrução sobre como o Fluxo Controlado deve buscar e tratar os dados da planilha

Pré-requisitos

Ter lido a Parte 2 — Especificação Técnica
Conta Google com permissão sobre a planilha
(Recomendado) Planilha já estruturada com cabeçalho na primeira linha

Sobre este artigo

Este artigo descreve quando faz sentido usar Google Sheets como fonte de dados para o Fluxo Controlado e quais informações ajudam a estruturar a integração. Esses itens não são mais obrigatórios para configurar a planilha, mas servem como referência para uma configuração bem-feita.

Quando usar Google Sheets

Recomendado para cenários como:

Catálogos simples
Tabelas de referência
Status de pedidos/suporte sincronizados manualmente
Listas de elegibilidade
Preços, regras, tabelas de devolução

O que a sua empresa precisa fornecer

Link da planilha
Indicação das abas relevantes
Nome e tipo das colunas importantes
Filtros / lógicas de busca
- Ex: Buscar pelo CPF na coluna A
- Ex: Buscar pelo número do pedido na coluna C
Regras de validação
- Ex: CPF precisa ter 11 dígitos
- Ex: Campo status deve ser um dos valores: novo, em andamento, concluído
Comportamento esperado quando houver:
- 1 resultado
- Múltiplos resultados
- Nenhum resultado
Organização dos dados — incluir exemplos

Importante sobre hospedagem da planilha

A hospedagem da planilha em um Google Drive de domínio @cloudhumans não é mais obrigatória — você pode manter a planilha no seu próprio Drive.

Atenção: para que o time da Cloud Humans consiga atuar em casos de debug, é obrigatório conceder permissão de acesso a alguém do nosso time na planilha.

Exemplo de estrutura da planilha

Formato de instrução (modelo ideal)

Buscar na aba "Pedidos" o registro em que a coluna "CPF" = valor informado pelo usuário.

Retornar: pedido, status, previsão.

Se nenhum resultado → pedir CPF novamente.

Se ainda assim não encontrar → escalar para humano.

Observações

Para o overview do processo de solicitação: Como solicitar um Fluxo Controlado ao time Cloud Humans (comece por aqui)
Para usar API em vez de Sheets: Requisitos de API para utilização no Fluxo Controlado
Para construir o fluxo já com Sheets consumido pelo Fluxo Controlado: Como criar um Fluxo Controlado acessando informações em um Google Sheets
Se você quiser transformar a planilha em uma API HTTP: Como transformar seu Google Sheets em uma API consultável pelo Fluxo Controlado