Salve mensagens e contatos do WhatsApp no Google Sheets automaticamente
Para salvar mensagens do WhatsApp Business no Google Sheets automaticamente, envie-as como POSTs HTTP assinados para uma ferramenta de automação, como n8n, Make ou Zapier, e deixe que o passo do Google Sheets adicione uma linha por mensagem com horário, direção, número de telefone, nome, texto e id da mensagem. Uma segunda aba, com o número de telefone como chave, mantém uma linha por contato, atualizada sempre que ele escreve de novo.
O easyCoexistence conecta o número do WhatsApp Business que você mantém no app à Cloud API da Meta por meio da Coexistência.
Entregas encaminhadas são repetidas após cerca de 1, 5, 30, 120, 360 e 1.440 minutos quando a sua URL falha.
Tempo que um POST encaminhado espera por uma resposta 2xx antes que essa entrega seja repetida.
Requisições de escrita na API do Google Sheets permitidas por minuto, por usuário e por projeto; 300 por projeto.
A saída de um web app do Apps Script é redirecionada para uma URL de uso único em script.googleusercontent.com.
O objeto de evento do doPost no Apps Script expõe o corpo e os parâmetros, mas não os cabeçalhos HTTP da requisição.
Qual rota deve preencher a planilha?
Um número cujas mensagens passam pelo easyCoexistence tem duas rotas, e elas atendem a necessidades diferentes. A Forward URL, configurada uma vez por número, repassa os eventos originais da Meta, haja ou não uma automação respondendo: mensagens dos clientes, as respostas que sua equipe digita no app do WhatsApp Business e os status de entrega. É a rota para um registro completo de mensagens. Um passo Call my webhook dentro de uma automação dispara apenas para as mensagens que essa automação escolhe e traz o chat recente, incluindo a resposta que a automação acabou de enviar. Serve para uma planilha de leads, pedidos ou solicitações que uma única automação atende. As duas rotas são assinadas, com segredos diferentes.
| Forward URL (per number) | Call my webhook step (per automation) | |
|---|---|---|
| Fires on | Any message event on the number, with or without automations | Only messages that automation is picked for |
| Carries | Meta's original value: messages, phone replies, statuses | The message, the contact and up to 10 recent messages |
| Automated replies | Delivery statuses only, without the text | In history, direction out |
| Retries | 7 attempts over about 33 hours | One attempt |
| Signed with | The number's forward secret, shown once | The automation's Signing secret |
| Set in | Number page, Where incoming messages go card | The automation editor, or create_automation |
Quais campos chegam e quais colunas a planilha deve ter?
Cada POST encaminhado encapsula uma mudança da Meta: id (a entrega), event (o nome do campo da Meta, como messages ou smb_message_echoes), received_at, connection (o id, o phone e o phone_number_id do seu número) e value, exatamente como a Meta enviou. Dentro de value, messages traz o que os clientes escreveram e message_echoes traz o que sua equipe digitou no telefone. Os números de telefone chegam como dígitos, com o código do país e sem o sinal de mais; formate essa coluna como texto simples para que o Sheets não a converta em número. Um usuário com nome de usuário do WhatsApp pode chegar com um ID de usuário com escopo de negócio ao lado do número, ou no lugar dele, então reserve uma coluna para esse ID.
Como montar o registro de mensagens no n8n?
São três nós. Um nó Webhook com HTTP Method POST, Respond definido como Immediately e a Production URL salva como a Forward URL do número. Um nó Code que verifica o X-EC-Signature com o segredo de encaminhamento e transforma o evento em linhas, ignorando os status de entrega. Um nó Google Sheets com a operação Append or Update Row e Column to match on definido como Message id, para que uma entrega repetida reescreva a mesma linha em vez de adicionar outra.
O segredo de encaminhamento aparece uma única vez, quando você salva a Forward URL; se ele se perder, clique em New secret e cole o novo. O n8n Cloud permite o módulo crypto nos nós Code; o n8n self-hosted precisa de NODE_FUNCTION_ALLOW_BUILTIN=crypto.
const crypto = require('crypto');
const SECRET = 'whsec_...'; // the number's forward secret, shown once when you saved the Forward URL
const { headers, body } = $input.first().json;
const sig = /^t=(\d+),v1=([0-9a-f]{64})$/.exec(headers['x-ec-signature'] || '');
if (!sig || Math.abs(Date.now() / 1000 - Number(sig[1])) > 300) throw new Error('Bad or stale signature');
// n8n has parsed the body; it was sent as compact JSON, so JSON.stringify rebuilds the signed bytes.
const mac = crypto.createHmac('sha256', SECRET).update(sig[1] + '.' + JSON.stringify(body)).digest();
if (!crypto.timingSafeEqual(mac, Buffer.from(sig[2], 'hex'))) throw new Error('Bad signature');
const { event, connection, value } = body;
const names = Object.fromEntries((value.contacts || []).map((c) => [c.wa_id, c.profile?.name || '']));
const textOf = (m) => m.text?.body ?? m.button?.text ?? m.interactive?.button_reply?.title
?? m.interactive?.list_reply?.title ?? ('[' + m.type + '] ' + (m[m.type]?.caption || '')).trim();
const row = (m, direction, phone) => ({
time: new Date(Number(m.timestamp) * 1000).toISOString(), direction, phone,
user_id: m.from_user_id || '', name: names[phone] || '', text: textOf(m),
message_id: m.id, number: connection.phone,
});
let rows = [];
if (event === 'messages') rows = (value.messages || []).map((m) => row(m, 'in', m.from || '')); // statuses skipped
if (event === 'smb_message_echoes') rows = (value.message_echoes || []).map((m) => row(m, 'out', m.to || ''));
return rows.map((json) => ({ json }));Como manter uma linha por contato?
Adicione um segundo nó Google Sheets apontando para uma aba Contacts, também com Append or Update Row e Phone como coluna de correspondência. Mapeie o telefone, o nome do perfil, o ID de usuário, o horário e o texto da última mensagem. A primeira mensagem de um número cria a linha dele; as seguintes atualizam o nome e as colunas de último contato, então a aba também funciona como lista de quem escreveu e quando. Guarde anotações manuais em uma aba separada, consultada pelo telefone, para que o workflow nunca as sobrescreva.
Os contatos salvos na agenda do telefone não chegam por esse caminho. A Meta os envia, junto com até 6 meses de conversas, somente para um destino de webhook direto salvo em até 24 horas após a conexão do número.
O Apps Script pode receber as mensagens diretamente?
Não de forma limpa, então coloque uma ferramenta de workflow antes da planilha. O Google entrega a resposta de um web app do Apps Script por meio de um redirecionamento para uma URL de uso único em script.googleusercontent.com, e o easyCoexistence não segue redirecionamentos. O 302 conta como entrega com falha: um encaminhamento é repetido até 7 vezes, e cada repetição executa o doPost de novo e grava outra linha, enquanto um passo Call my webhook falha e envia um e-mail para você. Além disso, o doPost não consegue ler os cabeçalhos da requisição, então não há como verificar o X-EC-Signature ali.
O Apps Script continua sendo uma boa opção para o sentido contrário, enviar templates aprovados a partir das linhas de uma planilha, tema que a página da integração com o Google Sheets cobre com código.
Dá para usar o Make ou o Zapier para preencher a planilha?
Sim. No Make, comece o cenário com Webhooks > Custom webhook e adicione Google Sheets > Add a Row; no Zapier, use Webhooks by Zapier com Catch Raw Hook, que preserva os cabeçalhos, e depois Google Sheets > Create Spreadsheet Row. Os dois respondem ao POST na hora com um 2xx, que é o que um encaminhamento exige dentro do prazo de 10 segundos. Mapeie os mesmos campos descritos acima a partir de value.messages e filtre os eventos cujo value traz statuses em vez de messages.
Trate a URL do hook como uma senha, já que qualquer pessoa que a tenha pode gravar linhas. Se o seu plano incluir um passo de código, verifique ali o X-EC-Signature com a mesma receita HMAC usada no nó do n8n.
Como evitar linhas duplicadas ou faltantes?
As duplicatas vêm das repetições. Um encaminhamento que não recebeu um 2xx em 10 segundos é enviado de novo com o mesmo cabeçalho X-EC-Delivery e o mesmo id no corpo, e as mensagens dentro dele mantêm o wamid; por isso, usar o Message id como coluna de correspondência torna a repetição inofensiva. Na rota do passo de webhook, os testes feitos em Try it chegam com dry_run true: direcione-os para uma aba de teste ou descarte-os.
As linhas faltantes vêm da cota de escrita do Google. A API do Sheets permite 60 requisições de escrita por minuto, por usuário e por projeto, e uma credencial do n8n equivale a um usuário; uma rajada de respostas depois de uma campanha de templates pode ultrapassar esse limite e receber HTTP 429. Ative Retry On Fail nas configurações do nó Google Sheets ou acumule as mensagens por alguns segundos e adicione-as em uma única requisição.
Como configurar
- Check the number's modeOn the number's page, the card Where incoming messages go must show Through easyCoexistence. If it shows Straight to your system, choose Through easyCoexistence.
- Build the workflowWebhook node (POST, Respond Immediately), the Code node above, then Google Sheets with Append or Update Row matched on Message id. Activate it and copy the Production URL.
- Save the Forward URLPaste the Production URL into Forward URL (optional) and click Save forward URL. Copy the signing secret shown once into the Code node.
- Send a test messageFrom another phone, write to your number and reply to it from the WhatsApp Business app. Two rows should appear: one in, one out.
Erros comuns
- Verificar um encaminhamento com o Signing secret de uma automação, ou o contrário. A Forward URL é assinada com o segredo de encaminhamento do número, e o Call my webhook com o segredo da própria automação; escolha o segredo pelo cabeçalho X-EC-Event.
- Adicionar uma linha por POST sem chave. Uma entrega repetida após uma resposta lenta grava a mesma mensagem duas vezes; use Append or Update Row com o id da mensagem como coluna de correspondência.
- Gravar status de entrega como mensagens. O evento messages também traz os status sent, delivered e read em value.statuses, que não têm texto e geram linhas vazias.
- Salvar a URL de um web app do Apps Script como Forward URL. O redirecionamento conta como falha, então cada uma das 7 tentativas executa o doPost de novo e adiciona uma linha duplicada.
Com as automações ativadas, uma Forward URL repassa os eventos originais da Meta para o seu workflow, assinados com um segredo que só você tem e repetidos quando a sua URL está fora do ar, e um passo Call my webhook envia o que uma automação atendeu, junto com a resposta dela. As duas rotas estão incluídas no plano. De US$ 9 (R$ 29,90) até US$ 0,75 (R$ 3,90) por número por mês, caindo conforme você adiciona números, com os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
A planilha recebe as mensagens que minha equipe digita no celular?
Sim, pela Forward URL. As respostas digitadas no app do WhatsApp Business chegam como eventos smb_message_echoes, com o número do cliente em to. As respostas enviadas por automações voltam apenas como status de entrega, então registre o texto delas com um passo Call my webhook colocado depois da resposta.
Posso importar minhas conversas antigas para a planilha?
Não em um número cujas mensagens passam pelo easyCoexistence. A Meta envia até 6 meses de conversas individuais somente para um destino de webhook direto salvo em até 24 horas após a conexão, uma única vez por conexão. Um número roteado pelo easyCoexistence registra a partir do momento em que a Forward URL é salva.
O easyCoexistence guarda uma cópia das mensagens?
Em parte. Em um número roteado pela easyCoexistence com automações ativadas, o texto das mensagens fica guardado pelo período que você escolher, 30, 90 ou 365 dias (90 por padrão), e aparece em Conversas; as entregas encaminhadas ficam retidas por até 7 dias para novas tentativas, e os logs de execução por 30 dias. A planilha é a sua cópia permanente.
Minha IA pode consultar a planilha para responder aos clientes?
Não a partir de um passo Reply with AI, que lê apenas as suas Instructions e o chat. Um agente de IA pode consultar dados por meio de uma ferramenta HTTP personalizada, e um passo Call my webhook ou Call an API pode enviar a pergunta a um workflow que busca a resposta na planilha e a devolve como resposta.
Continue lendo
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátisVerificado em