مُشغِّلات وإجراءات سير العمل في HubSpot لـ WhatsApp

يضيف Flowella مُشغِّلات WhatsApp وخمسة إجراءات إلى مسارات سير العمل في HubSpot. استخدمها لإرسال القوالب والرسائل، وانتظار رد جهة الاتصال أو إرسالها لـ Flow، وقراءة المستندات إلى خصائص جهات الاتصال، وإنشاء ملفات PDF. تسرد هذه الصفحة كل مُشغِّل وإجراء مع حقوله ومخرجاته ورموز أخطائه. تعتمد عدة إجراءات على نافذة 24 ساعة: لمدة 24 ساعة بعد أن تراسل جهة اتصال رقم WhatsApp الخاص بك، يمكنك إرسال أي رسالة إليها. وخارج النافذة، لا يسلّم WhatsApp إلا القوالب المعتمدة.

قبل أن تبدأ

وصّل HubSpot بـ Flowella وتحقق من أن Custom workflow actions ضمن Unlocked في بطاقة Capabilities في Settings → HubSpot. راجع الإمكانات.
بالنسبة للمُشغِّلات، يجب أن تكون Contact activity events (message sent, read, replies, forms) مفتوحة أيضًا. راجع Check that contact activity events are unlocked.
استخدم مسارات سير العمل القائمة على جهات الاتصال. لا تعمل إجراءات Flowella إلا على جهات الاتصال. وتتوفر مسارات سير العمل في HubSpot مع خطط Professional وEnterprise.
لإرسال القوالب، يجب أن يكون لديك قالب معتمد واحد على الأقل. راجع القوالب.
خزّن أرقام WhatsApp بالتنسيق الدولي، مثل +447700900123. راجع تنسيق رقم الهاتف.

راجع قبل أن تبدأ للاطلاع على قائمة التحقق الكاملة.

تستخدم إجراءات الإرسال دائمًا رقم WhatsApp الافتراضي الخاص بك. للتحقق منه أو تغييره، راجع Connected numbers table.

كيف تعمل عملية الإرسال من سير العمل

يوضح هذا المخطط ما يحدث عندما يرسل سير عمل قالبًا، وكيف يعود رد جهة الاتصال إلى HubSpot. لا تنطبق خطوات صندوق وارد HubSpot إلا عند توصيل قناة Flowella المخصصة.

يحتجز HubSpot جهة الاتصال عند خطوة الإرسال حتى يبلّغ Flowella بالنتيجة، لمدة تصل إلى ساعة واحدة. يبلّغ Flowella بالنجاح عندما يعلّم WhatsApp الرسالة كمُرسلة.
إذا فشل الإرسال، تفشل الخطوة مع سبب ورمز خطأ، ويتابع سير العمل إلى الخطوة التالية. راجع رموز الأخطاء.
تظهر كل عملية إرسال في صندوق وارد Flowella. كما تظهر القوالب التي يرسلها سير العمل في سلسلة صندوق وارد HubSpot، كاسم القالب ولغته. أما الرسائل المرسلة عبر Send WhatsApp Message وSend WhatsApp Reply فلا تظهر في سلسلة صندوق وارد HubSpot.

المُشغِّلات

عند اختيار مُشغِّل لسير عمل قائم على جهات الاتصال، أو الحدث لخطوة Delay until event، ابحث عن Flowella. يسرد HubSpot الأحداث ضمن Flowella: WhatsApp Forms Integration، مثل Flowella: WhatsApp Forms Integration: Form Completed.

المُشغِّل	يُطلق عندما	خصائص الحدث
Form Completed	ترسل جهة اتصال WhatsApp Flow ويرسل Flowella الإجابات إلى نموذج HubSpot	`formName`، `source` (دائمًا `WhatsApp Flow`)
Text Reply	ترسل جهة اتصال رسالة نصية، أو تنقر على زر رد سريع، أو تختار من قائمة، أو ترسل Flow	`phone`، `message`، `responseTimeSeconds`
Message Sent	يبلّغ WhatsApp بأن رسالة من Flowella أُرسلت إلى جهة الاتصال	`phone`، `deliveryStatus` (دائمًا `sent`)، `templateName` (لعمليات إرسال القوالب فقط)
Message Read	يبلّغ WhatsApp بأن جهة الاتصال قرأت رسالة من Flowella	`phone`، `messageType`، `timeToReadSeconds`

يمكنك التصفية حسب هذه الخصائص في المُشغِّل، وفي خطوات Delay until event، وفي القوائم النشطة. للاطلاع على المرجع الكامل للخصائص، راجع Event properties for filtering.

Form Completed (وارد)

يُطلق هذا المُشغِّل عندما ترسل جهة اتصال WhatsApp Flow.

لا يُطلق إلا لعمليات إرسال WhatsApp Flow. فإرسال نموذج HubSpot نفسه من الموقع الإلكتروني لا يطلقه، لذا استخدم مُشغِّل إرسال النماذج الخاص بـ HubSpot لتلك الحالات.
يسجّل الحدث اسم النموذج والمصدر، وليس الإجابات. يرسل Flowella الإجابات إلى HubSpot كعملية إرسال للنموذج الذي بُني منه الـ Flow. أضف فروعًا حسب خصائص جهة الاتصال التي يكتبها النموذج.
صفِّ حسب Form Name لكي لا تسجّل جهة الاتصال أو تنهي الانتظار إلا عمليات إرسال ذلك النموذج.

الاستخدام المعتاد: معالجة نموذج حجز أو ملاحظات أو تأهيل بمجرد أن ترسله جهة الاتصال.

Text Reply (وارد)

يُطلق هذا المُشغِّل عندما ترسل لك جهة اتصال رسالة نصية. كما يُطلق عندما تقوم جهة الاتصال بما يلي:

النقر على زر رد سريع. يكون الرد هو تسمية الزر.
اختيار خيار من قائمة. يكون الرد هو عنوان الخيار.
إرسال WhatsApp Flow. يكون الرد ملخصًا من سطر واحد يبدأ بعنوان الـ Flow.

