انتقل إلى المحتوى الرئيسي

عقدة whatsapp

عقدة whatsapp توفر تكاملًا مع واجهة برمجة تطبيقات WhatsApp Business Cloud (Meta). من خلالها يمكن للتدفق إرسال رسائل نصية عادية ورسائل قوالب معتمدة مع استبدال المتغيرات.

إعدادات عقدة whatsapp​

Edit

في العناوين أدناه — تسميات الحقول في نموذج العقدة، بين قوسين — المفاتيح التي يتم حفظ القيم بها في مخطط JSON.

1. معرف رقم الهاتف (phoneNumberId)​

معرف رقم المرسل في Meta. يمكن العثور عليه في قسم WhatsApp → البدء في مدير أعمال Meta.

يدعم Mustache.

مثال:

{{flow.phoneNumberId}}

2. رمز الوصول (accessToken)​

رمز وصول دائم من مدير أعمال Meta.

يدعم Mustache — يمكن تخزين الرمز في متغير التدفق (flow) واستبداله عبر {{المتغير}}.

مثال:

{{flow.whatsappToken}}

3. إصدار API (apiVersion)​

إصدار Graph API الذي سيتم استخدامه في الطلبات. حقل ثابت، بشكل افتراضي — v20.0.

مثال:

v20.0

4. الإجراء (action)​

نوع الرسالة المرسلة. الخيارات المتاحة:

  • رسالة (بشكل افتراضي) — رسالة نصية عادية. ينشط حقول المستلم و نص الرسالة.
  • قالب — رسالة قالب معتمدة مسبقًا في Meta. ينشط حقول المستلم و اسم القالب و التعريب و المكونات.

5. المستلم (to)​

رقم هاتف المستلم بالتنسيق الدولي: مع رمز الدولة، بدون علامة + وبدون مسافات. الحقل موجود في كلا الخيارين الإجراء.

يدعم Mustache.

مثال:

{{payload.user.phone}}

أو بشكل ثابت: 79001234567

6. نص الرسالة (text)​

نص الرسالة. يستخدم فقط عند الإجراء: رسالة.

يدعم Mustache.

مثال:

تم تأكيد طلبك رقم {{payload.orderId}} بنجاح. يرجى انتظار التسليم.

7. اسم القالب (templateName)​

اسم القالب المعتمد في مدير أعمال Meta. يستخدم فقط عند الإجراء: قالب.

يدعم Mustache.

مثال:

order_confirmation

8. التعريب (locale)​

لغة القالب. يجب أن تتطابق تمامًا مع لغة القالب في إعدادات Meta. يستخدم فقط عند الإجراء: قالب.

أمثلة:

  • en_US — الإنجليزية (الولايات المتحدة)
  • fr_FR — الفرنسية

9. المكونات (components)​

معلمات القالب — قيم المتغيرات التي سيتم استبدالها في القالب عند الإرسال. يستخدم فقط عند الإجراء: قالب.

تتم إضافة المكونات بواسطة زر + Component وتُرقم (Component 1، Component 2، …). يحتوي كل مكون على ثلاثة حقول:

  • type — قسم القالب: header (عنوان) أو body (النص الرئيسي).
  • parameter_name — اسم المتغير، كما هو محدد في القالب في لوحة تحكم WhatsApp Business.
  • text — القيمة التي سيتم استبدالها بدلاً من المتغير. يدعم Mustache.

مثال:

type: body  |  parameter_name: order_id   |  text: {{payload.orderId}}
type: body  |  parameter_name: amount     |  text: {{payload.totalPrice}}

أمثلة الاستخدام​

مثال 1: إشعار نصي عن الطلب​

التدفق:

[events: order_created] ---> [whatsapp]

إعدادات العقدة:

  • معرف رقم الهاتف: {{flow.phoneNumberId}}
  • رمز الوصول: {{flow.whatsappToken}}
  • إصدار API: v20.0
  • الإجراء: رسالة
  • المستلم: {{payload.order.phone}}
  • نص الرسالة: تم قبول طلبك رقم {{payload.order.id}}. المبلغ: {{payload.order.totalPrice}} روبل.

النتيجة:
عند إنشاء الطلب، سيتلقى المستخدم رسالة WhatsApp تحتوي على تفاصيل الطلب.

مثال 2: رسالة قالب مع المتغيرات​

التدفق:

[events: order_status_changed] ---> [whatsapp]

إعدادات العقدة:

  • الإجراء: قالب
  • المستلم: {{payload.order.phone}}
  • اسم القالب: order_status_update
  • التعريب: en_US
  • المكونات: 
    type: body  |  parameter_name: order_id    |  text: {{payload.order.id}}
    type: body  |  parameter_name: status      |  text: {{payload.order.status}}

النتيجة:
سيتلقى المستخدم رسالة قالب معتمدة تحتوي على القيم المستبدلة لرقم الطلب والحالة.

معلومات

يجب إنشاء رسائل القوالب مسبقًا والحصول على الموافقة في مدير أعمال Meta. يجب أن تتطابق قيم الحقول اسم القالب و التعريب تمامًا مع معلمات القالب المعتمد.