WPPAPI
Guia · Planilhas

WhatsApp → Google Sheets, direto e sem código

"A mensagem do WhatsApp cai na planilha" — o caso de automação mais pedido, agora nativo: leads e mensagens em linhas, configurado em 2 minutos pelo painel.

Como funciona por baixo: cada mensagem recebida na instância dispara a integração, que escreve uma linha na planilha via API do Google com a sua conta conectada (OAuth). A idempotência por ID de mensagem garante que reentregas não duplicam linhas, e falhas do Google são retentadas com backoff antes de aparecerem como erro visível no painel.
1

Conecte sua conta Google

No painel da WPPAPI, abra Contas conectadas e clique em Conectar Google. Autorize com a conta que tem acesso à planilha — a permissão de planilhas (Sheets + metadados do Drive) já é solicitada no fluxo. Os tokens ficam criptografados e nunca aparecem na API.

2

Crie (ou escolha) a planilha

Qualquer planilha do Google serve. As colunas gravadas são: data/hora, telefone, nome, tipo, mensagem e instância. Deixe a primeira linha para o seu cabeçalho, se quiser.

3

Ative o Google Sheets na instância

No detalhe da instância, aba Integrações → Google Sheets: escolha a conta conectada, a planilha (no seletor ou colando a URL) e a aba. Escolha o modo: todas as mensagens recebidas ou apenas o primeiro contato de cada número (modo leads). Salve e pronto.

4

Veja as mensagens caírem na planilha

Cada mensagem recebida no WhatsApp vira uma linha em segundos. Reentregas não duplicam linhas (idempotência por ID de mensagem) e qualquer falha fica visível no painel, no campo de erro da integração.

Colunas gravadas

data/hora (ISO) · telefone · nome · tipo · mensagem · instância — no modo leads, o modo primeiro contato grava uma única linha por número, perfeita para planilhas de campanha alimentarem CRM e relatórios.

Perguntas frequentes

Qual a diferença entre os dois modos?

Todas as mensagens grava cada mensagem recebida — ideal para logs e auditoria. Primeiro contato (leads) grava só a primeira mensagem de cada número — ideal para captar leads de campanhas sem poluir a planilha.

Preciso instalar algo ou mexer em código?

Não. A configuração é 100% pelo painel: conectar a conta Google, escolher planilha e aba, salvar. A escrita é feita pela WPPAPI direto na API do Google.

E se a planilha estiver cheia ou a API do Google falhar?

Falhas são retentadas automaticamente com backoff e, se persistirem, aparecem no painel (campo de erro da integração) — sem derrubar o recebimento de mensagens nem os webhooks. A API do Sheets permite centenas de escritas por minuto, suficiente para o volume típico de uma instância.

A WPPAPI escreve na planilha em nome de quem?

Da conta Google que você conectou. Você pode revogar o acesso a qualquer momento em myaccount.google.com/permissions ou desconectando a conta no painel.

Veja também: lista completa de integrações eChatwoot + WhatsApp para atendimento humano.

Sua primeira linha na planilha hoje

A integração nativa está disponível desde o trial — 3 dias grátis, sem cartão.

Criar conta grátis