لا يُطلق للصور أو الرسائل الصوتية أو الفيديوهات أو المستندات، حتى عندما تحتوي على تعليق. ولأن إرسال Flow يُحتسب كرد، فإن خطوة Delay until event التي تنتظر Text Reply تنتهي أيضًا عندما ترسل جهة الاتصال Flow. للتوجيه حسب ما قالته جهة الاتصال، سجّل جهات الاتصال عند Text Reply وأضف فرعًا حسب خاصية جهة الاتصال Last WhatsApp reply message (flowella_last_reply_message). يكتب Flowella الرد في هذه الخاصية، والوقت في Last WhatsApp reply at (flowella_last_reply_at)، قبل إطلاق الحدث. تحتوي الخاصية دائمًا على الرد الذي أطلق المُشغِّل. استخدم المطابقات التامة للخيارات الثابتة مثل Yes وNo. راجع Last WhatsApp reply contact properties.

لا تصفِّ المُشغِّل نفسه حسب خاصية Message للحدث. يتحقق HubSpot من عوامل تصفية الأحداث مقابل كل حدث Text Reply أرسلته جهة الاتصال على الإطلاق، لذا يطابق عامل التصفية بالكلمات المفتاحية الردود القديمة إلى جانب الرد الجديد. أعد بناء أي سير عمل يصفّي حسب Text Reply → Message بحيث يضيف فرعًا حسب Last WhatsApp reply message بدلًا من ذلك.

STOP وUNSUBSCRIBE وCANCEL وEND وQUIT هي كلمات مفتاحية لإلغاء الاشتراك. عندما تكون إحداها هي الرسالة كاملة، يلغي Flowella اشتراك جهة الاتصال في الرسائل من رقم WhatsApp ذاك. ومع ذلك تطلق الرسالة Text Reply، لذا لا تبنِ مسارات تطلب من جهات الاتصال الرد بهذه الكلمات، ولا تسمِّ زر رد سريع Cancel أو Stop. راجع How keyword opt-outs work.

الاستخدام المعتاد: توجيه جهات الاتصال حسب ردود مثل Yes أو Book أو Help، أو إرسال Flow عندما تطلب جهة اتصال شيئًا.

Message Read (صادر)

يُطلق هذا المُشغِّل عندما يبلّغ WhatsApp بأن جهة الاتصال قرأت رسالة أرسلتها عبر Flowella. يمثّل messageType نوع الرسالة التي قُرئت: TEXT أو IMAGE أو AUDIO أو VIDEO أو DOCUMENT أو TEMPLATE أو SYSTEM أو OTHER. صفِّ حسب messageType يساوي TEMPLATE للاطلاع على قراءات القوالب فقط. الاستخدام المعتاد: المتابعة فقط بعد أن ترى جهة الاتصال رسالتك الأولى.

Message Sent (صادر)

يُطلق هذا المُشغِّل عندما يبلّغ WhatsApp بأن رسالة من Flowella أُرسلت إلى جهة الاتصال. ويغطي الرسائل من مسارات سير العمل وصندوق وارد Flowella وعمليات الإرسال المجمّع. تكون deliveryStatus دائمًا sent، لأن Flowella لا يسجّل عمليات التسليم كأحداث. وتحتوي templateName على اسم القالب لعمليات إرسال القوالب، مثل flowella_form_reminder. الاستخدام المعتاد: تتبّع الرسائل التي يرسلها فريقك من صندوق وارد Flowella، أو بدء مؤقت للمتابعة. لا يحتاج سير العمل إلى هذا المُشغِّل لعمليات الإرسال الخاصة به، لأن مخرجات خطوة الإرسال تسجّلها بالفعل.

استخدام “Delay until event” مع مُشغِّلات Flowella

توقف خطوة Delay until event في HubSpot جهة الاتصال مؤقتًا حتى يقع حدث من Flowella، أو حتى ينقضي حد زمني. ثم تتحقق خطوة Branch مما إذا كان الحدث قد وقع في الوقت المحدد. على سبيل المثال، يمكن لسير العمل أن:

يرسل Flow باستخدام Send WhatsApp Template.
ينتظر باستخدام Delay until event، مضبوطة على حدث Form Completed من Flowella ومصفّاة حسب Form Name.
يضيف فرعًا حسب ما إذا كانت جهة الاتصال قد أرسلت في الوقت المحدد. وإن لم تفعل، يرسل تذكيرًا أو ينشئ مهمة.

يمكنك انتظار أي حدث من Flowella:

Form Completed: انتظر إجابات الـ Flow، ثم أضف فرعًا حسب الخصائص التي كتبها النموذج.
Text Reply: انتظر أي رد، ثم أضف فرعًا حسب Last WhatsApp reply message.
Message Read: انتظر حتى تفتح جهة الاتصال رسالتك، ثم قرّر ما إذا كنت ستتابع.

خطّط للحد الزمني مع مراعاة نافذة 24 ساعة. لا تصل المتابعة بنص عادي إلى جهة الاتصال إلا إذا راسلتك خلال آخر 24 ساعة. وبعد انتظار أطول، تابع باستخدام Send WhatsApp Template أو Send WhatsApp Reply.

الإجراءات

يضيف Flowella خمسة إجراءات إلى مسارات سير العمل القائمة على جهات الاتصال. ابحث عن اسم الإجراء عند إضافة خطوة.

الإجراء	ما يفعله	عندما تكون نافذة 24 ساعة مغلقة
Send WhatsApp Template	يرسل قالبًا معتمدًا، بما في ذلك القوالب التي تحتوي على زر Flow	يرسل كالمعتاد
Send WhatsApp Message	يرسل نصًا عاديًا	يفشل
Send WhatsApp Reply	يرسل نصًا، أو يضعه داخل قالب الرد الذكي Service	يرسل القالب، أو يتخطى الإرسال إذا اخترت ذلك
AI Document Reader	يقرأ ملف PDF أو صورة ويكتب القيم في خصائص جهة الاتصال	لا يتأثر
Generate Document	ينشئ ملف PDF من قالب مستند ويحفظه في ملفات HubSpot	لا يتأثر

Assign to Customer Agent هو إجراء خاص بـ HubSpot، وليس إجراءً من Flowella. راجع تسليم المحادثات إلى HubSpot Customer Agent.

