Conectar Google Sheets ao WhatsApp com OpenClaw
Google Sheets + WhatsApp: Automatize planilhas pelo Chat
Planilhas são o sistema nervoso de muitas empresas brasileiras: controle de vendas, gestão de estoque, relatórios financeiros, CRM simplificado, registro de leads. O problema é que acessar e atualizar planilhas exige abrir o computador, navegar até o Google Sheets e editar manualmente — uma fricção que atrasa decisões e deixa dados desatualizados.
Com o OpenClaw conectando Google Sheets ao WhatsApp, você lê, escreve e analisa dados de qualquer planilha diretamente pelo celular, por mensagem de texto. Sem apps extras, sem planilhas abertas em abas. Você envia “Quantas vendas fizemos hoje?” e recebe a resposta em segundos, direto no WhatsApp.
Essa integração é especialmente poderosa para gestores de vendas, operações e finanças que precisam de dados em tempo real mas estão sempre em movimento — em reuniões, visitas a clientes ou fora do escritório.
O que você consegue fazer:
- Registrar gastos — diga “gastei R$ 350 em material de escritório” e o OpenClaw adiciona à planilha certa
- Atualizar CRM — adicione contatos, atualize status de negócios sem abrir o computador
- Gerar relatórios — peça resumos, totais e comparações por mensagem
- Consolidar dados — combine informações de múltiplas abas em uma resposta clara
Veja como as integrações funcionam e explore o glossário para entender termos como OAuth, API e webhook.
Pré-requisitos
Antes de começar, você precisa:
- ✅ OpenClaw instalado — leva 5 minutos
- ✅ WhatsApp conectado — Certifique-se de que o WhatsApp está conectado ao OpenClaw via QR code. Veja o guia de conexão WhatsApp.
- ✅ Conta Google com acesso ao Google Sheets — com as planilhas que deseja integrar
- ✅ Google Cloud Project com Sheets API habilitada — necessário para autenticação OAuth
Configuração Passo a Passo
Passo 1: Criar Credenciais no Google Cloud
Acesse console.cloud.google.com e:
- Crie um novo projeto ou selecione um existente
- Vá em APIs & Services > Library e ative Google Sheets API e Google Drive API
- Vá em APIs & Services > Credentials > Create Credentials > OAuth 2.0 Client IDs
- Selecione Desktop app, dê um nome e clique em Create
- Baixe o arquivo JSON de credenciais
Passo 2: Configurar a Integração Google Sheets no OpenClaw
Mova o arquivo de credenciais para o diretório do OpenClaw:
cp ~/Downloads/credentials.json ~/.openclaw/google-credentials.json
No config.yaml, adicione:
integrations:
google_sheets:
credentials_file: ~/.openclaw/google-credentials.json
default_spreadsheet_id: "seu-spreadsheet-id-aqui"
scopes:
- "https://www.googleapis.com/auth/spreadsheets"
- "https://www.googleapis.com/auth/drive.readonly"
O ID da planilha está na URL do Google Sheets: docs.google.com/spreadsheets/d/**ID-AQUI**/edit
Passo 3: Autorizar o Acesso (OAuth)
Execute o comando de autorização:
openclaw auth google
Um link será exibido — abra no navegador, autorize com sua conta Google e copie o código de autorização de volta para o terminal. Esse processo é feito uma única vez.
Passo 4: Conectar ao WhatsApp
Certifique-se de que o WhatsApp está conectado ao OpenClaw via QR code. Veja o guia de conexão WhatsApp.
Passo 5: Testar a Conexão
Abra o WhatsApp e envie para o OpenClaw:
“Teste a conexão com Google Sheets”
Se tudo estiver correto, o OpenClaw responde confirmando a integração e exibe o nome da planilha padrão configurada.
Passo 6: Configurar Automações no Soul.md
# Exemplo no soul.md
Quando eu mencionar planilha de vendas, use a aba "Vendas 2026".
Quando eu disser "registre", adicione uma nova linha com data automática.
Formato de data: DD/MM/YYYY.
Moeda: Reais (R$), sem casas decimais.
Exemplos de Uso
Exemplo 1: Registrar Dados por Voz
Envie no WhatsApp:
“Registrar gastos: almoço com cliente R$ 280, Uber R$ 45, material de escritório R$ 120”
O OpenClaw adiciona três linhas na planilha “Despesas” com data, categoria e valor automaticamente preenchidos.
Exemplo 2: Consulta de Dados
Envie no WhatsApp:
“Qual o total de vendas de fevereiro? E como compara com janeiro?”
O OpenClaw lê os dados da planilha e responde: “Vendas de fevereiro: R$ 128.500. Janeiro foi R$ 112.300 — aumento de 14,4%.”
Exemplo 3: Atualizar CRM
Envie no WhatsApp:
“Adicione lead: Empresa ABC, contato Maria Silva, telefone (11) 9 9876-5432, interesse em plano Pro, fonte: indicação”
O OpenClaw preenche a linha do CRM com todos os campos, incluindo data de cadastro e status inicial “Novo”.
Exemplo 4: Relatório Consolidado
Envie no WhatsApp:
“Me dá um resumo da planilha de estoque — o que está com quantidade abaixo do mínimo?”
O OpenClaw lê a planilha, filtra os itens críticos e responde com uma lista formatada de produtos que precisam de reposição.
Dicas e Boas Práticas
- Nomeie abas de forma clara: Use nomes descritivos como “Vendas 2026”, “Despesas Janeiro” ao invés de “Planilha1”. O OpenClaw usa o nome da aba para identificar onde gravar dados.
- Padronize cabeçalhos: Mantenha a primeira linha sempre com cabeçalhos claros em português. Isso facilita a leitura automática dos dados.
- Crie abas de configuração: Tenha uma aba “Config” com categorias, produtos e outros dados fixos que o OpenClaw pode consultar para preencher automaticamente.
- Use alertas automáticos: Configure o OpenClaw para monitorar a planilha e te avisar quando um valor ultrapassar um limite. Veja receitas prontas para exemplos.
- Proteja dados sensíveis: Compartilhe apenas as planilhas necessárias com as credenciais do OpenClaw. Veja o guia de segurança.
Solução de Problemas Comuns
| Problema | Solução |
|---|---|
| “Integração não responde” | Verifique se as APIs estão habilitadas no Google Cloud Console |
| “Erro de autenticação” | Execute openclaw auth google novamente para renovar o token |
| “Mensagens não chegam no WhatsApp” | Confirme que o WhatsApp está conectado com openclaw status |
| “Não encontra a planilha” | Verifique o spreadsheet_id no config.yaml — copie da URL do Sheets |
| “Erro de permissão” | Certifique-se que o e-mail autorizado tem acesso à planilha |
| “Dados gravados na aba errada” | Especifique o nome da aba no soul.md ou na mensagem |
Para problemas adicionais, consulte o guia de troubleshooting ou os artigos do blog.
FAQ
O OpenClaw pode criar novas planilhas?
Sim, com a permissão drive.file nas credenciais, o OpenClaw pode criar novas planilhas. Envie “Crie uma planilha chamada Controle de Projetos 2026 com colunas: Nome, Status, Responsável, Prazo”.
Quantas planilhas posso conectar? Você pode conectar quantas planilhas quiser. Basta mencionar o nome ou ID da planilha no soul.md ou diretamente na mensagem ao OpenClaw.
O Google Sheets tem limite de requisições? A API gratuita permite 100 requisições por 100 segundos por usuário. Para uso normal, isso é mais que suficiente. Para automações de alta frequência, considere implementar cache no OpenClaw.
Funciona com Google Sheets compartilhados por terceiros? Sim, desde que a conta autorizada tenha pelo menos permissão de “Visualizador” para leitura ou “Editor” para escrita na planilha compartilhada.
Posso usar fórmulas do Sheets nas respostas? O OpenClaw lê os valores calculados pelas fórmulas, não as fórmulas em si. Para gravar, ele escreve valores diretos, não fórmulas.
Próximos Passos
- Receitas prontas com Google Sheets — automações de registro e relatórios
- Skills personalizados — crie funções avançadas de análise de dados
- Integrações disponíveis — conecte Gmail, Google Calendar e mais
- Outros canais disponíveis — use a mesma integração no Telegram ou Slack
- Guia de segurança — proteja suas credenciais do Google
- FAQ geral — perguntas frequentes sobre o OpenClaw