Quem já precisou organizar as finanças no fim do mês sabe como é cansativo abrir o extrato bancário e classificar linha por linha: alimentação, transporte, assinaturas, lazer. Esse processo manual consome horas preciosas e abre margem para erros. Felizmente, hoje é possível transformar o Google Sheets em um assistente financeiro inteligente e autônomo ao integrá-lo diretamente com a API da OpenAI.
Neste guia prático, você aprenderá a conectar essas duas ferramentas para que sua planilha leia descrições confusas de transações bancárias e as categorize no piloto automático em questão de segundos.
Por que usar Inteligência Artificial nas finanças?
Os extratos bancários costumam apresentar nomes de estabelecimentos abreviados ou confusos (exemplo: PAG*RestBomGosto ou UBR* TRIP HELP). Fórmulas tradicionais como SE ou PROCV exigem regras rígidas e quebram facilmente diante de variações.
Modelos de linguagem como o GPT-4o-mini entendem o contexto semântico, identificam o tipo de serviço por trás do código e atribuem categorias padronizadas de forma muito mais precisa e flexível.
Passo a passo: Configurando a API no Google Sheets
1. Crie sua chave de API na OpenAI
Acesse a plataforma da OpenAI (platform.openai.com), faça login, vá até a seção API Keys e crie uma nova chave secreta. Guarde-a com segurança, pois ela só é exibida uma vez.
2. Adicione o código no Google Apps Script
No Google Planilhas, clique em Extensões > Apps Script. Substitua o código existente pela função abaixo:
function CATEGORIZAR_GASTO(descricao) {
var apiKey = "SUA_CHAVE_API_AQUI";
var url = "https://api.openai.com/v1/chat/completions";
var payload = {
"model": "gpt-4o-mini",
"messages": [
{"role": "system", "content": "Você é um assistente financeiro. Categorize a transação em uma destas opções: Alimentação, Transporte, Moradia, Saúde, Lazer, Educação ou Outros. Responda APENAS com a categoria."},
{"role": "user", "content": descricao}
],
"temperature": 0.2
};
var options = {
"method": "post",
"contentType": "application/json",
"headers": {"Authorization": "Bearer " + apiKey},
"payload": JSON.stringify(payload)
};
var response = UrlFetchApp.fetch(url, options);
var json = JSON.parse(response.getContentText());
return json.choices[0].message.content.trim();
}Substitua SUA_CHAVE_API_AQUI pela sua chave real, salve e feche o editor.
3. Use a nova fórmula na planilha
Agora, basta usar a função como qualquer outra fórmula nativa. Se a descrição do extrato estiver na célula A2, digite na coluna ao lado: =CATEGORIZAR_GASTO(A2).
Prompt pronto para copiar e personalizar
Se você preferir rodar lotes manuais no ChatGPT antes de colar na planilha, utilize este prompt estruturado:
Prompt:
“Atue como um analista financeiro. Analise a lista de transações bancárias abaixo e retorne uma tabela com duas colunas: [Transação Original] e [Categoria Padronizada]. Use apenas as categorias: Alimentação, Moradia, Transporte, Saúde, Assinaturas, Lazer e Investimentos. Aqui estão as transações: [Cole suas linhas de extrato aqui]”
Comparativo: Script Próprio vs. Complementos Prontos
| Método | Vantagens | Desvantagens |
|---|---|---|
| Apps Script (Próprio) | Custo mínimo (paga só uso da API), total controle do código. | Exige configuração inicial simples de código. |
| Extensões (Ex: GPT for Sheets) | Interface pronta, fácil de ativar via Marketplace. | Planos mensais pagos para volumes maiores. |
Erros comuns e cuidados com privacidade
- Dados sensíveis: Nunca envie números de cartão de crédito, CPF, saldos totais ou senhas para a API. Envie exclusivamente a descrição textual do lançamento.
- Limite de requisições: Arrastar a fórmula para centenas de linhas de uma só vez pode atingir limites de taxa (rate limits). Processe em lotes moderados.
- Controle de custos: Configure limites de gastos mensais (hard limit) diretamente no painel de cobrança da OpenAI para evitar surpresas.
Perguntas Frequentes (FAQ)
Quanto custa categorizar extratos com a API da OpenAI?
Utilizando o modelo gpt-4o-mini, categorizar cerca de 1.000 lançamentos custa menos de R$ 0,10, tornando a solução extremamente acessível.
Posso adicionar categorias personalizadas?
Sim. Basta editar a lista de categorias dentro da mensagem system no código do script ou no prompt.
Conclusão
A integração entre o Google Sheets e a inteligência artificial generativa redefine a forma como lidamos com a gestão financeira. O que antes exigia horas de trabalho repetitivo agora é executado em segundos, permitindo que você concentre sua energia no que realmente importa: analisar seus hábitos de consumo, identificar desperdícios e planejar metas de economia.
Comece implementando o script com poucos lançamentos para validar a precisão das categorias e ajuste as instruções do modelo conforme as particularidades do seu extrato. Aproveite para conferir nossos artigos sobre automações com Google Apps Script e dicas de prompts para produtividade para levar seu fluxo de trabalho ao próximo nível!