مخرجات إجراءات الإرسال

تُرجع Send WhatsApp Template وSend WhatsApp Message وSend WhatsApp Reply هذه المخرجات. ويمكن للخطوات اللاحقة في سير العمل استخدامها كرموز بيانات.

المُخرَج	ما يحتويه
Message ID	معرّف WhatsApp للرسالة.
Message status	`sent` عندما تنجح الخطوة، أو `delivered` أو `read` إذا أبلغ WhatsApp بذلك أولًا. و`failed` عندما تفشل الخطوة.
Recipient WhatsApp ID	رقم جهة الاتصال بالتنسيق الدولي، دون `+`.
Message type	`template` أو `text`.
Sent at	وقت انتهاء الخطوة، كطابع زمني بتوقيت UTC.
Error message	سبب فشل الخطوة. ويعرض HubSpot هذه الرسالة أيضًا في سجل سير العمل.
Error code	رمز قصير للفشل. راجع رموز الأخطاء.

Send WhatsApp Template

يرسل هذا الإجراء قالب WhatsApp معتمدًا إلى جهة الاتصال المسجّلة من رقمك الافتراضي. تُرسل القوالب التي تحتوي على زر Flow بالطريقة نفسها، لذا فهذه هي أيضًا طريقة إرسال Flow من سير عمل.

الحقل	الوصف
Contact Phone Number (مطلوب)	خاصية جهة الاتصال التي تحتوي على رقم WhatsApp للمستلم، بالتنسيق الدولي. إذا كانت الخاصية فارغة لجهة اتصال، يستخدم Flowella رقم هاتف WhatsApp لجهة الاتصال (`hs_whatsapp_phone_number`)، ثم رقم الهاتف المحمول (`mobilephone`)، ثم رقم الهاتف (`phone`).
Template Name (مطلوب)	القالب المراد إرساله. تعرض القائمة القوالب المعتمدة لحساب WhatsApp Business Account الخاص برقمك الافتراضي. يظهر كل اسم بمسافات وأحرف كبيرة، لذا يظهر `booking_confirmation` على أنه Booking Confirmation.
Contact Email	اختياري. لا يستخدمه Flowella عند الإرسال.
Template Variable 1 to 5	قيم متغيرات القالب. اربط خصائص HubSpot أو رموز بيانات أخرى. يأخذ متغير الترويسة النصية Template Variable 1، وتليه متغيرات النص الأساسي بالترتيب.

المتغيرات

اربط المتغيرات بالترتيب الذي يعرضها به القالب. لا تستخدم ترويسات الصور والفيديو والمستندات أي خانة. على سبيل المثال، يحتوي قالب على {{1}} في الترويسة و{{1}} و{{2}} في النص الأساسي. اربط Template Variable 1 بقيمة الترويسة، وTemplate Variables 2 و3 بقيم النص الأساسي.
إذا كانت القيمة المربوطة فارغة، أو ربطت خانات أقل من عدد متغيرات القالب، يرسل Flowella القيمة الاحتياطية المؤكدة للقالب. وإذا لم تكن هناك قيمة احتياطية مؤكدة، يفشل الإرسال. راجع Fallback values.
يحتوي الإجراء على خمس خانات. لأي متغير بعد الخامس، يرسل Flowella القيمة الاحتياطية المؤكدة، وإلا يفشل الإرسال.
تظهر التواريخ بتوقيت UTC. راجع متغيرات التاريخ والوقت.
بالنسبة لترويسة الموقع، اربط خط العرض وخط الطول بالخانات التي تلي متغيرات النص الأساسي. راجع Location headers.

الوسائط والأزرار واللغة

تستخدم ترويسات الصور والفيديو والمستندات دائمًا الوسائط المحفوظة مع القالب. ولا يمكنك تغيير الوسائط لكل جهة اتصال من HubSpot.
لا يمكنك تعيين قيم الأزرار لكل جهة اتصال. ضع الروابط أو الرموز الخاصة بكل جهة اتصال في متغير في النص الأساسي بدلًا من ذلك.
عندما يحتوي القالب على زر Flow، يمرر Flowella معرّف HubSpot لجهة الاتصال المسجّلة إلى الـ Flow. يساعد ذلك Flowella على مطابقة الإرسال مع جهة الاتصال نفسها.
إذا كان القالب موجودًا بأكثر من لغة، يرسل Flowella إصدار en. وإذا لم يكن هناك إصدار en، يرسل الإصدار الذي حُدِّث مؤخرًا. لا تُحتسب الإصدارات بـ en_GB أو en_US على أنها en. راجع Language.

عمليات الإرسال المكررة. إذا أُرسل القالب نفسه، باللغة نفسها، إلى رقم الهاتف نفسه من رقم WhatsApp نفسه خلال 15 ثانية، يرسله Flowella مرة واحدة. تفشل الخطوة الأخرى فورًا مع DUPLICATE_TEMPLATE_SEND_SUPPRESSED، ويتابع سير العمل. يحدث هذا عادةً عندما تشترك جهتا اتصال في HubSpot في رقم هاتف وتُسجَّلان في الوقت نفسه. ومع ذلك وصل القالب إلى رقم الهاتف ذاك. راجع Template send suppressed as duplicate.

Send WhatsApp Message

يرسل هذا الإجراء رسالة نصية عادية إلى جهة الاتصال المسجّلة من رقمك الافتراضي. ولا يمكنه إرسال الوسائط أو الأزرار أو القوالب.

الحقل	الوصف
Recipient Phone Number (مطلوب)	خاصية جهة الاتصال التي تحتوي على رقم WhatsApp للمستلم. إذا كانت فارغة لجهة اتصال، يستخدم Flowella رقم هاتف WhatsApp لجهة الاتصال، ثم رقم الهاتف المحمول، ثم رقم الهاتف.
Message Text (مطلوب)	الرسالة. خصّصها باستخدام رموز بيانات HubSpot، مثل الاسم الأول لجهة الاتصال.

النقاط الأساسية:

