GPT com Google Sheets para finanças: passo a passo

Sim, é possível conectar o GPT a uma planilha do Google Sheets usando o Google Apps Script e a API da OpenAI. Com cerca de 30 linhas de código, você cria uma função personalizada que envia dados da planilha para o GPT e retorna a resposta direto em uma célula. Não é necessário saber programação avançada — este guia mostra cada passo.

Aviso importante: a API da OpenAI é um serviço pago (cobrando por tokens utilizados). Mantenha sua chave de API privada e jamais a insira em uma planilha compartilhada publicamente. Não insira dados bancários sensíveis (senhas, números de conta, CPF) nas chamadas para a API.

O que você precisa antes de começar

• Conta Google com acesso ao Google Sheets (gratuito).
• Chave de API da OpenAI: crie em platform.openai.com/api-keys. Exige cadastro e configuração de método de pagamento.
• Notas sobre custo: chamadas à API do GPT-4o são cobradas por token. Para uso financeiro pessoal (planilha de orçamento, categorização de gastos), o custo mensal costuma ser baixo — mas defina limites de uso no painel da OpenAI para evitar surpresas.

Veja também: A Revolução das Finanças Digitais e o Papel da IA nas Transações Cambiais.

Passo a passo: conectando GPT ao Google Sheets

Passo 1 — Abrir o editor de scripts

Na sua planilha do Google Sheets, clique em Extensões > Apps Script. Isso abre o editor de código diretamente no navegador, sem instalar nada.

Passo 2 — Inserir o código de integração

Apague o código padrão que aparece e cole o seguinte:

const OPENAI_API_KEY = "sk-SEU_TOKEN_AQUI"; // substitua pela sua chave real

function GPT(prompt) {
  if (!prompt) return "Prompt vazio.";

  const url = "https://api.openai.com/v1/chat/completions";
  const payload = {
    model: "gpt-4o-mini", // modelo mais barato; troque por gpt-4o se quiser mais qualidade
    messages: [{ role: "user", content: String(prompt) }],
    max_tokens: 300
  };

  const options = {
    method: "post",
    contentType: "application/json",
    headers: { Authorization: "Bearer " + OPENAI_API_KEY },
    payload: JSON.stringify(payload),
    muteHttpExceptions: true
  };

  const response = UrlFetchApp.fetch(url, options);
  const json = JSON.parse(response.getContentText());

  if (json.error) return "Erro: " + json.error.message;
  return json.choices[0].message.content.trim();
}

Clique em Salvar (atalho Ctrl+S ou Cmd+S) e dê um nome ao projeto (ex.: “GPT Finanças”).

Passo 3 — Autorizar o script

Na primeira execução, o Google pede autorização para o script fazer requisições externas. Clique em Revisar permissões e depois em Permitir. Essa permissão é necessária porque o script precisa acessar a internet (API da OpenAI).

Passo 4 — Usar a função =GPT() na planilha

Depois de salvar o script, a função =GPT() fica disponível na planilha como qualquer fórmula nativa. Exemplos de uso:

• =GPT("Categorize este gasto: "&A2) — onde A2 contém a descrição do gasto.
• =GPT("Qual a diferença entre CDI e Selic em uma frase?")
• =GPT("Resuma em 2 linhas: "&B5)

Exemplos práticos para gestão financeira

Exemplo 1 — Categorizar gastos automaticamente

Imagine que a coluna A tem descrições de transações (“Ifood”, “Posto de gasolina”, “Netflix”). Na coluna B, use:

=GPT("Categorize este gasto em uma palavra (Alimentação, Transporte, Lazer, Saúde, Moradia, Outro): "&A2)

O GPT devolve a categoria na célula. Arraste a fórmula para todas as linhas.

Exemplo 2 — Gerar resumo do orçamento

Monte uma célula que concatena os totais por categoria e peça ao GPT uma análise rápida:

=GPT("Analise este orçamento mensal e diga se está equilibrado: Alimentação R$"&B10&", Transporte R$"&B11&", Lazer R$"&B12&", Moradia R$"&B13&". Renda: R$"&B3)

Exemplo 3 — Tirar dúvidas sobre produtos financeiros

Crie uma aba de “Consultor” com uma célula de entrada (ex.: D2) e outra de resposta:

=GPT(D2)

Digite sua dúvida em D2 (ex.: “O que é um CDB prefixado?”) e a resposta aparece automática na célula de resultado.

Boas práticas e segurança

• Nunca compartilhe a planilha com a chave de API exibida. Se precisar compartilhar, remova a chave do código primeiro e use variáveis de propriedades do script (PropertiesService) para armazenar credenciais com mais segurança.
• Defina limites de gasto na OpenAI: acesse Settings > Limits no painel da OpenAI e configure um teto mensal.
• Use gpt-4o-mini para tarefas simples: ele é muito mais barato que o GPT-4o completo e suficiente para categorização de gastos e consultas educacionais.
• Evite dados pessoais sensíveis nas células conectadas à API: use valores genéricos e descrições sem CPF, nome completo ou dados bancários.
• Cache manual: se a mesma categoria precisar ser calculada muitas vezes, copie os resultados como “valores” (Ctrl+Shift+V) para evitar chamadas repetidas à API.

Alternativas sem código

Se preferir não escrever scripts, existem opções:

• GPT for Sheets and Docs: extensão do Google Workspace Marketplace que adiciona funções GPT à planilha sem código. Xequer disponibilidade e termos antes de usar.
• Zapier ou Make (ex-Integromat): permitem criar automações entre Google Sheets e a API da OpenAI sem programar.
• Usar o ChatGPT diretamente: copie os dados (sem informações sensíveis) e cole no chat para obter análises manuais.

Perguntas Frequentes

Preciso saber programar para usar a API da OpenAI no Google Sheets?

Não é obrigatório saber programação. O código deste artigo está pronto para copiar e funciona sem modificação, bastando substituir a chave de API. Se quiser personalizar, o Google Apps Script usa JavaScript com sintaxe simples.

Qual o custo real de usar a API da OpenAI para planilhas financeiras pessoais?

Depende do volume de chamadas. Para uso pessoal (categorizar 100-200 transaões por mês com o modelo gpt-4o-mini), o custo tende a ser inferior a US$ 1 por mês. Consulte a página de preços da OpenAI em openai.com/api/pricing para valores atualizados.

O GPT integrado ao Sheets pode recomendar onde investir?

Não com validade formal. O GPT pode explicar conceitos, comparar características de produtos financeiros e ajudar a organizar informações, mas não é analista de valores mobiliários credenciado pela CVM. Decisões de investimento devem ser validadas com um profissional regulamentado.

O Google Sheets salva minha chave de API com segurança?

A chave fica no código do Apps Script, que só é visível para quem tem acesso de editor à planilha. Para uma camada extra de segurança, use PropertiesService.getScriptProperties() para armazenar a chave fora do código visível. Nunca compartilhe a planilha com permissão de edição para pessoas que não devem ver a chave.

Conclusão

Conectar o GPT ao Google Sheets é um processo direto que não exige conhecimento avançado. Com o código deste artigo, você tem uma função =GPT() funcional em menos de 10 minutos. Use-a para categorizar gastos, tirar dúvidas sobre produtos financeiros e gerar resumos de orçamento.

Lembre-se das duas regras de ouro: mantenha a chave de API privada e nunca insira dados pessoais sensíveis nas chamadas. Com esses cuidados, a integração é segura e útil para o dia a dia financeiro.