مرجع مسارات العمل
تسرد هذه الصفحة كل ما يمكنك استخدامه في سير العمل وتشرح بدقة كيف يتصرف. لتتعلم بناء سير عمل خطوة بخطوة، ابدأ بصفحة مسارات العمل والأتمتة.
كيف يعمل سير العمل
Section titled “كيف يعمل سير العمل”سير العمل مجموعة من الخطوات. كل خطوة قاعدة واحدة: مُشغِّل ← شروط ← إجراءات.
- يحدث شيء ما: يرسل عميل رسالة، أو يُستدعى Webhook، أو يحين موعد متابعة، وهكذا.
- يبحث Wabot عن الخطوات التي يطابق مُشغِّلها. في الرسائل، يجب أن تتطابق القناة ونوع الرسالة أيضًا. لا يُتحقق إلا من الخطوات المفعّلة داخل مسارات عمل مفعّلة.
- تتحقق كل خطوة مطابقة من شروطها. إذا لم تكن هناك شروط، تعمل الخطوة دائمًا.
- كل خطوة تتحقق شروطها تنفّذ إجراءاتها، من الأعلى إلى الأسفل. القاعدة ليست “أول تطابق يفوز”: إذا طابقت خطوتان الرسالة نفسها، تعمل كلتاهما، دون ترتيب مضمون. تنبّهك لوحة الإعداد عندما تبدأ خطوتان بالرسالة نفسها.
- إذا لم تعمل أي خطوة لرسالة العميل، يجيب عنها بوت الذكاء الاصطناعي (عندما يكون الذكاء الاصطناعي مفعّلًا للقناة ولجهة الاتصال). إذا عملت أي خطوة، حتى لو كانت تضيف وسمًا فقط، فلن يجيب بوت الذكاء الاصطناعي عن تلك الرسالة.
الإجراءات
Section titled “الإجراءات”- تُنفَّذ الإجراءات بالترتيب المعروض. إذا فشل أحدها، تُنفَّذ الإجراءات التالية رغم ذلك.
- الانتظار قبل الإرسال يُحسب بالثواني ابتداءً من لحظة وقوع المُشغِّل، لا من الإجراء السابق. لإرسال ثلاث رسائل بفارق يوم بين كل منها، استخدم 0 و86400 و172800.
- تُحفظ الرسائل المنتظرة بأمان وتُرسل حتى إذا أُعيد تشغيل الخادم. لا تُلغى إذا رد العميل أو إذا أوقفت الخطوة، لذا اجعل التسلسلات الطويلة قصيرة.
- إرسال قالب وإرسال رسالة فقط يمكنهما الانتظار. كل إجراء آخر يُنفَّذ فورًا.
- الرسائل الحرة (إرسال رسالة) لا تصل إلا خلال 24 ساعة من آخر رسالة للعميل. خارج هذه النافذة، استخدم إرسال قالب.
الخطوات التالية
Section titled “الخطوات التالية”الخطوة المرتبطة بخط الخطوة التالية (شرط سير العمل السابق في محرر النموذج) لا تعمل إلا إذا كانت الخطوة السابقة قد عملت بنجاح لجهة الاتصال نفسها.
- لا تزال تحتاج إلى مُشغِّلها الخاص، مثل رسالة العميل التالية أو نقره على زر. لا تبدأ من تلقاء نفسها بعد الخطوة السابقة.
- لا يوجد حد زمني: قد تكون الخطوة السابقة عملت قبل ساعة أو قبل شهر.
- بعد فتحها، تعمل الخطوة في كل مرة يتطابق فيها مُشغِّلها وشروطها.
- إذا أدّت إليها عدة خطوات، فيجب أن تكون كلها قد عملت.
- إذا طابقت الخطوة السابقة واللاحقة الرسالة نفسها، فقد تعمل كلتاهما عليها. أعطِ الخطوة اللاحقة مُشغِّلًا مختلفًا، مثل النقر على زر.
عمليات التشغيل والنتائج
Section titled “عمليات التشغيل والنتائج”تعرض عمليات التشغيل لكل خطوة الأشخاص الذين عملت لهم ونتيجة كل إجراء. تُعد الرسالة ناجحة بمجرد تسليمها إلى WhatsApp. إذا رفضها WhatsApp لاحقًا (مثلًا خارج نافذة الـ 24 ساعة)، يظهر الفشل في المحادثة، لا في عمليات التشغيل.
الخطوات التي تبدأ من الساعة (لا رد لفترة، حان موعد المتابعة)، أو من تغيّرت مرحلة مسار المبيعات أو من تكامل، ترسل من رقم WhatsApp الافتراضي لديك. يستخدم لا رد لفترة الرقم الذي كانت عليه المحادثة، إذا كان لا يزال متصلًا.
المُشغِّلات
Section titled “المُشغِّلات”| المُشغِّل | يعمل عندما… | الإعدادات | يوفّر هذه المتغيرات |
|---|---|---|---|
| يرسل العميل رسالة | يرسل لك عميل رسالة على WhatsApp أو Instagram أو Messenger | القناة، نوع الرسالة، نص اختياري للمطابقة | senderName وsenderID والمزيد حسب نوع الرسالة (راجع المتغيرات) |
| تم تسليم الرسالة أو قراءتها | تُرسل أي رسالة أرسلتها (من سير عمل أو حملة أو صندوق الوارد أو بوت الذكاء الاصطناعي) أو تُسلَّم أو تُقرأ | لا شيء: استخدم الشرطين الحالة والقالب | لا شيء |
| يبدأ يدويًا | تبدؤه لجهات اتصال أو مجموعات تختارها، من جهات الاتصال أو نموذج عملاء محتملين من Meta أو بدء سير عمل آخر | لا شيء | لا شيء (راجع يبدأ يدويًا) |
| تغيّرت مرحلة مسار المبيعات | تُضاف بطاقة إلى مسار مبيعات أو تنتقل إلى مرحلة أخرى | مسار المبيعات، نوع المرحلة، من المرحلة، إلى المرحلة | deal_title وstage_name والمزيد |
| لا رد لفترة | تهدأ المحادثة للمدة التي تحددها | رد من يجب انتظاره، والمدة | waiting_hours، waiting_since |
| حان موعد المتابعة | يحين موعد مهمة متابعة، أو تبقى مفتوحة بعد موعدها بفترة | متى، ومقدار التأخير | followup_text، followup_due_at، followup_assignee، followup_overdue_hours |
| استدعاء Webhook | يرسل نظام آخر طلب POST بنص JSON إلى رابط الخطوة |
الرابط (يظهر بعد أول حفظ) | حقول نص JSON، المعيّنة ضمن المتغيرات |
| رد إجراء Webhook | يتلقى إجراء الإرسال إلى Webhook أو تشغيل كود في خطوة أخرى ردًا | إضافة استجابة نموذجية لتحويل حقول الرد إلى متغيرات | response وكل حقل من حقول الرد |
| أحداث التكاملات (مثل إنشاء طلب في Shopify، أو سلة متروكة) | يُبلغ تكامل مرتبط عن الحدث | لا شيء | حقول الحدث |
يرسل العميل رسالة
Section titled “يرسل العميل رسالة”أكمل الجملة عندما يرسل عميل عبر القناة رسالة من نوع نوع الرسالة و المطابقة النص.
القنوات: WhatsApp وInstagram وMessenger. في Instagram، اختر أيضًا طريقة الربط: تسجيل الدخول إلى Instagram أو صفحة Facebook (الخيار نفسه الذي استخدمته عند ربطه).
أنواع الرسائل
| القناة | أنواع الرسائل |
|---|---|
| نص، رسالة من إعلان Click-to-WhatsApp، أزرار رد سريع تفاعلية، رسالة قائمة تفاعلية، صورة، فيديو، مستند، صوت، Flow، طلب، الدفع | |
| نص، رد سريع، Postback، تعليق، صورة، فيديو، مستند، صوت | |
| Messenger | نص، رد سريع، Postback، تعليق، الموافقة (Opt-in)، قسيمة، صورة، فيديو، مستند، صوت |
| نوع رسالة WhatsApp | يعمل عندما يقوم العميل بـ… | ملاحظات |
|---|---|---|
| نص | كتابة رسالة | |
| رسالة من إعلان Click-to-WhatsApp | إرسال أول رسالة من إعلان Click-to-WhatsApp الخاص بك | يضيف متغيرات الإعلان. إذا لم تطابق أي خطوة إعلان، تجيب عنها خطوات نص |
| أزرار رد سريع تفاعلية | النقر على زر رد، في رسالة من سير عمل أو في قالب | طابِق عنوان الزر. يحتوي button_reply_identifier على ما نُقر عليه |
| رسالة قائمة تفاعلية | اختيار صف من قائمة | طابِق عنوان الصف |
| صورة، فيديو، مستند، صوت | إرسال ملف من هذا النوع | التعليق هو نص الرسالة. في الصوت، النص هو التفريغ النصي إذا كانت باقتك تتضمنه |
| Flow | إرسال نموذج WhatsApp Flow | اختر النموذج ضمن اختر نموذج Flow. يصبح كل حقل في النموذج متغيرًا |
| طلب | تقديم طلب من الكتالوج الخاص بك | استخدم الشرط المبلغ الإجمالي للتحقق من قيمة الطلب |
| الدفع | الدفع (أو فشل الدفع) لطلب من الكتالوج | قيمة status هي success أو failed أو pending. المدفوعات لطلبات الدفع المخصصة لا تبدأ هذا المُشغِّل |
الملصقات والمواقع المشتركة وجهات الاتصال المشتركة والتفاعلات لا تبدأ مسارات العمل.
النص المراد مطابقته: يحتوي على أو يساوي تمامًا أو يبدأ بـ أو لا يساوي. اتركه فارغًا ليعمل مع كل رسالة من هذا النوع. المطابقة حساسة لحالة الأحرف (Price لا تطابق price)، والمسافات تُحتسب. لردود الأزرار والقوائم، النص هو عنوان الزر أو الصف.
تم تسليم الرسالة أو قراءتها
Section titled “تم تسليم الرسالة أو قراءتها”يعمل مع كل تحديث حالة لكل رسالة ترسلها، بما في ذلك الحملات ورسائل الخطوة نفسها. أضف دائمًا شرطين:
- الحالة: تم الإرسال أو تم التسليم أو تمت القراءة.
- القالب: القالب الذي تتابعه.
بدونهما تعمل الخطوة مع كل رسالة في الحساب، وقد تعيد الخطوة التي ترسل رسالة تشغيل نفسها مرة أخرى.
تغيّرت مرحلة مسار المبيعات
Section titled “تغيّرت مرحلة مسار المبيعات”| الإعداد | الخيارات |
|---|---|
| مسار المبيعات | مسار المبيعات المراد مراقبته (مطلوب) |
| فقط عندما تكون المرحلة الجديدة | مفتوحة، رابحة، خاسرة (عدم تحديد أي منها = أي نوع) |
| من المرحلة | أي مرحلة (تشمل البطاقات الجديدة) أو مرحلة واحدة |
| إلى المرحلة | أي مرحلة أو مرحلة واحدة |
تغيير المرحلة الذي يجريه سير عمل يبدأ مسارات عمل مسار المبيعات الأخرى بعمق مستوى واحد فقط، حتى لا يستمر سيرا عمل في نقل بطاقة ذهابًا وإيابًا. يحتاج إلى تفعيل مسارات المبيعات في الإعدادات ← مسارات المبيعات.
لا رد لفترة
Section titled “لا رد لفترة”| الإعداد | الخيارات |
|---|---|
| البدء عندما | لم يرد العميل (بعد أي رسالة ترسلها إليه، بما في ذلك الحملات) أو لم يرد أحد على العميل (أي رد من فريقك أو بوت الذكاء الاصطناعي أو سير عمل يُحتسب) |
| بعد عدم الرد لمدة | من 5 دقائق إلى 30 يومًا |
كل رسالة جديدة تعيد بدء الانتظار. يعمل مرة واحدة لكل فترة صمت: بعد أن يعمل لجهة اتصال، لن يعمل مجددًا حتى يكتب الطرف الآخر. ولأن الرسائل الجماعية تبدأ أيضًا الانتظار من جهة العميل، أضف شرطًا مثل جهة اتصال في مجموعة لتقييده.
حان موعد المتابعة
Section titled “حان موعد المتابعة”| الإعداد | الخيارات |
|---|---|
| البدء | عندما يحين موعدها، أو عندما تبقى مفتوحة بعد موعدها |
| متأخرة بمقدار | من 5 دقائق إلى 30 يومًا (للخيار الثاني) |
يعمل مرة واحدة لكل متابعة، لكل متابعة في الحساب (بما في ذلك المتابعات التي أُنشئت يدويًا أو بواسطة مسارات العمل) تكون مرتبطة بجهة اتصال. في حالة “تبقى مفتوحة”، لا يحدث شيء إذا أُنجزت المتابعة في موعدها.
استدعاء Webhook
Section titled “استدعاء Webhook”- أرسل طلب
POSTبنص JSON إلى الرابط. يرد Wabot فورًا ويشغّل الخطوة في الخلفية. - لا تعمل الخطوة إلا عندما يكون مفتاحها ومفتاح سير العمل كلاهما مفعّلين، وعندما تتحقق شروطها. يمكن للشروط استخدام المتغير وسير العمل السابق.
- عيّن حقول النص ضمن المتغيرات بمسارات تبدأ بـ
body.، مثلbody.phoneلـ{"phone": "919876543210"}. - أخبر الإجراءات بمن يجب مراسلته عبر متغير رقم الهاتف، مثل
{{phone}}. يجب أن يتضمن الرقم رمز الدولة. المتغير المسمّىnameيعطي جهة الاتصال الجديدة اسمها. - اختر رقم الإرسال عبر اختر القناة، أو اتركه فارغًا لاستخدام رقمك الافتراضي.
- للصورة أو المستند أو الفيديو، ضع الرابط العام للملف في متغير الرابط: متغير مثل
{{invoice}}، أو رابط ثابت مثلhttps://example.com/brochure.pdf، أو رابط يحتوي على متغيرات مثلhttps://example.com/invoices/{{order_id}}.pdf. - لا يفعل التسليم إلى بوت ذكاء اصطناعي وحفظ البيانات شيئًا هنا: لا توجد رسالة من العميل للرد عليها ولا طلب لحفظه.
- الرسائل الحرة لا تصل إلا ضمن نافذة الـ 24 ساعة؛ للوصول إلى عميل جديد، أرسل قالبًا.
رد إجراء Webhook
Section titled “رد إجراء Webhook”يبدأ بعد أن يتلقى إجراء الإرسال إلى Webhook أو تشغيل كود ردًا. الصق ردًا نموذجيًا عبر إضافة استجابة نموذجية: يصبح كل حقل متغيرًا، مثل {{response}} للرد كاملًا أو {{order_id}} لـ response.order_id. الرد برمز خطأ (4xx أو 5xx) يُحتسب أيضًا. انتهاء المهلة لا يُحتسب.
الشروط
Section titled “الشروط”الشروط تحققات إضافية ضمن متقدم ← الشروط. لا تعمل الخطوة إلا إذا تحققت.
ما يمكنك التحقق منه
Section titled “ما يمكنك التحقق منه”| الشرط | يتحقق من | المقارنات | متاح مع |
|---|---|---|---|
| محتوى الرسالة | نص الرسالة، أو عنوان الزر أو الصف، أو التعليق | يساوي، لا يساوي، يحتوي على، لا يحتوي على، يبدأ بـ | يرسل العميل رسالة، تم تسليم الرسالة أو قراءتها |
| رسالة موسومة | وسوم المحادثة على الرسالة | أيٌّ من، ليس أيًا من | يرسل العميل رسالة |
| جهة اتصال في مجموعة | مجموعات جهة الاتصال | أيٌّ من، ليس أيًا من | يرسل العميل رسالة، يبدأ يدويًا، تغيّرت مرحلة مسار المبيعات، لا رد لفترة، حان موعد المتابعة |
| القناة | الرقم أو حساب Instagram أو الصفحة التي وصلت عبرها الرسالة | أحد، ليس أيًا من | يرسل العميل رسالة، تم تسليم الرسالة أو قراءتها |
| المتغير | أي متغير من متغيرات الخطوة | يساوي، لا يساوي، يحتوي على، لا يحتوي على، يبدأ بـ، أكبر من، أصغر من | كل المُشغِّلات ما عدا يبدأ يدويًا وتم تسليم الرسالة أو قراءتها |
| المبلغ الإجمالي | إجمالي الطلب (السعر × الكمية لكل عنصر) | يساوي، لا يساوي، أكبر من، أصغر من | يرسل العميل رسالة ← طلب |
| الحالة | حالة الرسالة: تم الإرسال، تم التسليم، تمت القراءة | أيٌّ من، ليس أيًا من | تم تسليم الرسالة أو قراءتها |
| القالب | القالب الذي كانت عليه الرسالة | أيٌّ من، ليس أيًا من | تم تسليم الرسالة أو قراءتها |
| تحقق الموجّه | ما إذا كانت المحادثة تحقق هدفًا تصفه، ويتحقق منه الذكاء الاصطناعي | متحقق، غير متحقق | يرسل العميل رسالة |
| سير العمل السابق | ما إذا كانت خطوات سابقة قد عملت لجهة الاتصال هذه (راجع الخطوات التالية) | يساوي | كل المُشغِّلات ما عدا يبدأ يدويًا |
كيف تعمل المقارنات
Section titled “كيف تعمل المقارنات”| المقارنة | صحيحة عندما… |
|---|---|
| يساوي / لا يساوي | تكون القيمة هي النص الذي أدخلته تمامًا، أو لا تكون. حساسة لحالة الأحرف، والمسافات تُحتسب |
| يحتوي على / لا يحتوي على | يظهر النص في أي مكان من القيمة، أو لا يظهر. حساسة لحالة الأحرف. القيمة الفارغة لا تحتوي على شيء |
| يبدأ بـ | تبدأ القيمة بالنص. حساسة لحالة الأحرف |
| أيٌّ من / ليس أيًا من | ينطبق عنصر واحد على الأقل من العناصر المختارة، أو لا ينطبق أي منها |
| أحد / ليس أيًا من | (القناة) وصلت الرسالة عبر إحدى القنوات المختارة، أو لم تصل عبر أي منها |
| أكبر من / أصغر من | يكون الطرفان أرقامًا وتصح المقارنة. تُتجاهل رموز العملات وفواصل الآلاف (₹1,250.50 = 1250.5). إذا لم يكن أحد الطرفين رقمًا، تكون النتيجة خطأ |
| متحقق / غير متحقق | يحكم الذكاء الاصطناعي بأن المحادثة تحقق الهدف، أو لا تحققه. كل تحقق يستخدم طلب ذكاء اصطناعي |
المجموعات والربط بـ «و» و«أو»
Section titled “المجموعات والربط بـ «و» و«أو»”- تُربط القواعد داخل المجموعة بـ و (يجب أن تتحقق كلها) أو أو (يكفي تحقق واحدة). وتُربط المجموعات بالطريقة نفسها. ما يصل إلى 6 مجموعات لكل خطوة.
- تُقرأ الروابط بالترتيب: أ و ب أو ج تعني (أ و ب) أو ج. لتجميعها بطريقة مختلفة، استخدم المجموعات.
- الرابط المفقود يُعد و.
- استخدام أو بجوار قاعدة سير العمل السابق يسمح للخطوة بالعمل دون الخطوة السابقة. أبقِ الرابط مربوطًا بـ و.
الإجراءات
Section titled “الإجراءات”| الإجراء | ماذا يفعل | يمكنه الانتظار؟ |
|---|---|---|
| إرسال قالب | يرسل قالب WhatsApp معتمدًا إلى العميل أو إلى رقم آخر | نعم |
| إرسال رسالة | يرسل رسالة حرة: نص أو وسائط أو أزرار أو قائمة أو كتالوج أو نموذج Flow أو طلب دفع (ضمن نافذة الـ 24 ساعة) | نعم |
| الإضافة إلى مجموعات أو وسوم | يضيف جهة الاتصال إلى مجموعات ووسوم | لا |
| تعيين كعميل محتمل | يميّز جهة الاتصال كعميل محتمل، لتُحتسب في تقارير العملاء المحتملين | لا |
| إسناد إلى عضو فريق | يسلّم المحادثة إلى زميل، أو يتناوب، أو يختار الأقل انشغالًا، أو يلغي الإسناد | لا |
| إنشاء متابعة | يضيف مهمة إلى صفحة المتابعات | لا |
| نقل الصفقة إلى مرحلة | ينقل بطاقة جهة الاتصال إلى مرحلة، ويمكنه إنشاء واحدة | لا |
| إنشاء صفقة | يضيف بطاقة لجهة الاتصال إلى مسار مبيعات | لا |
| تعيين الصفقة كرابحة أو خاسرة | ينقل البطاقة إلى أول مرحلة رابحة أو خاسرة في مسار المبيعات | لا |
| تغيير مسؤول الصفقة | يسلّم البطاقة إلى زميل أو إلى المُسند إليه المحادثة | لا |
| تحديث قيمة الصفقة | يعيّن قيمة البطاقة إلى رقم أو متغير | لا |
| التسليم إلى بوت ذكاء اصطناعي | يدع بوت ذكاء اصطناعي يجيب في المحادثة | لا |
| الإرسال إلى Webhook | يرسل البيانات إلى رابط نظام آخر (REST أو GraphQL) | لا |
| تشغيل كود | يشغّل كود JavaScript الخاص بك ويمرّر نتيجته | لا |
| حفظ البيانات | يضيف بيانات الرسالة إلى طلب العميل | لا |
| تحديث قيمة حالة | يخزّن قيمة لكل جهة اتصال أو لكل سير عمل للخطوات اللاحقة | لا |
| تكرار خطوة | يشغّل إجراءات خطوة أخرى مرة أخرى لجهة الاتصال هذه | لا |
| بدء سير عمل آخر | يشغّل سير عمل يدوي لجهة الاتصال هذه | لا |
| إجراءات التكاملات (مثل Shopify) | تستدعي التكامل المرتبط | لا |
إرسال قالب
Section titled “إرسال قالب”| الإعداد | ماذا يفعل |
|---|---|
| الإرسال إلى | العميل (الذي بدأ الخطوة) أو رقم آخر (مع رمز الدولة، أرقام فقط) |
| القالب | أي قالب معتمد |
| الانتظار قبل الإرسال | بالثواني، من وقت المُشغِّل |
| المتغيرات | املأ كل متغير في القالب. لـ الاسم اختر اسم العميل أو رقم هاتف العميل أو أخرى؛ ولـ البريد الإلكتروني البريد الإلكتروني للعميل؛ وللمتغيرات المخصصة اكتب القيمة، أو متغيرًا واحدًا بالضبط مثل {{senderName}} |
| الوسائط | صورة الرأس أو الفيديو أو المستند، للقوالب التي تحتوي على رأس |
يجب أن يكون المتغير المخصص {{variable}} واحدًا بالضبط. النص المحيط به، كما في Hi {{senderName}}، يُرسل كما كُتب. لا يمكن استخدام متغيرات الحالة وإجابات نماذج Flow في القوالب. لا يُتحقق من القيمة المفقودة قبل الإرسال، لذا قد يرفض WhatsApp الرسالة.
إرسال رسالة
Section titled “إرسال رسالة”| نوع الرسالة | ما تحدده | الحدود |
|---|---|---|
| نص فقط | النص | 4096 حرفًا |
| يعتمد على الوسائط | ملف (صورة أو فيديو أو مستند أو صوت) وتعليقه | التعليق 1024 |
| رد سريع | الرأس (نص أو صورة أو فيديو أو مستند) والنص والأزرار | حتى 3 أزرار، 20 حرفًا لكل منها |
| زر إجراء | الرأس والنص وزر واحد برابط | الزر 20 حرفًا |
| قائمة تفاعلية | الرأس والمتن والتذييل والأقسام بصفوفها (العنوان والوصف) وتسمية الزر | عنوان الصف 24، الوصف 72 |
| كتالوج | منتج واحد أو عدة منتجات أو الكتالوج كاملًا، مع نص | يحتاج إلى كتالوج مرتبط بالرقم |
| Flow | الرأس والمتن والتذييل والنموذج ونص زره | الزر 25 حرفًا |
| الدفع | دفع الكتالوج للطلب الذي قُدّم للتو، أو دفع مخصص بعناصرك ومبالغك الخاصة | Razorpay. المدفوعات المخصصة بالروبية الهندية (INR) |
لـ Instagram وMessenger أنواعهما الخاصة: نص فقط، يعتمد على الوسائط، رد سريع، قالب عام، قالب أزرار، رد على تعليق (على تعليق)، وفي Messenger أيضًا قوالب القسيمة والإيصال والمنتج والموافقة (Opt-in).
تعمل المتغيرات في النص والتعليق. إذا كان أي متغير مستخدم هناك مفقودًا أو فارغًا (أو 0)، لا تُرسل الرسالة ويظهر التشغيل كفاشل. الرؤوس والتذييلات والأزرار وصفوف القوائم تُرسل كما كُتبت.
الإرسال إلى Webhook
Section titled “الإرسال إلى Webhook”| الإعداد | ماذا يفعل |
|---|---|
| نوع API | REST أو GraphQL |
| الرابط | المكان الذي يُرسل إليه. يمكن أن يحتوي على {{variables}} |
| الطريقة | POST أو GET (طلب GET لا يرسل نصًا) |
| الترويسات | أزواج من المفتاح والقيمة. {{name}} في الترويسة يعني قيمة حالة |
| إدخال البيانات بصيغة | معلمات النص أو معلمات الاستعلام أو معلمات المسار (REST) |
| البيانات (Payload) / استعلام GraphQL والمتغيرات | بيانات JSON المراد إرسالها. تُملأ {{variables}} الموجودة فيها؛ والمتغيرات غير المعروفة تُرسل كما كُتبت |
تنتهي مهلة الطلب بعد 15 ثانية. لاستخدام الرد، ابدأ خطوة أخرى بالمُشغِّل رد إجراء Webhook.
إجراءات الفريق
Section titled “إجراءات الفريق”إسناد إلى عضو فريق
| الإعداد | الخيارات |
|---|---|
| طريقة الاختيار | عضو فريق محدد، بالتناوب (كلٌّ بدوره)، الأقل انشغالًا (أقل عدد من المحادثات بانتظار الرد)، إلغاء الإسناد |
| عضو الفريق / أعضاء الفريق | واحد، أو اثنان أو أكثر في وضعَي التناوب والأقل انشغالًا |
| فقط إذا لم تكن المحادثة مُسندة بعد | يترك المحادثات التي لها مسؤول بالفعل |
| إبقاء ردود بوت الذكاء الاصطناعي مفعّلة | عند إيقافه: يؤدي الإسناد إلى إيقاف بوت الذكاء الاصطناعي لتلك المحادثة |
إنشاء متابعة
| الإعداد | الخيارات |
|---|---|
| المتابعة | ما يجب فعله، حتى 160 حرفًا. يمكن أن تستخدم {{name}} (اسم جهة الاتصال) ومتغيرات المُشغِّل |
| مستحقة بعد | من 0 إلى 365 دقيقة أو ساعة أو يومًا |
| لـ | المُسند إليه المحادثة (أو مالك الحساب)، عضو فريق محدد، أو لا أحد |
| ربطها ببطاقة جهة الاتصال المفتوحة في مسار المبيعات | يعرض المتابعة على البطاقة أيضًا |
تعيين كعميل محتمل ليست له إعدادات.
إجراءات مسار المبيعات
Section titled “إجراءات مسار المبيعات”كلها تحتاج إلى مسار المبيعات. عندما تكون الخطوة قد بدأت بالمُشغِّل تغيّرت مرحلة مسار المبيعات، فإنها تغيّر تلك البطاقة. وإلا فإنها تغيّر أحدث بطاقة مفتوحة مُحدَّثة لجهة الاتصال في ذلك المسار، ولا تفعل شيئًا إذا لم توجد بطاقة.
| الإجراء | الإعدادات |
|---|---|
| نقل الصفقة إلى مرحلة | النقل إلى مرحلة؛ إنشاء واحد في هذه المرحلة إذا لم يكن لجهة الاتصال بطاقة مفتوح (مع منتج وكمية اختياريين) |
| إنشاء صفقة | المرحلة (الافتراضي: أول مرحلة مفتوحة)، العنوان (يمكن أن يستخدم المتغيرات؛ فارغ = اسم جهة الاتصال وتسمية البطاقة)، القيمة، المسؤول، المنتج والكمية، التخطي إذا كان لجهة الاتصال بطاقة مفتوح بالفعل في هذا المسار (مفعّل افتراضيًا) |
| تعيين الصفقة كرابحة أو خاسرة | رابحة أو خاسرة |
| تغيير مسؤول الصفقة | عضو فريق محدد أو المُسند إليه المحادثة |
| تحديث قيمة الصفقة | رقم أو متغير، مثل {{order_total}}. تُقرأ ₹1,250.50 على أنها 1250.5 |
التسليم إلى بوت ذكاء اصطناعي
Section titled “التسليم إلى بوت ذكاء اصطناعي”| الإعداد | ماذا يفعل |
|---|---|
| اختر بوت الذكاء الاصطناعي | البوت الذي يتولى المحادثة |
| مدة الخمول ووحدة الوقت | المدة التي يمكن أن يبقى فيها العميل صامتًا قبل أن يعيد البوت المحادثة |
| عدد مرات طلب الرد | عدد الإجابات قبل أن يسأل البوت العميل عمّا إذا كان راضيًا |
| رسالة الخروج | تُرسل عند انقضاء مدة الخمول، مع زرّي نعم ولا |
يجيب البوت عن الرسالة الحالية فورًا، إذا كان الذكاء الاصطناعي مفعّلًا للقناة ولجهة الاتصال وكانت الرسالة تحتوي على نص. حتى تنقضي مدة الخمول أو ينقر العميل على نعم، تذهب رسائله التي لا تطابق خطوة أخرى إلى هذا البوت.
البيانات والتحكم في سير العمل
Section titled “البيانات والتحكم في سير العمل”| الإجراء | الإعدادات والسلوك |
|---|---|
| تشغيل كود | كود JavaScript الخاص بك. يمكن استخدام متغيرات الخطوة فيه، مثل {{senderName}} أو حقل Webhook مثل {{order_id}}. نتيجته تبدأ أي خطوة رد إجراء Webhook مرتبطة به |
| حفظ البيانات | الطلبات: يضيف بيانات الرسالة الواردة (مثل عنوان من نموذج Flow) إلى طلب العميل |
| تحديث قيمة حالة | اختر متغير حالة والقيمة (أحد متغيرات الخطوة). القيمة الفارغة تفشل |
| تكرار خطوة | يشغّل إجراءات الخطوة المختارة مرة أخرى لجهة الاتصال هذه، دون التحقق من شروطها. لا تجعل خطوة تشير إلى نفسها |
| بدء سير عمل آخر | يشغّل سير العمل اليدوي الذي تختاره لجهة الاتصال هذه، من الرقم الذي تختاره |
المتغيرات
Section titled “المتغيرات”اكتب المتغير بالشكل {{name}}. يسرد قسم المتغيرات في الخطوة المتغيرات التي يمكنك استخدامها، مع زر نسخ.
المتغيرات المدمجة
Section titled “المتغيرات المدمجة”| المتغير | القيمة | يضيفه |
|---|---|---|
senderName |
اسم الملف الشخصي للعميل على WhatsApp | يرسل العميل رسالة، رد إجراء Webhook |
senderID |
رقم هاتف العميل | نفس ما سبق |
button_reply_identifier |
الزر الذي نُقر عليه | أزرار رد سريع تفاعلية |
ad_headline، ad_body، ad_source_url، ad_source_id، ad_source_type، ctwa_clid |
تفاصيل الإعلان الذي نقر عليه العميل | رسالة من إعلان Click-to-WhatsApp |
كل حقل في نموذج Flow، مثل {{preferred_date}} |
إجابة العميل | Flow |
status |
success أو failed أو pending |
الدفع |
response وكل حقل من حقول الرد |
رد Webhook أو تشغيل كود | رد إجراء Webhook (بعد إضافة استجابة نموذجية) |
| كل حقل في الحدث | بيانات الحدث | مُشغِّلات التكاملات |
deal_id، deal_title، deal_value، deal_currency، pipeline_name، stage_name، previous_stage_name، owner_name، deal_items |
البطاقة التي انتقلت | تغيّرت مرحلة مسار المبيعات |
waiting_hours، waiting_since |
مدة هدوء المحادثة ومنذ متى | لا رد لفترة |
followup_text، followup_due_at، followup_assignee، followup_overdue_hours |
نص المتابعة وموعدها والمُسندة إليه وساعات التأخير | حان موعد المتابعة |
name |
اسم جهة الاتصال (أو رقمها) | دائمًا، في نص المتابعة وعنوان الصفقة وقيمتها |
متغيراتك الخاصة
Section titled “متغيراتك الخاصة”انقر على إضافة متغير ضمن متقدم ← المتغيرات. تستخدم الأسماء الأحرف والأرقام و_، وتبدأ بحرف.
| المصدر | القيمة | مثال |
|---|---|---|
| من بيانات المُشغِّل | مسار داخل بيانات المُشغِّل. يحدد الجزء الأول مصدرها (messageMetadata.، body.، response.، timer.)، والباقي هو الحقل |
body.customer.email يقرأ customer.email من نص Webhook |
| قيمة ثابتة | النص نفسه في كل مرة | رمز خصم |
تُحفظ المتغيرات التي تضيفها عند تغيير المُشغِّل أو القناة أو نوع الرسالة.
متغيرات الحالة
Section titled “متغيرات الحالة”تحتفظ الحالات بقيمة لكل جهة اتصال (أو لكل سير عمل) بين الخطوات وعبر الوقت، مثل اللغة التي اختارها العميل. أنشئها من الحالات في قائمة بطاقة سير العمل: الحالة (الاسم)، القيمة (الافتراضية)، النوع (مثل حالة جهة الاتصال) ونوع البيانات. يمكن لكل خطوة استخدامها بالشكل {{state}}؛ وعيّنها باستخدام تحديث قيمة حالة. تعمل في الرسائل والشروط وWebhooks، لكن ليس في القوالب.
أين تعمل المتغيرات
Section titled “أين تعمل المتغيرات”| المكان | المتاح | إذا كانت القيمة مفقودة |
|---|---|---|
| نص إرسال رسالة وتعليقها | كل شيء: بيانات المُشغِّل، إجابات نماذج Flow، متغيراتك، الحالات | لا تُرسل الرسالة (فشل) |
| متغيرات إرسال قالب | بيانات المُشغِّل ومتغيراتك (لا إجابات نماذج Flow ولا الحالات) | تُرسل فارغة، أو كما كُتبت إذا لم تكن أحد متغيرات الخطوة؛ وقد يرفضها WhatsApp |
| رابط الإرسال إلى Webhook وبياناته | كل شيء | تُرسل كما كُتبت، مثل {{phone}} |
| شرط المتغير | كل شيء | يقارن الشرط قيمة فارغة |
| نص إنشاء متابعة، وعنوان إنشاء صفقة، وتحديث قيمة الصفقة | name، ومتغيرات المُشغِّل (Webhook، المؤقت، مسار المبيعات، التكامل)، ومتغيراتك، والحالات |
تُترك فارغة |
| تحديث قيمة حالة | بيانات المُشغِّل، متغيراتك، الحالات | يفشل الإجراء |
| تشغيل كود | بيانات المشغّل (بما فيها نص Webhook أو رده)، ومتغيراتك، والحالات | undefined |
يبدأ يدويًا
Section titled “يبدأ يدويًا”تعمل مسارات العمل اليدوية لجهات الاتصال أو المجموعات التي تختارها، من جهات الاتصال (تشغيل سير عمل) أو نموذج عملاء محتملين من Meta أو بدء سير عمل آخر. وهي تعمل بشكل مختلف عن المسارات التلقائية:
- لا تُستخدم إلا شروط جهة اتصال في مجموعة (مع أول مجموعة مختارة).
- ينتظر كل إجراء مدته بعد الإجراء السابق. اترك انتظار القالب على 0، لأنه يُطبَّق مرتين.
- لا يمكن لـ إرسال رسالة استخدام المتغيرات: الرسالة التي تحتوي على
{{variables}}توقف التشغيل. يمكن للقوالب استخدام الإعدادين المسبقين الاسم والبريد الإلكتروني والقيم الثابتة. - هذه الإجراءات تعمل: إرسال قالب، إرسال رسالة، الإضافة إلى مجموعات أو وسوم، إجراءات الفريق وإجراءات مسار المبيعات. أما Webhooks وتشغيل كود والتسليم إلى الذكاء الاصطناعي والحالات وحفظ البيانات وتكرار خطوة وبدء سير عمل آخر فلا تُنفَّذ.
- عمليات التشغيل اليدوية لا تظهر في عمليات التشغيل ولا تفتح الخطوات التالية.
الحدود
Section titled “الحدود”| العنصر | الحد |
|---|---|
| الخطوات لكل سير عمل | 10 في محرر النموذج |
| مجموعات الشروط لكل خطوة | 6 |
| أزرار الرد السريع | 3 |
| الانتظار قبل الإرسال | لا حد أقصى (بالثواني) |
| انتظار عدم الرد / التأخير | من 5 دقائق إلى 30 يومًا |
| موعد المتابعة | حتى 365 يومًا |
| نص المتابعة، عنوان الصفقة | 160 حرفًا |
| مهلة Webhook | 15 ثانية؛ تُحفظ الردود حتى 64 KB |
| محاولات إعادة الإرسال | 5 محاولات، ثم تُسقط الرسالة |
غير متاح بعد
Section titled “غير متاح بعد”| قد ترغب في… | في الوقت الحالي |
|---|---|
| مُشغِّل في تاريخ أو وقت محدد (مثل تذكير بموعد) | أنشئ متابعة لزميل، أو عيّن تذكيرًا من صندوق الوارد |
| إيقاف تسلسل عندما يرد العميل | اجعل التسلسلات قصيرة، واستخدم لا رد لفترة للتذكير |
| انتظار في إجراءات الفريق أو مسار المبيعات | استخدم لا رد لفترة أو حان موعد المتابعة للتصرف لاحقًا |
| عناصر الطلب كمتغيرات | تحقّق من القيمة باستخدام المبلغ الإجمالي |
| مُشغِّل دفع لطلبات الدفع المخصصة | طلبات الكتالوج فقط تبدأ الدفع |
| مُشغِّل للملصقات أو المواقع أو جهات الاتصال أو التفاعلات | غير مدعوم |