لا تصل الرسالة إلى جهة الاتصال إلا داخل نافذة 24 ساعة. لا يتحقق Flowella من النافذة أولًا. إذا لم تراسل جهة الاتصال رقمك الافتراضي خلال آخر 24 ساعة، يرفض WhatsApp الرسالة (خطأ Meta رقم 131047) وتفشل الخطوة. راجع الخطأ 131047.
عندما قد تكون النافذة مغلقة، استخدم Send WhatsApp Reply أو Send WhatsApp Template بدلًا من ذلك.
يرسل Flowella النص تمامًا كما يملؤه HubSpot. ولا يعيد تنسيق التواريخ.
تظهر الرسالة في صندوق وارد Flowella، وليس في سلسلة صندوق وارد HubSpot.

Send WhatsApp Reply

يرسل هذا الإجراء رسالتك كنص عادي عندما تكون نافذة 24 ساعة مفتوحة. وعندما تكون النافذة مغلقة، يرسل الرسالة داخل قالب الرد الذكي Service الخاص بك، لكي تتمكن من الوصول إلى جهة الاتصال رغم ذلك. استخدمه عندما قد يعمل سير العمل بعد ساعات أو أيام من آخر رسالة من جهة الاتصال.

الحقل	الوصف
Message body (مطلوب)	رسالتك. خصّصها باستخدام رموز بيانات HubSpot.
Skip if window is closed	عند تحديده، لا يرسل الإجراء قالبًا. وإذا كانت النافذة مغلقة، تفشل الخطوة مع `SESSION_CLOSED_SKIPPED` ويتابع سير العمل.

لا يحتوي الإجراء على حقل هاتف. يستخدم Flowella رقم هاتف WhatsApp لجهة الاتصال، ثم رقم الهاتف المحمول، ثم رقم الهاتف. يوضح هذا المخطط كيف يقرر الإجراء ما يرسله. عندما تكون النافذة مغلقة:

يستخدم Flowella دائمًا قالب الرد الذكي Service. ويملأ {{1}} بالاسم الأول لجهة الاتصال، و{{2}} باسم مؤسستك، و{{3}} برسالتك.
قوالب الرد الذكي متاحة باللغة الإنجليزية فقط.
إذا كان قالب Service متوقفًا، أو غير معتمد بعد، أو أوقفته Meta مؤقتًا، تفشل الخطوة مع الرسالة “Smart Reply template is not approved yet. Check Settings → Reply Templates.” تحقق من القالب في Settings → WhatsApp (Meta) → Smart replies. راجع الردود الذكية.

قد تحتسب Meta رسومًا على الرسالة سواء كانت النافذة مفتوحة أم مغلقة. راجع التسعير وفئات الرسائل. مثل Send WhatsApp Message، يرسل هذا الإجراء النص كما يملؤه HubSpot، ولا تظهر رسائله في سلسلة صندوق وارد HubSpot. متى تستخدمه بدلًا من Send WhatsApp Message:

متابعات إعادة التفاعل ونجاح العملاء التي قد تعمل بعد 24 ساعة من الصمت.
المتابعات بعد انتظار Form Completed بحد زمني طويل.
أي عملية إرسال يجب أن تصل إلى جهة الاتصال أيًا كانت حالة النافذة.

تتبّع النافذة في خاصية HubSpot

يمكن لـ Flowella إبقاء خاصية جهة اتصال محدّثة بوقت إغلاق نافذة 24 ساعة لجهة الاتصال. يكتب Flowella في whatsapp_window_open_until لكنه لا ينشئها، لذا أنشئها في HubSpot أولًا:

في HubSpot، أنشئ خاصية جهة اتصال. راجع دليل HubSpot حول إنشاء الخصائص.
اختر نوع الحقل Date and time picker.
تحقق من أن الاسم الداخلي هو whatsapp_window_open_until تمامًا قبل الحفظ. لا يسمح لك HubSpot بتغيير الاسم الداخلي لاحقًا.

في كل مرة ترسل لك جهة الاتصال رسالة، يعيّن Flowella الخاصية إلى 24 ساعة بعد تلك الرسالة. يتطلب ذلك وجود CRM contacts (auto-create on new WhatsApp chat) ضمن Unlocked في Settings → HubSpot. استخدم الخاصية في الفروع والقوائم، مثلًا للتعامل بشكل مختلف مع جهات الاتصال التي أُغلقت نافذتها. تعكس الخاصية أحدث رسالة من جهة الاتصال إلى أي من أرقام WhatsApp الخاصة بك. أما Send WhatsApp Reply فيتحقق من النافذة على رقمك الافتراضي فقط.

AI Document Reader

يقرأ هذا الإجراء ملف PDF أو صورة، ويعثر على القيم التي تطلبها ويكتبها في خصائص جهة الاتصال المسجّلة. استخدمه للمستندات التي ترسلها إليك جهات الاتصال، مثل ملف مرفوع عبر نموذج HubSpot أو WhatsApp Flow.

الحقل	الوصف
Document source (مطلوب)	مكان المستند. أدخل رابط `https://`، أو المعرّف الرقمي لملف في ملفات HubSpot، أو الاسم الداخلي لخاصية جهة اتصال تحتوي على رابط أو معرّف ملف.
Field map JSON (مطلوب)	مصفوفة JSON تضم ما يصل إلى 40 إدخالًا. يقرن كل إدخال قيمة يجب العثور عليها (`extract`) بالاسم الداخلي لخاصية جهة الاتصال التي ستُكتب فيها (`hubspot`).
Extraction instructions	تلميحات اختيارية، مثل مكان ظهور قيمة في المستند. يستخدم Flowella أول 2,000 حرف.
Clear HubSpot properties when empty	عند تحديده، تؤدي القيمة التي لا يستطيع Flowella العثور عليها إلى مسح الخاصية المطابقة. وعند عدم تحديده، يترك Flowella تلك الخاصية كما هي.

تبدو خريطة الحقول كما يلي:

[
  { "extract": "passport_number", "hubspot": "passport_number" },
  { "extract": "date_of_birth", "hubspot": "date_of_birth" },
  { "extract": "full_name", "hubspot": "firstname" }
]

