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

عقدة whatsapp

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

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

Edit

1. wa_phone_number_id​

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

يدعم Mustache.

مثال:

{{flow.phoneNumberId}}

2. wa_access_token​

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

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

مثال:

{{flow.whatsappToken}}

3. wa_api_version​

إصدار Graph API الذي سيتم استخدامه في الطلبات. حقل ثابت.

مثال:

v19.0

4. wa_action​

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

  • text — رسالة نصية عادية. ينشط حقل text.
  • template — رسالة قالب معتمدة مسبقًا في Meta. ينشط الحقول templateName و locale و components.

5. wa_to​

رقم هاتف المستلم بالتنسيق الدولي: مع رمز الدولة، بدون علامة + وبدون مسافات.

يدعم Mustache.

مثال:

{{payload.user.phone}}

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

6. wa_text​

نص الرسالة. يستخدم فقط عند action: text.

يدعم Mustache.

مثال:

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

7. wa_template_name​

اسم القالب المعتمد في مدير أعمال Meta. يستخدم فقط عند action: template.

يدعم Mustache.

مثال:

order_confirmation

8. wa_locale​

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

أمثلة:

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

9. wa_components​

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

يحتوي كل عنصر على ثلاثة حقول:

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

مثال:

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

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

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

التدفق:

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

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

  • accessToken: {{flow.whatsappToken}}
  • phoneNumberId: {{flow.phoneNumberId}}
  • apiVersion: v19.0
  • action: text
  • to: {{payload.order.phone}}
  • text: تم قبول طلبك رقم {{payload.order.id}}. المبلغ: {{payload.order.totalPrice}} روبل.

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

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

التدفق:

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

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

  • action: template
  • to: {{payload.order.phone}}
  • templateName: order_status_update
  • locale: en_US
  • components: 
    type: body  |  name: order_id    |  text: {{payload.order.id}}
    type: body  |  name: status      |  text: {{payload.order.status}}

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

معلومات

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