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

عقدة whatsapp

تتيح عقدة whatsapp التكامل مع WhatsApp Business Cloud API من Meta. يستطيع التدفق من خلالها إرسال رسائل نصية عادية إلى المستخدمين، ورسائل قوالب معتمدة تُدرج فيها قيم المتغيرات.

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

نافذة «Node Information» لعقدة whatsapp مع الحقول «wa_phone_number_id» و«wa_access_token» و«wa_api_version» و«wa_action» و«wa_to» و«wa_text»

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

1. Phone Number ID (phoneNumberId)​

معرّف رقم المرسل في Meta. تجده في قسم WhatsApp → Getting Started في Meta Business Manager.

يدعم Mustache.

مثال:

{{flow.phoneNumberId}}

2. Access Token (accessToken)​

رمز وصول دائم من Meta Business Manager.

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

مثال:

{{flow.whatsappToken}}

3. API Version (apiVersion)​

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

مثال:

v20.0

4. Action (action)​

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

  • Message (الافتراضي): رسالة نصية عادية. يفعّل الحقلين Recipient وMessage text.
  • Template: رسالة قالب معتمدة مسبقًا في Meta. يفعّل الحقول Recipient وTemplate name وLocalization وComponents.

5. Recipient (to)​

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

يدعم Mustache.

مثال:

{{payload.user.phone}}

أو قيمة ثابتة: 79001234567

6. Message text (text)​

نص الرسالة. يُستخدم فقط عندما تكون قيمة Action هي Message.

يدعم Mustache.

مثال:

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

7. Template name (templateName)​

اسم القالب المعتمد في Meta Business Manager. يُستخدم فقط عندما تكون قيمة Action هي Template.

يدعم Mustache.

مثال:

order_confirmation

8. Localization (locale)​

لغة القالب، ويجب أن تطابق تمامًا لغة القالب في إعدادات Meta. يُستخدم فقط عندما تكون قيمة Action هي Template.

أمثلة:

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

9. Components (components)​

معاملات القالب، أي قيم المتغيرات التي تُدرج في القالب عند الإرسال. يُستخدم فقط عندما تكون قيمة Action هي Template.

أضف المكونات بالزر + 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]

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

  • Phone Number ID: {{flow.phoneNumberId}}
  • Access Token: {{flow.whatsappToken}}
  • API Version: v20.0
  • Action: Message
  • Recipient: {{payload.order.phone}}
  • Message text: تم استلام طلبك رقم {{payload.order.id}}. المبلغ: {{payload.order.totalPrice}} روبل.

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

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

التدفق:

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

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

  • Action: Template
  • Recipient: {{payload.order.phone}}
  • Template name: order_status_update
  • Localization: en_US
  • Components: 
    type: body  |  parameter_name: order_id    |  text: {{payload.order.id}}
    type: body  |  parameter_name: status      |  text: {{payload.order.status}}

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

معلومات

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

آخر تحديث في