Skip to main content
Flowella forms synced from HubSpot
تعرض صفحة “النماذج” كل نموذج من نماذج “HubSpot “Flowella التي تتعقبها مؤسستك، و”WhatsApp Flow “Flowella الذي تم إنشاؤه من كل نموذج، وما إذا كان هذا “Flow” متزامنًا مع Meta . لمعرفة كيفية إعداد تكامل HubSpot في المقام الأول، راجع إعداد HubSpot . تغطي هذه الصفحة شاشة Forms داخل التطبيق، وليس إعداد التكامل.

​
كيفية فتحها

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

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

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

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

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

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

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

​
التقييد حسب نطاق القناة

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

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

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

​
ترتبط عمليات إرسال Flow بجهة الاتصال المسجَّلة في HubSpot

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

افتح صفحة النماذج

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

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

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

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

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

​
نص الأسئلة في كتل النص المنسّق

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

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

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

​

ذات الصلة

إعداد HubSpot

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

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

قم بتشغيل Flows من سير عمل HubSpot .

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

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

حالات فشل المزامنة في HubSpot

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

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

تتم مزامنة النماذج حسب القناة — فهم نطاق العمل.

أمن البيانات

كيفية تشفير عمليات إرسال النماذج أثناء النقل والتخزين.
آخر تعديل في ٨ أغسطس ٢٠٢٦