Registre mensagens do WhatsApp no Airtable e envie a partir de uma base

Por que o Airtable não consegue receber webhooks do WhatsApp diretamente?

Porque a Meta verifica o destino antes de entregar qualquer coisa. Ela envia uma requisição GET com um valor de desafio e espera receber o mesmo valor no corpo da resposta. O gatilho When webhook received do Airtable só aceita requisições POST e responde com um JSON fixo próprio, então a verificação não passa e a Meta nunca começa a entregar.

A solução é um passo intermediário. Um nó Webhook do n8n cuida da verificação e recebe cada mensagem, e o nó Airtable do n8n adiciona uma linha: remetente, nome do perfil, texto, id da mensagem, horário e o phone number id que recebeu. O mesmo formato funciona no Make ou no Zapier.

O passo intermediário traz um segundo benefício. O gatilho de webhook do Airtable permite cinco requisições por segundo, e uma ferramenta de workflow consegue enfileirar um pico que, de outra forma, seria recusado.

Como enviar um template de WhatsApp a partir de uma base do Airtable?

Com uma automação cuja ação é Run a script. O gatilho pode ser um registro entrando em uma view, um campo mudando ou um botão sendo clicado. O script lê o telefone e os campos do registro por input.config() e chama o endpoint de mensagens da Cloud API com fetch. Os scripts de automação do Airtable rodam no servidor, então não há restrição de navegador no caminho.

Guarde o token de acesso como secret no editor de scripts, e não no código. O Airtable oculta os secrets na saída do console e só deixa editar o script quem tem acesso a todos os secrets dele.

Use um template para qualquer contato que o cliente não tenha iniciado nas últimas 24 horas, já que texto livre só é entregue dentro dessa janela de atendimento. O script pode gravar de volta no registro o id da mensagem retornado, o que liga o envio à linha.

const { phone, name } = input.config();
const token = input.secret("WHATSAPP_TOKEN");
const res = await fetch(
  "https://graph.facebook.com/v23.0/<PHONE_NUMBER_ID>/messages",
  {
    method: "POST",
    headers: { Authorization: "Bearer " + token, "Content-Type": "application/json" },
    body: JSON.stringify({
      messaging_product: "whatsapp",
      to: phone,
      type: "template",
      template: {
        name: "order_ready",
        language: { code: "en" },
        components: [{ type: "body", parameters: [{ type: "text", text: name }] }],
      },
    }),
  },
);
output.set("result", await res.json());

Como deve ser a tabela de mensagens?

Uma linha por mensagem, com o id da mensagem do WhatsApp como campo primário. A Meta repete as entregas que considera falhas, e um workflow que consulta o id antes de adicionar nunca grava a mesma mensagem duas vezes.

Mantenha um campo de direção com inbound e outbound. Em um número Coexistência, as respostas que a equipe digita no app do WhatsApp Business chegam ao mesmo webhook como eventos smb_message_echoes, e registrá-las como linhas outbound dá à base a conversa completa, e não só um lado dela.

Ligue cada mensagem a uma tabela Contacts com chave no telefone só com dígitos, que é a forma que a Meta envia. Um rollup mostra então o horário da última mensagem inbound de cada contato, e esse único campo é o que uma automação precisa para decidir entre texto livre e template.

Erros comuns

• Definir a URL de um webhook do Airtable como destino do número. Ele aceita só POST, o GET de verificação da Meta falha e nada é entregue.
• Colar o token de acesso no corpo do script. Guarde-o como secret do script para que fique fora do código e dos logs.
• Enviar texto livre de uma automação de registro para quem não escreveu nas últimas 24 horas. Só um template aprovado é entregue.

Perguntas frequentes

Continue lendo