--- title: "Conectar Google Sheets ao WhatsApp com OpenClaw" url: "https://openclaw.ia.br/conectar/google-sheets-whatsapp/" markdown_url: "https://openclaw.ia.br/conectar/google-sheets-whatsapp.MD" description: "Guia passo a passo para conectar Google Sheets ao WhatsApp via OpenClaw. Leia e escreva dados em planilhas automaticamente direto do WhatsApp." date: "2026-02-09" author: "" --- # Conectar Google Sheets ao WhatsApp com OpenClaw Guia passo a passo para conectar Google Sheets ao WhatsApp via OpenClaw. Leia e escreva dados em planilhas automaticamente direto do WhatsApp. ## 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](/integracoes/) e explore o [glossário](/glossario/) para entender termos como OAuth, API e webhook. ## Pré-requisitos Antes de começar, você precisa: 1. ✅ **[OpenClaw instalado](/instalacao/)** — leva 5 minutos 2. ✅ **WhatsApp conectado** — Certifique-se de que o WhatsApp está conectado ao OpenClaw via QR code. Veja o [guia de conexão WhatsApp](/canais/whatsapp/). 3. ✅ **Conta Google com acesso ao Google Sheets** — com as planilhas que deseja integrar 4. ✅ **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](https://console.cloud.google.com) e: 1. Crie um novo projeto ou selecione um existente 2. Vá em **APIs & Services > Library** e ative **Google Sheets API** e **Google Drive API** 3. Vá em **APIs & Services > Credentials > Create Credentials > OAuth 2.0 Client IDs** 4. Selecione **Desktop app**, dê um nome e clique em **Create** 5. 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: ```bash cp ~/Downloads/credentials.json ~/.openclaw/google-credentials.json ``` No `config.yaml`, adicione: ```yaml 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: ```bash 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](/canais/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 ```yaml # 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](/receitas/) para exemplos. - **Proteja dados sensíveis**: Compartilhe apenas as planilhas necessárias com as credenciais do OpenClaw. Veja o [guia de segurança](/seguranca/). ## 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](/troubleshooting/) ou os [artigos do blog](/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](/receitas/) — automações de registro e relatórios - [Skills personalizados](/skills/) — crie funções avançadas de análise de dados - [Integrações disponíveis](/integracoes/) — conecte Gmail, Google Calendar e mais - [Outros canais disponíveis](/canais/) — use a mesma integração no Telegram ou Slack - [Guia de segurança](/seguranca/) — proteja suas credenciais do Google - [FAQ geral](/faq/) — perguntas frequentes sobre o OpenClaw