يبدأ كل اسم extract بحرف، ولا يستخدم إلا الأحرف والأرقام والشرطات السفلية، ويصل طوله إلى 64 حرفًا. استخدم كل اسم extract مرة واحدة. المستندات التي يمكن لـ Flowella قراءتها:

ملفات PDF وJPEG وPNG وWebP، حتى 15 ميغابايت. يتحقق Flowella من محتويات الملف، وليس من اسمه. تفشل التنسيقات الأخرى، بما في ذلك صور HEIC من أجهزة iPhone، مع DOCUMENT_UNSUPPORTED_TYPE.
ملفات PDF حتى 4 صفحات.
يجب أن تبدأ الروابط بـ https://.

إذا كان ملف PDF يحتوي على نص قليل أو لا يحتوي على نص، مثل ملف ممسوح ضوئيًا، يقرؤه Flowella بصريًا، بالطريقة نفسها التي يقرأ بها الصورة. كيف تُكتب الخصائص:

يكتب Flowella جميع القيم في تحديث واحد لجهة الاتصال.
إذا كانت أي خاصية في خريطة الحقول غير موجودة في HubSpot، أو رفض HubSpot قيمة، يفشل التحديث بالكامل مع HUBSPOT_PATCH_FAILED. ولا تتغير أي خصائص. تحقق من كل اسم داخلي قبل تشغيل سير العمل.
يحدد Clear HubSpot properties when empty ما يحدث للخصائص الخاصة بالقيم التي لا يستطيع Flowella العثور عليها. أما القيم التي يعثر عليها فتُكتب دائمًا.

عندما تنجح الخطوة، تُرجع هذه المخرجات:

المُخرَج	ما يحتويه
Properties written	الأسماء الداخلية للخصائص التي كتبها Flowella، مفصولة بفواصل.
Page count	عدد الصفحات التي قرأها Flowella.
Extraction mode	`text` لملفات PDF التي تحتوي على نص قابل للقراءة، أو `vision` للصور وملفات PDF الممسوحة ضوئيًا.

رموز الأخطاء:

رمز الخطأ	المعنى
`DOCUMENT_SOURCE_MISSING`	Document source فارغ، أو أن خاصية جهة الاتصال التي يحددها لا تحتوي على رابط أو معرّف ملف.
`DOCUMENT_SOURCE_NOT_HTTPS`	لا يبدأ الرابط بـ `https://`.
`DOCUMENT_DOWNLOAD_FAILED`	تعذّر على Flowella تنزيل الملف.
`DOCUMENT_TOO_LARGE`	حجم الملف أكبر من 15 ميغابايت.
`DOCUMENT_UNSUPPORTED_TYPE`	الملف ليس PDF أو JPEG أو PNG أو WebP.
`DOCUMENT_TOO_MANY_PAGES`	يحتوي ملف PDF على أكثر من 4 صفحات.
`DOCUMENT_EXTRACT_FAILED`	تعذّر على Flowella قراءة المستند.
`HUBSPOT_PATCH_FAILED`	رفض HubSpot التحديث، مثلًا لأن خاصية في خريطة الحقول غير موجودة. لم يُكتب أي شيء.
`FIELD_MAP_MISSING`، `FIELD_MAP_EMPTY`، `FIELD_MAP_INVALID_JSON`، `FIELD_MAP_INVALID`، `FIELD_MAP_DUPLICATE`، `FIELD_MAP_TOO_LARGE`	Field map JSON مفقود، أو فارغ، أو ليس JSON صالحًا، أو يحتوي على إدخال يخالف القواعد أعلاه، أو يكرر اسم `extract`، أو يحتوي على أكثر من 40 إدخالًا.
`HUBSPOT_NOT_CONNECTED`	لا يستطيع Flowella الوصول إلى حساب HubSpot الخاص بك. أعد توصيل HubSpot.

Generate Document

يملأ هذا الإجراء قالب مستند من Flowella بخصائص HubSpot لجهة الاتصال المسجّلة، وينشئ ملف PDF ويحفظه في ملفات HubSpot الخاصة بك، في المجلد flowella-documents. أنشئ القوالب في شاشة قوالب المستندات في Flowella.

الحقل	الوصف
Document template ID (مطلوب)	معرّف القالب. انسخه باستخدام Copy ID في Settings → Document templates.
Output filename	اختياري. اسم ملف PDF. إذا تركته فارغًا، يسمي Flowella الملف باسم القالب. تتحول الأحرف غير الأحرف والأرقام والنقاط والشرطات والشرطات السفلية إلى شرطات سفلية، ويضيف Flowella `.pdf`.
HubSpot file property	اختياري. الاسم الداخلي لخاصية جهة اتصال يحفظ فيها Flowella معرّف ملف HubSpot للملف الجديد. يجب أن تكون الخاصية موجودة بالفعل.

عندما تنجح الخطوة، تُرجع هذه المخرجات:

المُخرَج	ما يحتويه
File URL	رابط مؤقت من Flowella إلى ملف PDF. يتوقف عن العمل بعد ساعة واحدة من انتهاء الخطوة. لا تحفظه في خاصية ولا تضعه في رسالة بريد إلكتروني.
HubSpot file ID	معرّف ملف PDF في ملفات HubSpot. استخدمه للعثور على الملف لاحقًا.

يحفظ Flowella ملفات PDF المُنشأة في ملفات HubSpot كملفات عامة. يمكن لأي شخص لديه رابط الملف فتحه، ويمكن لمحركات البحث فهرسته. لا تضع بيانات شخصية حساسة، مثل أرقام الهوية أو التفاصيل الصحية أو المالية، في قوالب المستندات. وتُحفظ الملفات التي ترفعها جهات الاتصال في WhatsApp Flow في ملفات HubSpot بالطريقة نفسها.

رموز الأخطاء:

