Salvați mesajele WhatsApp în Airtable și trimiteți dintr-un base

De ce nu poate Airtable să primească direct webhook-urile WhatsApp?

Pentru că Meta verifică destinația înainte să livreze orice. Trimite o cerere GET cu o valoare de tip challenge și așteaptă aceeași valoare înapoi, în corpul răspunsului. Trigger-ul „When webhook received” din Airtable acceptă doar cereri POST și răspunde cu propriul JSON fix, așa că verificarea nu poate trece, iar Meta nu începe niciodată livrarea.

Soluția este un pas intermediar. Un nod Webhook din n8n se ocupă de verificare și primește fiecare mesaj, iar nodul Airtable din n8n adaugă un rând: expeditorul, numele de profil, textul, ID-ul mesajului, momentul trimiterii și ID-ul numărului de telefon care a primit mesajul. Aceeași structură funcționează în Make sau Zapier.

Pasul intermediar are și un al doilea avantaj. Trigger-ul de webhook din Airtable permite cinci cereri pe secundă, iar un instrument de workflow poate pune în coadă un val de mesaje care altfel ar fi refuzat.

Cum trimiteți un template WhatsApp dintr-un base Airtable?

Printr-o automatizare a cărei acțiune este Run a script. Trigger-ul poate fi un rând care intră într-un view, un câmp care se schimbă sau un buton apăsat. Scriptul citește telefonul și câmpurile rândului cu input.config() și apelează endpoint-ul de mesaje din Cloud API cu fetch. Scripturile de automatizare din Airtable rulează pe server, deci nu apare nicio restricție de browser.

Salvați token-ul de acces ca secret în editorul de scripturi, nu în cod. Airtable ascunde secretele din ieșirea consolei și permite editarea scriptului doar persoanelor care au acces la toate secretele lui.

Folosiți un template pentru tot ce nu a fost provocat de client în ultimele 24 de ore, deoarece textul liber se livrează doar în interiorul acelei ferestre. Scriptul poate scrie înapoi în rând ID-ul mesajului returnat, ceea ce leagă trimiterea de rândul respectiv.

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

Cum ar trebui să arate tabelul de mesaje?

Un rând pentru fiecare mesaj, cu ID-ul mesajului WhatsApp drept câmp principal. Meta retrimite livrările pe care le crede eșuate, iar un workflow care caută ID-ul înainte de a adăuga rândul nu scrie niciodată același mesaj de două ori.

Păstrați un câmp de direcție, cu valorile inbound și outbound. Pe un număr Coexistence, răspunsurile scrise de echipă în aplicația WhatsApp Business ajung la același webhook ca evenimente smb_message_echoes, iar înregistrarea lor ca rânduri outbound oferă base-ului conversația completă, nu doar o jumătate a ei.

Legați fiecare mesaj de un tabel Contacts, cu cheia pe numărul de telefon format doar din cifre, adică forma trimisă de Meta. Un câmp rollup arată apoi ultimul moment inbound pentru fiecare contact, iar acest singur câmp este tot ce are nevoie o automatizare ca să aleagă între text liber și template.

Greșeli frecvente

• Setarea URL-ului unui webhook Airtable ca destinație a numărului. Acesta acceptă doar POST, verificarea GET de la Meta eșuează și nu se livrează nimic.
• Lipirea token-ului de acces în corpul scriptului. Salvați-l ca secret al scriptului, ca să rămână în afara codului și a jurnalelor.
• Trimiterea de text liber dintr-o automatizare pe rânduri către cineva care nu a scris în ultimele 24 de ore. Se livrează doar un template aprobat.

Întrebări frecvente

Continuați să citiți