Lorixen.
AR

من Google Sheets إلى رسالة واتساب للزبون: تأكيد الطلب عبر Cloud API

باختصار: يمكنك ربط جدول الطلبات في Google Sheets بواتساب Cloud API، فتُرسل رسالة معتمدة للزبون عند تغيّر حالة طلبه إلى "تم الشحن" مثلاً. الربط يتم عبر سكربت في Apps Script يراقب عموداً محدداً ويرسل طلب الإرسال إلى واجهة واتساب. أضف عمود موافقة للزبون قبل أي رسالة، وعمود سجل يحفظ نتيجة كل محاولة، واحفظ رمز الوصول في مكان مخصص للإعدادات، لا في خلية مرئية داخل الجدول. جرّب الربط على رقمك الشخصي أولاً، ولا تفتح الإرسال للزبائن قبل أن تنجح عشر محاولات متتالية. تذكر أن الرسالة التسويقية تحتاج قالباً معتمداً من المنصة، وأن الرسالة الخدمية تعتمد على نافذة زمنية تبدأ بآخر رسالة من الزبون.

قبل أن تبدأ

تحتاج أربعة أشياء قبل كتابة أي سطر:

  1. حساب Meta Business مرتبط برقم هاتف مسجل في واتساب Cloud API، ومعرّف الرقم الذي تعطيه المنصة.
  2. قالب رسالة معتمد من المنصة، لأن الرسالة التي تبدؤها أنت خارج نافذة الخدمة لا تُرسل بدونه.
  3. جدول فيه عمود للحالة وعمود لموافقة الزبون.
  4. رمز وصول لواجهة واتساب، يُحفظ لاحقاً في خصائص السكربت.

الرموز والمعرّفات تُنسخ من لوحة المطورين مباشرة، ولا تُرسل في الدردشة ولا تُكتب في ملاحظات الجدول.

تصميم الجدول

اجعل الجدول بسيطاً ومرتباً. الأعمدة المقترحة:

العمود المحتوى الغرض
A رقم الطلب مرجع لا يتكرر
B اسم الزبون يُستخدم في القالب
C رقم الجوال بصيغة دولية مثل 9627XXXXXXXX
D الحالة يتغير إلى "تم الشحن"
E موافقة الزبون "نعم" أو "لا"
F وقت آخر إرسال يمنع التكرار
G نتيجة الإرسال نجاح أو سبب الفشل

الرقم في العمود C يجب أن يكون نصاً لا رقماً، لأن الصفر في البداية أو علامة الزائد قد تضيع. وإذا كان الزبون يكتب رقمه بصفر في البداية، فحوّله إلى الصيغة الدولية قبل الإرسال، كما تفعل مع أي نموذج.

قالب الرسالة والمتغيرات

القالب هو نص معتمد من المنصة، وفيه أماكن للمتغيرات بالأرقام. مثال:

"مرحباً {{1}}، تم شحن طلبك رقم {{2}}، ويصلك خلال يومي عمل. شكراً لثقتك بنا."

المتغير الأول هو الاسم، والثاني رقم الطلب. لا تضف متغيرات كثيرة دون حاجة، لأن كل متغير يحتاج توافقاً مع القالب المعتمد. واكتب في القالب نفسه ما يحتاجه الزبون فعلاً، دون عبارات تسويقية، لأن الرسالة الخدمية التي تحتوي عرضاً قد تُعاد تصنيفها.

النافذة الزمنية

الرسالة الخدمية داخل نافذة زمنية تبدأ عندما يرسل الزبون رسالة لك، وتستمر لمدة محددة. داخل هذه النافذة يمكنك الرد بنص حر. خارجها لا يمكنك إرسال إلا قالباً معتمداً. لذلك لا تفترض أن الزبون سيرى رسالة النص الحر إذا كان آخر تواصل منه قبل أيام، بل استخدم القالب دائماً عند بدء المحادثة من جانبك.

السكربت

أنشئ مشروعاً من داخل الجدول عبر قائمة الإضافات، ثم الصق الكود التالي. عدّل اسم الشيت وأرقام الأعمدة إن اختلفت عندك:

const API_VERSION = 'v21.0'; // راجع أحدث إصدار في وثائق Meta
const SHEET_NAME = 'Orders';

function handleStatusEdit(e) {
  const range = e.range;
  if (range.getSheet().getName() !== SHEET_NAME) return;
  if (range.getColumn() !== 4 || e.value !== 'تم الشحن') return;

  const sheet = range.getSheet();
  const row = range.getRow();
  const [orderId, name, phone, , consent, lastSent] =
    sheet.getRange(row, 1, 1, 6).getValues()[0];
  if (consent !== 'نعم' || lastSent) return;

  const props = PropertiesService.getScriptProperties();
  const payload = {
    messaging_product: 'whatsapp',
    to: String(phone),
    type: 'template',
    template: {
      name: 'order_shipped',
      language: { code: 'ar' },
      components: [{
        type: 'body',
        parameters: [
          { type: 'text', text: String(name) },
          { type: 'text', text: String(orderId) }
        ]
      }]
    }
  };

  const url = `https://graph.facebook.com/${API_VERSION}/${props.getProperty('WA_PHONE_ID')}/messages`;
  const res = UrlFetchApp.fetch(url, {
    method: 'post',
    contentType: 'application/json',
    headers: { Authorization: 'Bearer ' + props.getProperty('WA_TOKEN') },
    payload: JSON.stringify(payload),
    muteHttpExceptions: true
  });

  const ok = res.getResponseCode() === 200;
  sheet.getRange(row, 6).setValue(new Date());
  sheet.getRange(row, 7).setValue(ok ? 'تم الإرسال' : 'فشل: ' + res.getContentText().slice(0, 200));
}