رمز الخطأ	المعنى
`DOCUMENT_TEMPLATE_ID_INVALID`	Document template ID ليس معرّف قالب صالحًا.
`DOCUMENT_TEMPLATE_NOT_FOUND`	لا يوجد قالب بهذا المعرّف في مؤسستك. ربما تم حذفه.
`DOCUMENT_TOKEN_MISSING`	خاصية مستخدمة في القالب فارغة لجهة الاتصال هذه.
`DOCUMENT_TEMPLATE_INVALID`، `DOCUMENT_TEMPLATE_TOO_LARGE`	JSON الخاص بالقالب غير صالح، أو أنه كبير جدًا.
`DOCUMENT_RENDER_FAILED`	تعذّر على Flowella إنشاء ملف PDF.
`HUBSPOT_FILE_UPLOAD_FAILED`	لم يقبل HubSpot الملف.
`HUBSPOT_PATCH_FAILED`	حفظ Flowella الملف لكنه لم يتمكن من كتابة معرّفه في HubSpot file property، مثلًا لأن الخاصية غير موجودة.
`HUBSPOT_NOT_CONNECTED`	لا يستطيع Flowella الوصول إلى حساب HubSpot الخاص بك. أعد توصيل HubSpot.

رموز الأخطاء

عندما يفشل Send WhatsApp Template أو Send WhatsApp Message أو Send WhatsApp Reply، يعرض سجل سير العمل لجهة الاتصال السبب، ويحتوي مُخرَج Error code على رمز قصير. ثم يتابع سير العمل إلى الخطوة التالية.

رمز الخطأ	الإجراءات	ماذا يعني	ما يجب فعله
`CONTACT_PHONE_MISSING`	الثلاثة كلها	لا يوجد لجهة الاتصال رقم في الخاصية المربوطة أو في خصائص الهاتف التي يلجأ إليها Flowella.	أضف رقم WhatsApp لجهة الاتصال بالتنسيق الدولي.
`CONTACT_PHONE_INVALID`	الثلاثة كلها	الرقم ليس رقمًا دوليًا صالحًا، مثل رقم محلي كـ `07700 900123`.	خزّنه بالشكل `+447700900123`. راجع تنسيق رقم الهاتف.
`CONTACT_OPTED_OUT`	الثلاثة كلها	ألغت جهة الاتصال اشتراكها في الرسائل من رقمك الافتراضي.	لا تراسل جهة الاتصال. راجع إلغاء الاشتراكات.
`TEMPLATE_NOT_FOUND`	Template	لا يستطيع Flowella العثور على قالب معتمد بهذا الاسم لرقمك الافتراضي. ربما تم حذفه أو إعادة تسميته أو لم يُعتمد بعد.	اختر القالب مرة أخرى في Template Name.
`TEMPLATE_WABA_MISMATCH`	Template	ينتمي القالب إلى حساب WhatsApp Business Account مختلف عن حساب رقمك الافتراضي.	اختر قالبًا من حساب الرقم الافتراضي.
`VARIABLE_EMPTY_NO_FALLBACK`	Template	أحد المتغيرات فارغ وليس للقالب قيمة احتياطية له. تذكر رسالة الخطأ اسم المتغير.	اربط خاصية تحتوي على قيمة، أو أضف قيمة احتياطية وأكّدها. راجع Fallback values.
`DUPLICATE_TEMPLATE_SEND_SUPPRESSED`	Template	أُرسل القالب نفسه إلى رقم الهاتف نفسه خلال آخر 15 ثانية.	لا شيء. تلقى رقم الهاتف القالب مرة واحدة.
`MESSAGE_TEXT_MISSING`	Message	Message Text فارغ بعد أن يملأ HubSpot رموز البيانات.	تحقق من النص والخصائص التي تستخدمها رموزه.
`MESSAGE_BODY_MISSING`	Reply	Message body فارغ بعد أن يملأ HubSpot رموز البيانات.	تحقق من النص والخصائص التي تستخدمها رموزه.
`SESSION_CLOSED_SKIPPED`	Reply	النافذة مغلقة وSkip if window is closed محدد.	لا شيء، إذا كنت تقصد التخطي. وإلا فألغِ تحديد المربع.
`CHANNEL_NOT_FOUND`	Message، Reply	لا يوجد لدى مؤسستك رقم WhatsApp متصل.	وصّل رقمًا في Settings → WhatsApp (Meta).
`HUBSPOT_CONTACT_NOT_FOUND`	Message، Reply	تعذّر على HubSpot العثور على جهة الاتصال، مثلًا لأنها حُذفت.	تحقق من جهة الاتصال في HubSpot.
`HUBSPOT_NOT_CONNECTED`، `META_NOT_ENABLED`، `META_NOT_CONNECTED`	Message، Reply	لا يستطيع Flowella الوصول إلى حساب HubSpot الخاص بك، أو أن WhatsApp غير متصل.	أعد توصيل HubSpot في Settings → HubSpot، أو WhatsApp في Settings → WhatsApp (Meta).
يبدأ بـ `FLOWELLA_META:`	الثلاثة كلها	رفض WhatsApp الرسالة، أو أبلغ لاحقًا بأنها فشلت. يحدد الجزء الذي يلي النقطتين السبب.	راجع الجدول التالي.
`FAILED`	الثلاثة كلها	أي فشل آخر. تذكر رسالة الخطأ السبب.	اقرأ رسالة الخطأ.

عندما يكون الرمز FAILED، تخبرك رسالة الخطأ بالمزيد. على سبيل المثال:

بالنسبة لـ Send WhatsApp Template، تعرض مشكلات الإعداد الرمز الأساسي بين قوسين: “Flowella could not send this WhatsApp template (CHANNEL_NOT_FOUND). Check the workflow action inputs, then try again.”
بالنسبة لـ Send WhatsApp Reply، يعرض قالب Service غير المتاح الرسالة “Smart Reply template is not approved yet. Check Settings → Reply Templates.”
عندما يكون متغير فارغًا ولم تُؤكَّد قيمته الاحتياطية بعد، تذكر الرسالة أن القيمة الاحتياطية لم تُراجَع. أكّد القيم الاحتياطية في القالب. راجع Templates with fallbacks not reviewed.
بالنسبة لـ Send WhatsApp Message وSend WhatsApp Reply، عندما يرفض WhatsApp الرسالة فورًا، تذكر الرسالة سبب WhatsApp.

الرموز التي تبدأ بـ FLOWELLA_META:

