WhatsApp-berichten loggen in Airtable en versturen vanuit een base

Waarom kan Airtable geen WhatsApp-webhooks rechtstreeks ontvangen?

Omdat Meta een bestemming controleert voordat er iets wordt afgeleverd. Meta stuurt een GET-verzoek met een challenge-waarde en verwacht dezelfde waarde terug als body van het antwoord. De trigger When webhook received van Airtable accepteert alleen POST-verzoeken en antwoordt met zijn eigen vaste JSON, dus de controle kan niet slagen en Meta begint nooit met afleveren.

De oplossing is één stap ertussen. Een n8n Webhook-node handelt de verificatie af en ontvangt elk bericht, en de Airtable-node van n8n voegt een rij toe: afzender, profielnaam, tekst, bericht-ID, tijdstempel en de ID van het ontvangende telefoonnummer. Dezelfde opzet werkt in Make of Zapier.

Die tussenstap heeft nog een voordeel. De webhook-trigger van Airtable staat vijf verzoeken per seconde toe, en een workflowtool kan een piek in een wachtrij zetten die anders zou worden geweigerd.

Hoe verstuur je een WhatsApp-template vanuit een Airtable-base?

Met een automatisering waarvan de actie Run a script is. De trigger kan een record zijn dat een view binnenkomt, een veld dat verandert of een klik op een knop. Het script leest het telefoonveld en de andere velden van het record via input.config() en roept het endpoint messages van de Cloud API aan met fetch. Airtable-automatiseringsscripts draaien server-side, dus er is geen browserbeperking in de weg.

Sla het token op als secret in de scripteditor in plaats van in de code. Airtable maskeert secrets in de console-uitvoer en laat alleen mensen met toegang tot alle secrets van een script het bewerken.

Gebruik een template voor alles wat de klant de afgelopen 24 uur niet zelf heeft aangestoten, want vrije tekst wordt alleen binnen dat venster afgeleverd. Het script kan het teruggegeven bericht-ID terugschrijven naar het record, waardoor de verzending aan de rij gekoppeld is.

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());

Hoe moet de berichtentabel eruitzien?

Eén rij per bericht, met het bericht-ID van WhatsApp als primair veld. Meta probeert een aflevering opnieuw als die mislukt lijkt, en een workflow die het ID opzoekt voordat hij toevoegt, schrijft nooit hetzelfde bericht twee keer.

Houd een veld direction bij met de waarden inbound en outbound. Op een Coexistence-nummer komen antwoorden die het team in de WhatsApp Business-app typt binnen op dezelfde webhook als smb_message_echoes-events. Als je die als outbound-rijen logt, krijgt de base het hele gesprek in plaats van één kant ervan.

Koppel elk bericht aan een tabel Contacts met als sleutel het telefoonnummer met alleen cijfers, de vorm die Meta stuurt. Een rollup toont dan het laatste inkomende tijdstip per contact, en dat ene veld heeft een automatisering nodig om te kiezen tussen vrije tekst en een template.

Veelgemaakte fouten

• Een Airtable-webhook-URL instellen als bestemming van het nummer. Die accepteert alleen POST, het verificatie-GET-verzoek van Meta mislukt en er wordt nooit iets afgeleverd.
• Het token in de scripttekst plakken. Sla het op als scriptsecret, zodat het niet in de code en de logs belandt.
• Vrije tekst sturen vanuit een recordautomatisering naar iemand die de afgelopen 24 uur niet heeft geschreven. Alleen een goedgekeurd template wordt afgeleverd.

Veelgestelde vragen

Lees verder