رمز الوصول ومعرّف الرقم يُضافان من قائمة إعدادات المشروع، في خصائص السكربت، بالاسمين WA_TOKEN وWA_PHONE_ID. بهذه الطريقة لا يظهر الرمز في الكود ولا في الجدول، ومن يملك الجدول لا يرى الرمز إلا إذا فتح الإعدادات بنفسه.

تشغيل المشغّل بشكل صحيح

لا تستخدم الاسم البسيط onEdit لهذه الوظيفة، لأن المشغّل البسيط لا يستطيع استخدام خدمات تحتاج صلاحيات مثل UrlFetchApp. أنشئ مشغّلاً قابلاً للتثبيت من قائمة المشغّلات، من نوع "عند التعديل" ويستدعي الدالة handleStatusEdit. عند أول تشغيل ستطلب Google صلاحيات الاتصال الخارجي وقراءة الجدول وتعديله، ووافق عليها بعد أن تتأكد من أن الحساب هو حسابك.

اختبار بالرقم الشخصي

غيّر حالة صف تجريبي إلى "تم الشحن" ورقمه رقمك أنت. إذا وصلتك الرسالة، فكرر التجربة على عشرة صفوف تجريبية بأرقام مختلفة من فريقك. إذا فشلت محاولة، فاقرأ عمود النتيجة، لأنه يعرض السبب المكتوب من واجهة واتساب. الأسباب الشائعة هي اسم القالب مكتوب بشكل مختلف، أو لغة القالب لا تطابق المعتمد، أو رقم الهاتف دون مفتاح الدولة.

حدود يجب أن تعرفها

  • الحصص: للسكربتات حدود يومية على طلبات الخدمات الخارجية، لذلك لا تبنِ عليها إرسال آلاف الرسائل في دفعة واحدة.
  • التزامن: إذا غيّر أكثر من شخص الحالة معاً، فقد تتداخل الإرسالات. استخدم قفلاً بسيطاً أو اجعل الإرسال على دفعات مجدولة بدل الحدث الفوري عند الحجم الكبير.
  • الاعتماد على الجدول: إذا زاد عدد الطلبات، أو احتجت تتبعاً دقيقاً للحالات، فالأنسب حينها نظام طلبات مخصص أو قاعدة بيانات، فالجدول يبقى مرناً لكنه لا يصلح لكل شيء.

قائمة تحقق

  • ☐ الرقم والقالب معتمدان من المنصة، واسم القالب ولغته مطابقان للكود.
  • ☐ الرمز ومعرّف الرقم محفوظان في خصائص السكربت وليسا في الجدول.
  • ☐ عمود الموافقة يُفحص قبل كل إرسال.
  • ☐ عمود النتيجة يسجل النجاح أو سبب الفشل.
  • ☐ جُرب الربط على عشر حالات تجريبية قبل الإرسال للزبائن.

أسئلة شائعة

هل أحتاج موافقة الزبون صراحة؟

نعم، احتفظ بسجل يثبت أن الزبون وافق على تلقي رسائل الطلب، واجعل العمود موجوداً في الجدول حتى لا يُرسل السكربت إلى من لم يوافق.

لماذا لا تصل الرسالة رغم أن النتيجة نجاح؟

النجاح يعني أن المنصة قبلت الطلب، لكن وصول الرسالة إلى الهاتف يعتمد على الشبكة وحالة الحساب لدى الزبون. تابع حالات التسليم في لوحة المنصة إن توفرت.

هل يمكنني إرسال رسالة لكل تغيير في الحالة؟

الأفضل أن ترسل عند الحالات المهمة فقط، مثل الشحن والتأخير. كثرة الرسائل تضايق الزبون، وتزيد الكلفة، وقد تؤدي إلى حجب الرقم.

هل أحتاج مبرمجاً لتشغيل هذا؟

الكود قصير، لكن إعداد حساب المنصة والقالب يحتاج شخصاً يفهم الإعدادات. إن لم يكن لديك هذا الشخص، فالأسلم أن تستعين به لمرة واحدة ثم تدير الجدول بنفسك.

إذا أردت أن نبني هذا الربط لجدولك ونجرب القالب على رقم تجريبي قبل أي زبون حقيقي، فاكتب لنا من صفحة التواصل.

المصادر

WhatsAppاحجز مكالمة