ماذا يحتوي ملف Flow JSON
يضم Flow JSON خاصيتين إلزاميتين: version وscreens. لكل شاشة معرّف id، وعنوان title اختياري يظهر في الشريط العلوي، وتخطيط layout من نوع SingleColumnLayout تضم عناصره children المكوّنات: النصوص وحقول الإدخال وقوائم الاختيار ومنتقي التاريخ والموافقات وزر Footer واحد.
يتم التنقل عبر الإجراءات. زر Footer مع navigate يفتح الشاشة التالية، وفي الشاشة الأخيرة المعلَّمة بأنها terminal يغلق Footer مع complete الـ Flow ويرسل البيانات إلى الشركة مع رمز flow token. منذ الإصدار 4.0 من Flow JSON يمكن لأي شاشة قراءة حقول شاشة سابقة عبر ${screen.SCREEN_ID.form.field}، لذلك تبقى بيانات navigate فارغة في القوالب وتُجمع كل الإجابات في بيانات complete النهائية.
- version: إصدار Flow JSON، وهو «7.3» في كل القوالب.
- screens: قائمة الشاشات بالترتيب، وأول شاشة بلا مسار وارد هي شاشة البداية.
- routing_model وdata_api_version: فقط للـ Flows التي تتصل بنقطة البيانات الخاصة بك.
- terminal وsuccess: تحددان الشاشة الأخيرة وما إذا كان الإنهاء فيها يُعد نجاحًا.
Flows مع نقطة بيانات أو من دونها
القوالب الاثنا عشر كلها تعمل دون نقطة بيانات (endpoint). لا تحتاج إلى خادم: الخيارات مكتوبة داخل JSON، وتنشئ ميتا نموذج التوجيه، وتصلك الإجابات على الـ webhook عندما يُكمل العميل الـ Flow. توصي ميتا بهذا النوع كلما لم تكن هناك حاجة إلى بيانات مباشرة، لأنه يفتح أسرع ويُبنى في وقت أقل.
أضف نقطة بيانات عندما تعتمد الشاشة على بيانات مباشرة: المواعيد المتاحة، أو سعر متغير، أو المخزون، أو التحقق من حساب العميل. عندها تستخدم الشاشات data_exchange، ويحتاج الـ Flow إلى data_api_version وrouting_model، ويجب أن تفك نقطة البيانات تشفير كل طلب وترد خلال المهلة التي تحددها ميتا. وهذا هو الجزء الذي نبنيه ونستضيفه لعملائنا.
حدود الأحرف وقواعد المكوّنات
أغلب الـ Flows المرفوضة تتعثر بقواعد صغيرة. التسميات قصيرة: 20 حرفًا لحقل النص ومنطقة النص والقائمة المنسدلة، و30 لمجموعات الاختيار الفردي والمتعدد، و40 لمنتقي التاريخ، و35 لزر الـ Footer. عنوان الخيار حتى 30 حرفًا والوصف حتى 300. ويتسع العنوان الرئيسي لـ 80 حرفًا والنص لـ 4096 حرفًا.
في كل شاشة يمكنك استخدام 50 مكوّنًا كحد أقصى، وFooter واحد، ورابطين مضمّنين، وثلاث صور، وخمس موافقات. معرّفات الشاشات تقبل الحروف اللاتينية والشرطة السفلية فقط، وكلمة SUCCESS محجوزة. أما التسميات العربية فتُحسب بالأحرف لا بالبايت، فالتسمية العربية ذات 20 حرفًا مقبولة. تفحص أداة التحقق كل ذلك وتحدد الشاشة التي تحتاج إلى تصحيح.
Flows عربية من اليمين إلى اليسار لعملاء الخليج
لكل قالب نسخة عربية أصلية بالشاشات وأسماء الحقول نفسها، فيتعامل كود الـ webhook مع اللغتين دون أي تعديل. يعرض واتساب الـ Flows العربية من اليمين إلى اليسار على هاتف العميل، والمعاينة تعرضها بالاتجاه نفسه.
تضم المكتبة حالات استخدام مهمة في الخليج: الاشتراك في عروض رمضان والعيد مع إرسال الرسائل بعد الإفطار، ونموذج حجز واتساب لطاولات المطاعم، وطلبات معاينة العقارات، وقائمة مستندات اعرف عميلك التي تطلب من العميل عدم إرسال صور الهوية في المحادثة.
كيف ترسل الـ Flow إلى عملائك
بعد نشر الـ Flow، أرسله في رسالة تفاعلية من نوع flow تتضمن معرّف Flow ID ورمز flow token تنشئه بنفسك ونص زر قصيرًا والشاشة الأولى. توفر المكتبة بيانات الرسالة لكل قالب. لا تعمل الرسائل التفاعلية إلا داخل نافذة خدمة العملاء البالغة 24 ساعة، وإذا أردت أن تبدأ أنت المحادثة فاربط الـ Flow بقالب رسالة معتمد يحتوي على زر Flow.
عندما ينتهي العميل، يعرض له واتساب ملخصًا لإجاباته وتصلك بيانات complete على الـ webhook. أرسل له رسالة تأكيد توضح الخطوة التالية وطريقة التعديل أو الإلغاء.