رمز الخطأ	خطأ Meta	ماذا يعني
`FLOWELLA_META:re_engagement_required`	131047	أُغلقت نافذة 24 ساعة. راجع الخطأ 131047.
`FLOWELLA_META:message_undeliverable`	131026	تعذّر على WhatsApp تسليم الرسالة. ربما لا يستخدم الرقم WhatsApp.
`FLOWELLA_META:sender_quality_block`	131048	حظر WhatsApp الإرسال بسبب مؤشرات الجودة أو البريد العشوائي على رقمك. راجع الخطأ 131048.
`FLOWELLA_META:marketing_limit`	131049	قيّد WhatsApp الرسائل التسويقية إلى جهة الاتصال هذه. راجع التفاعل الصحي مع المنظومة.
`FLOWELLA_META:marketing_opt_out`	131050	أوقفت جهة الاتصال الرسائل التسويقية من نشاطك التجاري في WhatsApp. راجع الخطأ 131050.
`FLOWELLA_META:marketing_disabled`	131063	عمليات إرسال قوالب Marketing متوقفة لإعداد WhatsApp الخاص بك في Meta.
`FLOWELLA_META:template_classification_limit`	131064	قيّد WhatsApp الإرسال بسبب مشكلات في فئة القالب.
`FLOWELLA_META:pacing_held_dropped`	132015	احتجز WhatsApp الرسالة أثناء التحقق من الملاحظات المبكرة على القالب، ثم أسقطها لأن الملاحظات كانت سلبية.
`FLOWELLA_META:template_parameters`	132000، 132012	لا تطابق القيم المرسلة متغيرات القالب أو ترويسته أو أزراره.
`FLOWELLA_META:phone_not_registered`	133010	رقم WhatsApp الخاص بك غير مسجّل بالكامل لدى Meta.
`FLOWELLA_META:rate_limited`	حد المعدل	قيّدت Meta سرعة الإرسال. حاول مرة أخرى لاحقًا.
`FLOWELLA_META:service_unavailable`	خطأ مؤقت	واجه WhatsApp مشكلة مؤقتة. أرسل مرة أخرى لاحقًا.
`FLOWELLA_META:generic`	أخرى	رفض WhatsApp الرسالة. تتضمن رسالة الخطأ سبب WhatsApp.

للاطلاع على حلول كل رمز وأخطاء WhatsApp الأخرى، راجع رموز أخطاء WhatsApp في Flowella. ولمشكلات الاتصال والمزامنة، راجع أعطال المزامنة مع HubSpot.

تسليم المحادثات إلى HubSpot Customer Agent

Assign to Customer Agent هو إجراء سير عمل خاص بـ HubSpot، وليس جزءًا من Flowella. يسلّم المحادثة إلى Customer Agent، وكيل الذكاء الاصطناعي من HubSpot لصندوق وارد المحادثات. لا يمكن للوكيل الرد على WhatsApp إلا عند توصيل قناة Flowella المخصصة. تتبع ردود الوكيل القواعد نفسها التي يتبعها أي رد من صندوق وارد HubSpot:

نص عادي من رقمك الافتراضي. يتم تجاهل المرفقات.
داخل نافذة 24 ساعة فقط. إذا لم تراسل جهة الاتصال رقمك الافتراضي خلال آخر 24 ساعة، فلن يتم تسليم الرد. ينشر Flowella أزرار Re-engage في السلسلة، ويجب أن ينقر شخص على أحدها لإرسال قالب.
الرسائل النصية فقط. يرى الوكيل الرسائل النصية والنقرات على الأزرار والاختيارات من القوائم وملخصات Flow. ولا يرى الصور أو الرسائل الصوتية أو الفيديوهات أو المستندات.
لا يوجد مؤشر كتابة. لا يعرض Flowella حاليًا لجهة الاتصال مؤشر كتابة قبل ردود الوكيل.
تنطبق عمليات إلغاء الاشتراك. لا تتلقى جهات الاتصال التي ألغت اشتراكها ردود الوكيل.

عيّن الوكيل بينما النافذة مفتوحة، مثلًا مباشرة بعد مُشغِّل Text Reply. غالبًا ما يترك سير العمل الذي ينتظر 48 ساعة قبل تعيين الوكيل الوكيلَ غير قادر على الرد. راجع استخدام HubSpot Customer Agent مع Flowella.

أنماط سير العمل

تجمع هذه الأنماط بين مُشغِّلات Flowella وإجراءاته والخطوات الخاصة بـ HubSpot. للاطلاع على وصفات كاملة خطوة بخطوة، راجع وصفات سير العمل في HubSpot.

النمط 1: إرسال Flow وانتظار الإجابات

أرسل الـ Flow

أضف Send WhatsApp Template واختر قالبًا يحتوي على زر Flow.

انتظر الإرسال

أضف Delay until event، مضبوطة على Form Completed ومصفّاة حسب Form Name. عيّن حدًا زمنيًا.

أضف فرعًا حسب النتيجة

أضف Branch حسب ما إذا كان الحدث قد وقع في الوقت المحدد.

عالج الإجابات

إذا أرسلت جهة الاتصال، فأضف فرعًا حسب خصائص جهة الاتصال التي كتبها النموذج، ثم حدّث السجلات أو أنشئ مهام.

تابع

إذا لم ترسل جهة الاتصال، فأرسل تذكيرًا باستخدام Send WhatsApp Template أو Send WhatsApp Reply، أو أنشئ مهمة لفريقك.

النمط 2: التوجيه حسب رد جهة الاتصال

عيّن المُشغِّل

سجّل جهات الاتصال عند Text Reply.

أضف فرعًا حسب الرد

أضف فرعًا حسب Last WhatsApp reply message، مثلًا يساوي Book أو Change booking.

أرسل الـ Flow المناسب

بالنسبة لـ Book، أضف Send WhatsApp Template مع قالب Flow الحجز الخاص بك.

انتظر الإجابات

أضف Delay until event، مضبوطة على Form Completed ومصفّاة حسب Form Name، ثم أضف فرعًا حسب النتيجة.

النمط 3: الملاحظات مع متابعة

أرسل نموذج الملاحظات

