Skip to main content
Flowella Flows page listing HubSpot forms and their WhatsApp Flow sync status
تعرض صفحة التدفقات كل نموذج HubSpot يتتبعه Flowella لمؤسستك، وWhatsApp Flow الذي بناه Flowella من كل واحد منها، وما إذا كان هذا Flow متزامنًا مع Meta. لمعرفة كيفية إعداد تكامل HubSpot في المقام الأول، راجع إعداد HubSpot. تغطي هذه الصفحة شاشة التدفقات داخل التطبيق، وليس إعداد التكامل.
أعيدت تسمية الوحدة من النماذج إلى التدفقات في v2.6.31. لا تزال كائنات مصدر HubSpot تُسمى نماذج — تؤثر إعادة التسمية فقط على مدخل الشريط الجانبي لـ Flowella، وعنوان الصفحة، وعنوان URL. تستمر إشارات المرجعية إلى /{org}/forms في العمل: يصدر Flowella إعادة توجيه دائمة 308 إلى /{org}/flows.

​
كيفية فتحها

انتقل إلى التدفقات في التنقل الأيسر، أو:
يمكنك أيضًا فتح التدفقات محددة النطاق لقناة معينة في /{org}/{waba}/{phone}/flows. القائمة هي نفسها. يُستخدم تحديد نطاق القناة عند مزامنة Flow مع Meta.

​
ما تعرضه القائمة

يمثل كل صف نموذج HubSpot واحد. تشمل الأعمدة:
  • اسم النموذج ومعرف نموذج HubSpot مقتطع مع زر نسخ بنقرة واحدة.
  • عدد الحقول — عدد الحقول التي يمتلكها النموذج، مع علامة إذا كان أي منها غير مدعوم.
  • آخر تعديل في HubSpot — مسحوب من updatedAt الخاص بـ HubSpot حتى تتمكن من معرفة متى تغيّر تعريف النموذج نفسه.
  • حالة WhatsApp Flow — متزامن، مسودة، أو قديم (تغيّر HubSpot منذ آخر مزامنة).
  • مؤشر الانحراف — عندما يُحرَّر نموذج HubSpot منذ آخر مرة تم فيها إنشاء Flow، يعرض الصف تسمية كهرمانية تغيّر نموذج HubSpot منذ بناء هذا التدفق — قم بالمزامنة مرة أخرى لالتقاطه. شغّل مزامنة جديدة لمسحه.
  • إنشاء WhatsApp Flow / مزامنة WhatsApp Flow — الإجراء الأساسي. تتحول التسمية إلى مزامنة عند وجود Flow بالفعل وإلى قديم — تلزم المزامنة عندما يُحرَّر نموذج HubSpot منذ آخر مزامنة.
الزر معطَّل مسبقًا بتلميح عندما لا يمكن تشغيله — على سبيل المثال: HubSpot غير متصل، لا توجد قناة WhatsApp نشطة، الفوترة غير نشطة، أو يحتوي النموذج على أنواع حقول غير مدعومة. يوضح التلميح بالضبط ما هي المتطلبات الأساسية المفقودة. إذا لم يكن لحساب HubSpot الخاص بك نماذج متزامنة بعد، يقوم Flowella بـ تشغيل الكتالوج تلقائيًا في أول زيارة، حتى لا تضطر إلى تشغيل سحب أولي. يمكنك تصفية القائمة والبحث فيها للعثور على نموذج معين بسرعة. يمكنك أيضًا فرزها حسب الاسم، مضاف إلى Flowella، معدَّل في HubSpot، أو آخر مزامنة للتدفق، تصاعديًا أو تنازليًا. الفرز الافتراضي هو مضاف إلى Flowella، الأحدث أولاً. تظهر النماذج التي ليس لها تاريخ للفرز المختار في نهاية القائمة.

​
مزامنة الكتالوج في الخلفية

