بناء تدفق بيانات ديناميكي في WhatsApp
ابنِ تدفق بيانات WhatsApp الديناميكي في ChatMaxima بقوائم متسلسلة ومترابطة تُملأ مباشرةً من واجهة برمجة التطبيقات لديك، مثل الفئة ثم المنتج أو الطبيب ثم التاريخ ثم الوقت.
نظرة عامة
تدفق البيانات الديناميكي هو تدفق WhatsApp تُملأ قوائمه مباشرةً من واجهة برمجة التطبيقات الخاصة بك. كل خطوة هي قائمة، واختيار العميل في خطوة ما يحدد ما تعرضه الخطوة التالية. يرشد التدفق العميل عبر سلسلة من الاختيارات المترابطة.
أمثلة نموذجية:
- الرعاية الصحية - الطبيب، ثم التاريخ المتاح، ثم الفترة الزمنية المتاحة.
- التجارة الإلكترونية - الفئة، ثم المنتج.
- الخدمات - الفرع، ثم الخدمة، ثم الموظف.
على عكس مُنشئ النماذج، لا تُدخل الخيارات يدوياً. عندما ينتقل العميل إلى الشاشة التالية، يستدعي WhatsApp نقطة نهاية آمنة في ChatMaxima، التي تستدعي واجهة برمجة التطبيقات الخاصة بك وتعيد القائمة التالية. لا شيء مُثبّت برمجياً، لذا يعمل التدفق نفسه مع أي سلسلة من الخطوات تحددها.
كيف يعمل
- يفتح العميل التدفق ويرى قائمة الخطوة الأولى.
- يقوم باختيار.
- يرسل WhatsApp ذلك الاختيار إلى نقطة نهاية ChatMaxima المشفّرة.
- يستدعي ChatMaxima واجهة برمجة التطبيقات الخاصة بك للخطوة التالية، ممرراً الاختيارات السابقة.
- تظهر القائمة التالية. يتكرر هذا حتى شاشة الملخص النهائية.
المتطلبات المسبقة
قبل أن تبدأ، تأكد من توفر:
- حساب WhatsApp مرتبط - رقم WhatsApp Cloud API مرتبط بـ ChatMaxima.
- واجهة برمجة تطبيقات لكل خطوة - نقطة نهاية HTTPS تعيد قائمة JSON من الخيارات.
- إعداد مفتاح التشفير - إعداد لمرة واحدة لكل حساب WhatsApp، موضّح أدناه.
ملاحظة: تدفقات البيانات الديناميكية مدفوعة بنقطة النهاية، لذا يتطلب WhatsApp مفتاح تشفير. يجب عليك إكمال إعداد التشفير قبل أن تتمكن من حفظ تدفق ديناميكي.
الخطوة 1: ابدأ تدفق بيانات ديناميكياً
- اذهب إلى الحملات ثم تدفقات WhatsApp وانقر على إنشاء تدفق.
- أدخل اسم تدفق واختر فئة.
- اضبط نوع التدفق على تدفق بيانات ديناميكي.
ينتقل المُنشئ إلى عرض الخطوات الديناميكية.
الخطوة 2: إعداد مفتاح التشفير
يستدعي تدفق البيانات الديناميكي نقطة نهاية ChatMaxima لكل شاشة، ويتطلب WhatsApp أن تكون تلك القناة مشفّرة.
- في بطاقة تشفير نقطة النهاية، انقر على إعداد مفتاح التشفير.
- يُنشئ ChatMaxima زوج مفاتيح RSA للحساب ويرفع المفتاح العام إلى Meta تلقائياً.
هذا إجراء لمرة واحدة لكل حساب WhatsApp. يعيد كل تدفق ديناميكي على ذلك الحساب استخدام المفتاح نفسه.
الخطوة 3: إضافة الخطوات
كل خطوة هي قائمة مترابطة واحدة. انقر على إضافة خطوة واملأ محرر الخطوة.
حقول الخطوة
| الحقل | الوصف |
|---|---|
| عنوان الخطوة | عنوان الشاشة، على سبيل المثال Select a Category |
| مفتاح الخطوة | معرّف بأحرف صغيرة، على سبيل المثال category، يُشار إليه لاحقاً بـ {category} |
| تسمية القائمة | التسمية المعروضة فوق القائمة |
| طريقة HTTP | GET أو POST لاستدعاء واجهة برمجة التطبيقات |
| رابط واجهة برمجة التطبيقات | نقطة النهاية التي تعيد خيارات هذه الخطوة |
| المصادقة | بلا، أو رمز Bearer، أو المصادقة الأساسية، أو ترويسة مخصصة |
تمرير الاختيارات السابقة
لجعل خطوة لاحقة تعتمد على خطوة سابقة، ضع مفتاح الخطوة السابقة في رابط واجهة برمجة التطبيقات الخاص بها كعنصر نائب. يستبدله ChatMaxima باختيار العميل أثناء التشغيل.
https://api.example.com/products?category={category}في هذا المثال، يدرج رابط خطوة product قيمة category المختارة.
الخطوة 4: ربط استجابة واجهة برمجة التطبيقات
يخبر قسم ربط الاستجابة في محرر الخطوة ChatMaxima بكيفية قراءة JSON الخاص بواجهة برمجة التطبيقات لديك.
| الحقل | الوصف |
|---|---|
| مسار القائمة | المسار إلى المصفوفة في الاستجابة، على سبيل المثال data. اتركه فارغاً إذا كانت الاستجابة مصفوفة بالفعل |
| حقل المعرّف | الحقل المستخدم كقيمة للخيار، على سبيل المثال id |
| حقل العنوان | الحقل المعروض كنص رئيسي للخيار، على سبيل المثال name |
| حقل الوصف | سطر ثانوي اختياري، على سبيل المثال price |
تُدعم العلامة النقطية للحقول المتداخلة، مثل price.amount.
الخطوة 5: الحفظ والنشر
- انقر على حفظ التدفق الديناميكي. يُنشئ ChatMaxima شاشات تدفق WhatsApp من خطواتك ويرفعها.
- افتح المسودة المحفوظة وانقر على نشر.
الشاشة النهائية هي ملخص يلخص كل اختيار قبل أن يؤكد العميل.
أفضل الممارسات
- استخدم مفاتيح خطوات واضحة - قصيرة وبأحرف صغيرة وذات معنى، لأنها تظهر في الروابط.
- أعد قوائم صغيرة - تعمل قوائم WhatsApp بشكل أفضل مع مجموعة مركّزة من الخيارات.
- رتّب الخطوات من العام إلى المحدد - على سبيل المثال الفئة قبل المنتج.
- اختبر كل واجهة برمجة تطبيقات - تأكد من أن كل نقطة نهاية تعيد JSON المتوقع قبل الحفظ.
استكشاف الأخطاء وإصلاحها
يفشل الحفظ ويطلب مفتاح التشفير
- افتح بطاقة تشفير نقطة النهاية.
- انقر على إعداد مفتاح التشفير وانتظر التأكيد.
- احفظ التدفق الديناميكي مرة أخرى.
تظهر خطوة بقائمة فارغة
- تحقق من أن رابط واجهة برمجة التطبيقات صحيح ويمكن الوصول إليه عبر HTTPS.
- تحقق من أن مسار القائمة وحقل المعرّف وحقل العنوان تطابق JSON الخاص بواجهة برمجة التطبيقات لديك.
- تأكد من أن أي
{placeholder}في الرابط يطابق مفتاح خطوة سابقة.
لا تستطيع خطوة الوصول إلى واجهة برمجة التطبيقات
- يجب أن تكون واجهة برمجة التطبيقات نقطة نهاية HTTPS عامة. العناوين الداخلية أو الخاصة محظورة لأسباب أمنية.
- تحقق من صحة تفاصيل المصادقة.