سجّل رسائل WhatsApp في Airtable وأرسل من القاعدة

لماذا لا يستطيع Airtable استقبال webhook من WhatsApp مباشرة؟

لأن Meta تفحص الوجهة قبل أن تسلّم أي شيء. ترسل طلب GET يحمل قيمة تحدٍّ (challenge) وتتوقع أن تعود القيمة نفسها في نص الاستجابة. مشغّل When webhook received في Airtable يقبل طلبات POST فقط ويرد بـ JSON ثابت خاص به، فلا يمكن أن ينجح الفحص ولا تبدأ Meta التسليم أبدًا.

الحل خطوة وسيطة واحدة. تتولى عقدة Webhook في n8n التحقق واستقبال كل رسالة، وتضيف عقدة Airtable في n8n صفًا فيه: المرسل، واسم الملف الشخصي، والنص، ومعرّف الرسالة، والطابع الزمني، وphone number id للرقم المستقبِل. والشكل نفسه يعمل في Make أو Zapier.

وللخطوة الوسيطة فائدة ثانية. يسمح مشغّل webhook في Airtable بخمسة طلبات في الثانية، بينما تستطيع أداة سير العمل وضع دفعة مفاجئة في طابور بدل رفضها.

كيف ترسل قالب WhatsApp من قاعدة Airtable؟

عبر أتمتة إجراؤها Run a script. يمكن أن يكون المشغّل دخول سجل إلى عرض، أو تغيّر حقل، أو النقر على زر. يقرأ السكربت هاتف السجل وحقوله عبر input.config() ثم يستدعي نقطة النهاية (endpoint) الخاصة بالرسائل في Cloud API باستخدام fetch. تعمل سكربتات الأتمتة في Airtable على الخادم، فلا توجد قيود متصفح في الطريق.

خزّن token كسرًا في محرر السكربت بدل وضعه في الشيفرة. يخفي 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 إلى webhook نفسه على شكل أحداث smb_message_echoes، وتسجيلها كصفوف outbound يمنح القاعدة المحادثة كاملة لا نصفها.

اربط كل رسالة بجدول Contacts مفتاحه رقم الهاتف أرقامًا فقط، وهي الصيغة التي ترسلها Meta. يعرض حقل rollup بعدها وقت آخر رسالة واردة لكل جهة اتصال، وهذا الحقل وحده ما تحتاجه الأتمتة لتختار بين النص الحر والقالب.

الأخطاء الشائعة

• تعيين عنوان URL لـ webhook من Airtable وجهةً للرقم. فهو يقبل POST فقط، ويفشل طلب GET للتحقق من Meta، ولا يُسلَّم شيء أبدًا.
• لصق token الوصول داخل متن السكربت. خزّنه كسر ليبقى خارج الشيفرة والسجلات.
• إرسال نص حر من أتمتة سجل إلى شخص لم يراسلك منذ 24 ساعة. لا يُسلَّم إلا قالب معتمد.

الأسئلة الشائعة

تابع القراءة