إرسال رسائل الطلبات عبر WhatsApp من Shopify

كيف يرسل Shopify Flow رسالة WhatsApp؟

عبر إجراء Send HTTP request، الذي يرسل طلب POST إلى أي عنوان URL مع ترويسات ومتن يمكن أن يستخدم متغيرات Liquid من المشغّل.

أنشئ سير عمل على مشغّل إنشاء الطلب وأضف Send HTTP request. عنوان URL هو نقطة النهاية (endpoint) الخاصة برسائل Cloud API للرقم المتصل بحسب معرّف رقم الهاتف. أضف ترويسة Authorization قيمتها Bearer متبوعة بـ token الخاص بالرقم، مخزّنًا كسر في Flow ومشارًا إليه كمتغير سري. لا تظهر القيم السرية في واجهة Flow أبدًا، وتُحجب من سجلات التشغيل، وهذا هو المكان الصحيح لـ token. المتن رسالة قالب، ورقم هاتف العميل في الحقل to وتفاصيل الطلب معاملات للقالب.

يعدّ Flow الاستجابة 2XX أو 3XX نجاحًا. وترد Meta على الطلب الصحيح بمعرّف الرسالة، فنجاح التشغيل يعني أن Meta قبلت الرسالة.

{
  "messaging_product": "whatsapp",
  "to": "<customer phone, digits only>",
  "type": "template",
  "template": {
    "name": "order_confirmation",
    "language": { "code": "en" },
    "components": [{
      "type": "body",
      "parameters": [{ "type": "text", "text": "{{order.name}}" }]
    }]
  }
}

لماذا يجب أن تكون رسالة الطلب قالبًا؟

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

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

وهناك أيضًا الموافقة. تشترط Meta الحصول على opt-in قبل أن يراسل نشاط تجاري أي شخص على WhatsApp: أن يكون الشخص قد أعطى رقمه ووافق على تلقي رسائل من هذا النشاط. وأبسط طريقة لجمعها خانة اختيار في صفحة الدفع تنص على ذلك، وعلى سير العمل التحقق منها قبل الإرسال.

ماذا لو لم تتضمن خطة المتجر إجراء Send HTTP request؟

استخدم webhook من إدارة Shopify بدلًا منه. ضمن الإعدادات ثم الإشعارات ثم Webhooks، يمكن للتاجر إنشاء webhook لحدث مثل إنشاء الطلب، بصيغة JSON، إلى عنوان URL. وجّهه إلى مستقبِل: عقدة Webhook في n8n، أو مسار في PHP أو Python أو Node. يقرأ المستقبِل الطلب ويتحقق من الموافقة وينفذ استدعاء القالب نفسه إلى Cloud API.

أيًّا كان المسار الذي يرسل، فالردود واحدة. عندما يجيب العميل عن رسالة الطلب، يصل الرد إلى تطبيق WhatsApp Business على هاتف المتجر، لأن الرقم مفعّل عليه Coexistence، وتصبح نافذة 24 ساعة مفتوحة للنص الحر. وإذا كانت وجهة webhook الخاصة بالرقم مضبوطة، يصل الرد إلى نظامك أيضًا. وتظهر رسالة الطلب نفسها في التطبيق كذلك، فيرى من يجيب ما الذي يرد عليه العميل.

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

• إرسال نص حر عند إنشاء الطلب. لم يكتب العميل بعد، فترفضه Meta؛ ويجب أن يكون قالبًا معتمدًا.
• ترك معالجة الأخطاء على Retry للاستجابات 4XX. قد يعيد Flow لمدة تصل إلى 24 ساعة محاولة طلب لن تقبله Meta أبدًا.
• وضع token في الترويسة كنص عادي. خزّنه كسر في Flow ليبقى خارج الواجهة والسجلات.

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

تابع القراءة