يحافظ Flowella على تحديث قائمة التدفقات تلقائيًا، بحيث تظهر نماذج HubSpot المضافة حديثًا أو المعاد تسميتها دون النقر على أي شيء:
  • عند فتح الصفحة، يقدم Flowella الكتالوج المخبأ فورًا ويضع مزامنة جديدة في قائمة الانتظار في الخلفية إذا كان الكتالوج أقدم من 5 دقائق.
  • كل 20 دقيقة، يعيد اجتياح خلفي مزامنة الكتالوج لكل مؤسسة يكون تكامل HubSpot الخاص بها متصلاً، بحيث تظل القوائم محدثة حتى لعلامات التبويب التي لم يفتحها أحد.
  • أثناء تشغيل مزامنة الخلفية، يعرض الرأس يتم التحديث… بجانب أيقونة التحديث. عند الانتهاء، تتحول التسمية إلى آخر مزامنة قبل دقيقتين (أو الوقت النسبي المكافئ). تُحدَّث القائمة في مكانها.
استُبدل زر التحديث من HubSpot السابق بعرض العرض الكامل بأيقونة تحديث صغيرة في رأس الصفحة. انقر عليها لفرض مزامنة خارج علامة الـ 5 دقائق — على سبيل المثال، مباشرة بعد الانتهاء من إنشاء نموذج جديد في HubSpot. نادرًا ما تحتاج إلى ذلك.

​
تفاصيل النموذج

انقر على صف لفتح صفحة تفاصيله. يعرض رأس التفاصيل نفس الإجراء الأساسي إنشاء / مزامنة WhatsApp Flow كصف القائمة، حتى لا تضطر إلى العودة لإجراء تغييرات. من صفحة التفاصيل يمكنك:
  • مراجعة التعيين حقلاً بحقل بين نموذج HubSpot وWhatsApp Flow.
  • رؤية عمليات المزامنة السابقة — متى بدأت كل واحدة، والحالة (في قائمة الانتظار، قيد التشغيل، نجح، فشل)، وأي أخطاء أعادتها Meta.
  • تشغيل مزامنة جديدة، أو إعادة المحاولة لعملية فاشلة، أو إلغاء مزامنة لا تزال قيد التقدم.
  • افتح التدفق المقابل في Meta Business Suite.
  • تحقق من أي إصدار من نموذج HubSpot تم بناء Flow المنشور منه. عندما تتم مزامنة Flow، يعرض الرأس تم بناء التدفق من نموذج HubSpot اعتبارًا من 12 سبتمبر، 14:03. قارنه بقيمة آخر تعديل في HubSpot الحالية لتقرر ما إذا كنت بحاجة إلى إعادة المزامنة.

​
مزامنة نموذج مع WhatsApp Flow

عندما تنقر إنشاء WhatsApp Flow أو مزامنة WhatsApp Flow، يقوم Flowella بـ:
  1. تشغيل فحص مسبق — يؤكد أن HubSpot متصل، والقناة النشطة موثقة، والنموذج يحتوي على حقل مدعوم واحد على الأقل، والفوترة نشطة.
  2. قراءة أحدث تعريف نموذج من HubSpot.
  3. إنشاء JSON WhatsApp Flow المكافئ.
  4. تحميله إلى Meta على القناة التي حددتها (محددة النطاق للقناة).
  5. تسجيل تشغيل المزامنة في صفحة التفاصيل ووضع طابع الوقت تم بناء التدفق من نموذج HubSpot اعتبارًا من حتى يمكن اكتشاف الانحراف في التعديلات اللاحقة.
تستغرق معظم عمليات المزامنة بضع ثوانٍ. إذا رفض Meta التدفق، يظهر سبب الفشل في صف التشغيل كـ رسالة خطأ آمنة للمستخدم (مترجمة من Meta Graph) — عادةً بسبب نوع حقل غير مدعوم، أو مشكلة توثيق على القناة، أو عدم تطابق الفئة. أعد المحاولة من نفس الصف بمجرد إصلاح السبب.

​
بوابة نطاق القناة

