רישום הודעות WhatsApp ב-Airtable ושליחה מתוך Base

למה Airtable לא יכול לקבל וובהוקים של WhatsApp ישירות?

כי Meta בודקת יעד לפני שהיא מעבירה אליו משהו. היא שולחת בקשת GET עם ערך אתגר (challenge) ומצפה לקבל את אותו ערך בגוף התגובה. הטריגר של Airtable לקבלת וובהוק מקבל בקשות POST בלבד ועונה ב-JSON קבוע משלו, ולכן הבדיקה לא יכולה לעבור ו-Meta אף פעם לא מתחילה למסור הודעות.

הפתרון הוא שלב אחד באמצע. צומת Webhook של n8n מטפל באימות ומקבל כל הודעה, וצומת Airtable של n8n מוסיף שורה: שולח, שם הפרופיל, הטקסט, מזהה ההודעה, חותמת זמן ומזהה המספר המקבל. אותו מבנה עובד גם ב-Make או ב-Zapier.

לשלב האמצעי יש יתרון שני. הטריגר של Airtable מאפשר חמש בקשות בשנייה, וכלי תהליכים יכול להחזיק בתור התפרצות שאחרת הייתה נדחית.

איך אפשר לשלוח מתוך Base של Airtable תבנית של WhatsApp לכל לקוח?

באמצעות אוטומציה שהפעולה בה היא Run a script. הטריגר יכול להיות כניסה של רשומה לתצוגה, שינוי בשדה או לחיצה על כפתור. הסקריפט קורא את הטלפון והשדות של הרשומה דרך input.config() וקורא לנקודת הקצה messages של ה-Cloud API עם fetch. סקריפטים של אוטומציות ב-Airtable רצים בצד השרת, ולכן אין הגבלות דפדפן בדרך.

שומרים את אסימון הגישה כסוד בעורך הסקריפט ולא בקוד. Airtable מסתירה סודות בפלט הקונסולה, ורק מי שיש לו גישה לכל הסודות של סקריפט יכול לערוך אותו.

משתמשים בתבנית לכל מה שהלקוח לא יזם ב-24 השעות האחרונות, כי טקסט חופשי נמסר רק בתוך החלון הזה. הסקריפט יכול לכתוב את מזהה ההודעה שהוחזר בחזרה לרשומה, וכך לקשור את השליחה לשורה.

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

איך צריכה להיראות טבלת ההודעות?

שורה אחת לכל הודעה, כשמזהה ההודעה של WhatsApp הוא השדה הראשי. Meta שולחת שוב מסירות שנראות לה ככושלות, ותהליך שבודק את המזהה לפני ההוספה לא כותב אותה הודעה פעמיים.

כדאי להוסיף שדה כיוון עם הערכים inbound ו-outbound. במספר Coexistence, תשובות שהצוות מקליד באפליקציית WhatsApp Business מגיעות לאותו וובהוק כאירועי smb_message_echoes, ורישום שלהן כשורות יוצאות נותן ל-Base את השיחה המלאה ולא צד אחד שלה.

מקשרים כל הודעה לטבלת Contacts עם מפתח של מספר הטלפון בספרות בלבד, וזו הצורה ש-Meta שולחת. שדה Rollup מראה אז את זמן ההודעה הנכנסת האחרונה לכל איש קשר, ושדה בודד זה הוא מה שאוטומציה צריכה כדי להחליט בין טקסט חופשי לתבנית.

טעויות נפוצות

• הגדרת כתובת וובהוק של Airtable כיעד של המספר. היא מקבלת POST בלבד, בקשת ה-GET של Meta לאימות נכשלת, ושום דבר לא נמסר לעולם.
• הדבקת אסימון הגישה בגוף הסקריפט. שומרים אותו כסוד של הסקריפט, כך שהוא נשאר מחוץ לקוד וליומנים.
• שליחת טקסט חופשי מאוטומציית רשומה למי שלא כתב ב-24 השעות האחרונות. רק תבנית מאושרת נמסרת.

שאלות נפוצות

המשיכו לקרוא