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

Quando usar

• Você quer usar Google Sheets como fonte de dados para um fluxo Eddie (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 Eddie 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 Eddie e o que sua empresa precisa fornecer para que o time Cloud Humans configure a integração.

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

1. Link da planilha

2. Indicação das abas relevantes

3. Nome e tipo das colunas importantes

4. Filtros / lógicas de busca

   • Ex: Buscar pelo CPF na coluna A

   • Ex: Buscar pelo número do pedido na coluna C

5. Regras de validação

   • Ex: CPF precisa ter 11 dígitos

   • Ex: Campo status deve ser um dos valores: novo, em andamento, concluído

6. Comportamento esperado quando houver:

   • 1 resultado

   • Múltiplos resultados

   • Nenhum resultado

7. Organização dos dados — incluir exemplos

8. Permissões de acesso

   • Dar acesso ao service account da Cloud Humans

   • Ou tornar a aba de consulta publicamente acessível (somente leitura)

Importante sobre hospedagem da 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 Eddie ao time Cloud Humans (comece por aqui)

• Para usar API em vez de Sheets: Requisitos de API para utilização no Eddie

• Para construir o fluxo já com Sheets consumido pelo Eddie: Como criar um fluxo no Eddie 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 Eddie