أضف Send WhatsApp Template مع قالب Flow الملاحظات الخاص بك.

انتظر الاستجابة

أضف Delay until event، مضبوطة على Form Completed ومصفّاة حسب Form Name.

أضف فرعًا حسب التقييم

أضف فرعًا حسب خاصية التقييم التي كتبها النموذج:

تقييم مرتفع: اشكر جهة الاتصال باستخدام Send WhatsApp Message. فتح إرسال الـ Flow نافذة 24 ساعة جديدة.
تقييم منخفض: أنشئ مهمة لفريقك، أو استخدم Assign to Customer Agent بينما النافذة مفتوحة.

النمط 4: تسليم الردود إلى Customer Agent

عيّن المُشغِّل

سجّل جهات الاتصال عند Text Reply.

أكّد استلام الرسالة

اختياريًا، أضف Send WhatsApp Message لتأكيد استلامك رسالة جهة الاتصال.

عيّن الوكيل

أضف إجراء Assign to Customer Agent الخاص بـ HubSpot. راسلتك جهة الاتصال قبل لحظات، لذا يمكن للوكيل الرد داخل نافذة 24 ساعة.

متغيرات التاريخ والوقت

عندما تربط خاصية تاريخ أو تاريخ ووقت من HubSpot بـ Template Variable في Send WhatsApp Template، يعرضها Flowella بالشكل dd.MM.yyyy HH:mm بتوقيت UTC. على سبيل المثال، 27.06.2026 14:30.

يستخدم Flowella دائمًا توقيت UTC، وليس المنطقة الزمنية لجهة الاتصال. خلال التوقيت الصيفي البريطاني، يظهر موعد الساعة 14:30 على أنه 13:30.
تعرض خاصية التاريخ فقط 00:00 كوقت.
يتعامل Flowella مع أي رقم منفصل مكوّن من 13 خانة في متغير قالب على أنه طابع زمني. قد يظهر رقم طلب أو رقم مرجعي مكوّن من 13 خانة كتاريخ.
لا يعيد Send WhatsApp Message وSend WhatsApp Reply تنسيق التواريخ. فهما يرسلان النص كما يملؤه HubSpot.

لعرض الوقت المحلي أو تنسيق آخر، خزّن التاريخ كنص في خاصية HubSpot، مثل Tuesday 4 November, 14:30، واربط تلك الخاصية بدلًا من ذلك. راجع Dates from HubSpot.

نصائح وأفضل الممارسات

استخدم أرقام هواتف دولية. خزّن أرقام WhatsApp مع + ورمز الدولة، مثل +447700900123. يفشل الرقم المحلي مثل 07700 900123 مع CONTACT_PHONE_INVALID.

سمِّ القوالب بوضوح. تعرض قائمة Template Name الأسماء بمسافات وأحرف كبيرة. يُقرأ booking_confirmation_restaurant على أنه Booking Confirmation Restaurant، وهو أسهل في العثور عليه من template_1.

أرسل، ثم انتظر. اقرن كل عملية إرسال بخطوة Delay until event، لكي يتعامل سير العمل مع جهات الاتصال التي ترد والتي لا ترد.

اختبر مع مجموعة صغيرة أولًا. سجّل جهة اتصال تجريبية برقمك الخاص قبل تشغيل سير العمل للجميع. تحقق من المتغيرات وتنسيق رقم الهاتف وكل فرع.

نشاط جهة الاتصال

أحداث Flowella على كل جهة اتصال والخصائص التي يمكنك التصفية حسبها.

القناة المخصصة

اجلب محادثات WhatsApp إلى صندوق وارد HubSpot.

متغيرات القوالب

القيم النموذجية والقيم الاحتياطية وكيف تملأ قيم HubSpot القالب.

الردود الذكية

قوالب Service وUpdate وOffer المستخدمة خارج نافذة 24 ساعة.

وصفات سير العمل

مسارات سير عمل HubSpot خطوة بخطوة مبنية بهذه الإجراءات.

تتبع UTM والإعلانات

اعرف أي إعلان أو رابط أو رمز QR بدأ كل محادثة.

​قبل أن تبدأ

​كيف تعمل عملية الإرسال من سير العمل

​المُشغِّلات

​Form Completed (وارد)

​Text Reply (وارد)

​Message Read (صادر)

​Message Sent (صادر)

​استخدام “Delay until event” مع مُشغِّلات Flowella

​الإجراءات

​مخرجات إجراءات الإرسال

​Send WhatsApp Template

​Send WhatsApp Message

​Send WhatsApp Reply

​تتبّع النافذة في خاصية HubSpot

​AI Document Reader

​Generate Document

​رموز الأخطاء

​تسليم المحادثات إلى HubSpot Customer Agent

​أنماط سير العمل

​النمط 1: إرسال Flow وانتظار الإجابات

​النمط 2: التوجيه حسب رد جهة الاتصال

​النمط 3: الملاحظات مع متابعة

​النمط 4: تسليم الردود إلى Customer Agent

​متغيرات التاريخ والوقت

​نصائح وأفضل الممارسات

​ذات صلة

نشاط جهة الاتصال

القناة المخصصة

متغيرات القوالب

الردود الذكية

وصفات سير العمل

تتبع UTM والإعلانات

قبل أن تبدأ

كيف تعمل عملية الإرسال من سير العمل

المُشغِّلات

Form Completed (وارد)

Text Reply (وارد)

Message Read (صادر)

Message Sent (صادر)

استخدام “Delay until event” مع مُشغِّلات Flowella

الإجراءات

مخرجات إجراءات الإرسال

Send WhatsApp Template

Send WhatsApp Message

Send WhatsApp Reply

تتبّع النافذة في خاصية HubSpot

AI Document Reader

Generate Document

رموز الأخطاء

تسليم المحادثات إلى HubSpot Customer Agent

أنماط سير العمل

النمط 1: إرسال Flow وانتظار الإجابات

النمط 2: التوجيه حسب رد جهة الاتصال

النمط 3: الملاحظات مع متابعة

النمط 4: تسليم الردود إلى Customer Agent

متغيرات التاريخ والوقت

نصائح وأفضل الممارسات

ذات صلة