التدفقات هي على مستوى المؤسسة في القائمة لكنها محددة النطاق للقناة عند المزامنة — يجب تحميل Flow مقابل مزيج WABA + رقم هاتف محدد. إذا نقرت مزامنة من عنوان URL على مستوى المؤسسة ولم يستطع Flowella تحديد أي قناة يستخدم (لا توجد قنوات متصلة، أو قنوات متعددة بدون تعيين نطاق، أو جلسة قديمة عبر المؤسسات)، يبقى الزر معطَّلاً مسبقًا بتلميح يوضح ما هو مفقود. بدّل إلى القناة الصحيحة من مبدل القنوات، أو افتح /{org}/{waba}/{phone}/flows مباشرة.

​
تجربة مستخدم أخطاء المزامنة

عند فشل المزامنة، يحول Flowella صف التشغيل إلى زر إجراء مخطط واحد حتى تتمكن من الإصلاح من نفس الصف: يحمل الصف أيضًا شارة خطأ آمنة للمستخدم:
  • FLOW_SYNC_PREFLIGHT + خطأ Meta #133010 (الهاتف غير مسجل) — تعرض الشارة رسالة Meta المخزنة وتلميح تسجيل الهاتف، وليس “غير جاهز” عام. أكمل تسجيل الهاتف في الإعدادات → Meta وأعد المحاولة.
  • QUEUE_FAILED — لم تتمكن قائمة انتظار المزامنة من التقاط الوظيفة. عادة مؤقتة؛ أعد المحاولة. إذا استمر، فإن صفحة حالة المنصة هي المكان التالي للتحقق (راجع الحالة والحوادث).
  • Meta validation_errors — تلخص الشارة الحقول التي رفضتها Meta، حتى تتمكن من ضبط نموذج HubSpot (أو تعيين الحقل) وإعادة المحاولة دون مغادرة الصف.
يُحفظ سجل التشغيل عبر عمليات إعادة المحاولة، بحيث يمكنك رؤية عدد المحاولات التي أخذها النموذج وما تغيّر بينها.

​
إرسالات التدفق ترتبط بجهة اتصال HubSpot المسجلة

عند إرسال WhatsApp Flow من سير عمل HubSpot، يقوم Flowella الآن بتمرير معرف جهة اتصال HubSpot المسجلة من خلال التدفق ويتضمنه كـ hs_object_id عند كتابة الإرسال إلى HubSpot. هذا يجعل الإرسال يرتبط بجهة الاتصال بالضبط التي سجلها HubSpot — وليس سجلًا مشابهًا — حتى عندما يتطابق رقم الهاتف مع عدة جهات اتصال، ويزيل الحالة الأخيرة التي يمكن أن يعود فيها بحث هاتف HubSpot إلى السجل الخطأ. إذا كان لمؤسستك بالفعل تدفقات منشورة، أعد مزامنة كل Flow مرة واحدة حتى يتم تضمين الحقل المخفي الجديد في JSON التدفق المحمل إلى Meta:
1

افتح صفحة التدفقات

انتقل إلى التدفقات وافتح أي نموذج تم إنشاء WhatsApp Flow الخاص به قبل هذا التغيير.
2

شغّل مزامنة جديدة

انقر مزامنة WhatsApp Flow على الصف (أو الإجراء الأساسي في صفحة التفاصيل). يعيد Flowella تحميل JSON التدفق إلى Meta مع حقل معرف جهة الاتصال المخفي.
3

كرر لكل نموذج نشط

فقط النماذج المرسلة من سير عمل HubSpot تحتاج إلى ذلك. النماذج المرسلة خارج سياق سير العمل لا تتأثر.
التدفقات التي أُنشئت أو تمت مزامنتها بعد الإصلاح تتضمن الحقل بالفعل، لذا لا يلزم اتخاذ أي إجراء للتدفقات الجديدة.

​
نسخة الأسئلة في كتل النص الغني

