Registar mensagens do WhatsApp no Airtable e enviar a partir de uma base

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

Porque a Meta verifica um destino antes de entregar seja o que for. Envia um pedido GET com um valor de desafio e espera receber esse mesmo valor no corpo da resposta. O trigger When webhook received do Airtable só aceita pedidos POST e responde com o seu próprio JSON fixo, pelo que a verificação não passa e a Meta nunca começa a entregar.

A solução é um passo intermédio. Um nó Webhook do n8n trata da verificação e recebe cada mensagem, e o nó Airtable do n8n acrescenta uma linha: remetente, nome de perfil, texto, id da mensagem, data e hora e o phone number id que recebeu a mensagem. A mesma estrutura funciona no Make ou no Zapier.

O passo intermédio tem uma segunda vantagem. O trigger de webhook do Airtable admite cinco pedidos por segundo, e uma ferramenta de workflows consegue pôr em fila um pico que, de outro modo, seria recusado.

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

Com uma automação cuja ação seja Run a script. O trigger pode ser um registo a entrar numa vista, um campo a mudar ou um botão a ser clicado. O script lê o telemóvel e os campos do registo através de input.config() e chama o endpoint de mensagens da Cloud API com fetch. Os scripts de automação do Airtable correm no servidor, por isso não há restrições de navegador pelo caminho.

Guarde o token de acesso como segredo no editor de scripts, e não no código. O Airtable oculta os segredos na saída da consola e só permite a edição a quem tenha acesso a todos os segredos de um script.

Use um template para tudo o que o cliente não tenha originado nas últimas 24 horas, já que o texto livre só é entregue dentro dessa janela. O script pode gravar no registo o id da mensagem devolvido, o que associa 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 principal. A Meta repete as entregas que considera falhadas, e um workflow que procura o id antes de acrescentar nunca grava a mesma mensagem duas vezes.

Mantenha um campo de direção com inbound e outbound. Num número Coexistence, as respostas que a equipa escreve na app do WhatsApp Business chegam ao mesmo webhook como eventos smb_message_echoes, e registá-las como linhas outbound dá à base a conversa completa, e não apenas um dos lados.

Associe cada mensagem a uma tabela Contactos, com chave no número de telemóvel só com dígitos, que é o formato que a Meta envia. Um rollup mostra então a hora da última mensagem recebida de cada contacto, e esse único campo é o que uma automação precisa para decidir entre texto livre e template.

Erros comuns

• Definir um URL de webhook do Airtable como destino do número. Só aceita POST, o GET de verificação da Meta falha e nada é entregue.
• Colar o token de acesso no corpo do script. Guarde-o como segredo do script para que fique fora do código e dos registos.
• Enviar texto livre a partir de uma automação de registos a alguém que não escreve há mais de 24 horas. Só um template aprovado é entregue.

Perguntas frequentes

Continue a ler