يسمح لك HubSpot بوضع عنصر نص غني فوق مجموعة حقول بحيث يقع نص السؤال فوق المدخل بدلاً من داخل تسمية الحقل. يقوم Flowella بتعيين تلك الكتل في WhatsApp Flow جنبًا إلى جنب مع المدخلات: يظهر النص الغني قبل المدخلات في مجموعة الحقول، بحيث يرى العملاء السؤال، ثم يجيبون عليه. لا تزال تسميات الحقول معروضة في التطبيق، لذا أبقها قصيرة — راجع أفضل ممارسات تصميم النماذج.
إذا كانت لديك بالفعل نماذج HubSpot تستخدم النص الغني فوق مجموعات الحقول، أعد المزامنة من صفحة تفاصيل النموذج. التقطت عمليات المزامنة الأقدم فقط تسميات الحقول، لذا كانت نسخة سؤال النص الغني مفقودة من التدفق المنشور حتى تقوم بالمزامنة مرة أخرى.
يمكن لشاشة WhatsApp Flow أن تحمل بحد أقصى 50 مكوّنًا. في النماذج الكبيرة جدًا، يحتفظ Flowella بكل مدخل ويسقط كتل النص الغني من نهاية الشاشة للبقاء تحت السقف — لا تُزال المدخلات أبدًا، لكن قد لا تظهر بعض نسخ الأسئلة. قسّم النموذج عبر الشاشات (أو إلى نموذجين) إذا كنت بحاجة إلى ظهور كل قطعة من النسخة.

​
تنسيق شاشة الشكر

يُطبَّق نفس تعيين HTML → مكوّن التدفق الآن على نسخة الشكر على نموذج HubSpot. تنجو العناوين، والنص العريض، والمسافات غير المنقسمة، والقوائم النقطية من المزامنة بدلاً من تجريدها إلى نص عادي، ويُحفظ تذييل تم. تُقدَّم كل نقطة كسطر واحد، بحيث لا تنتج ترميز HubSpot المطبوع بشكل جميل (<p> متداخل داخل كل <li>) صفوف نقاط يتيمة على WhatsApp. لا تزال العناوين التي تزيد عن 80 حرفًا تعود إلى النص الأساسي، مثل أي مكان آخر في التدفق.
إذا تمت مزامنة نموذج قبل هذا التغيير، فإن تدفقه لا يزال يحمل نسخة الشكر بنص عادي. افتح صفحة تفاصيل النموذج وأعد المزامنة لالتقاط التنسيق الجديد.

​
بيانات نموذجية

إذا لم يكن لديك اتصال HubSpot بعد، فإن صفحة التدفقات تُعرض بـ صفوف توضيحية خلف تنبيه “بيانات نموذجية”. اربط HubSpot للتبديل إلى نماذجك الحقيقية.
لا يمكن مزامنة نماذج HubSpot بأنواع حقول غير مدعومة (تحميل الملفات، التوقيع) كما هي. اضبط النموذج في HubSpot أو تخطَ تلك الحقول في WhatsApp Flow.
يمكن أن يتم مزامنة نموذج بشكل مثالي ولا يزال يُقرأ بشكل سيء على الهاتف. تُختصر تسميات الحقول الطويلة على الشاشة، وهو أمر ملحوظ جدًا على iPhone، ونوع السؤال الخاطئ يزيد الأمر سوءًا. راجع أفضل ممارسات تصميم النماذج قبل بناء نموذج.

​
ذات صلة

إعداد HubSpot

اربط البوابة التي يقرأ منها Flowella النماذج.

تصميم النماذج

ابنِ نماذج HubSpot تُقدَّم بنظافة على كل جهاز.

إجراءات سير العمل

شغّل التدفقات من سير عمل HubSpot.

أدلة سير العمل

وصفات شاملة تجمع النماذج والقوالب وسير العمل.

فشل مزامنة HubSpot

شخص مشاكل مزامنة النماذج والإرسالات المفقودة.

متعدد القنوات

تتم مزامنة التدفقات لكل قناة — افهم تحديد النطاق.

أمان البيانات

كيف تُشفَّر إرسالات النماذج أثناء النقل وفي الراحة.
آخر تعديل في ١٩ سبتمبر ٢٠٢٦