بدء الاستخدام

يوضح هذا المستند الخطوات والمتطلبات التي تحتاج إلى إكمالها لدمج دفق التسجيل المضمّن في موقع الويب أو بوابة العميل.

قبل البدء

لبدء دمج دفق التسجيل المضمّن، تحتاج أولاً أن يتوفر لديك مدير أعمال وإعداد تطبيق Meta.

مدير الأعمال

تحتاج إلى حساب مدير أعمال لإدارة حد الائتمان وحسابات واتساب للأعمال (WABA) الخاصة بالعملاء الذين تم تأهيلهم. لمزيد من المعلومات حول إنشاء حساب أعمال، راجع إنشاء مدير أعمال. وبمجرد إعداد مدير الأعمال، يمكنك التحقق من نشاطك التجاري.

تطبيق Meta

من خلال حساب المطوّر لديك على Meta، أنشئ تطبيقًا من النوع أعمال. ومن لوحة التطبيقات يمكنك الوصول إلى أي من تطبيقات Meta لديك للتحكم في الإعدادات وطلب الأذونات.

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

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

ستحتاج أيضًا إلى طلب الإذن whatsapp_business_messaging في API السحابة الخاصة بواتساب حيث إنه ضروري لتنفيذ استدعاءات API.

يوصى بشدة بعدم طلب أذونات إضافية بجانب هذين الإذنين، حيث إن ذلك سيؤدي إلى إبطاء عملية التسجيل بلا داعٍ.

رموز الوصول

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

موفرو الخدمات الفنية

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

إذا كنت تستخدم رمز وصول مستخدم النظام، فيجب على مستخدم النظام منح تطبيقك الإذن whatsapp_business_management.

شركاء الحلول

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

يمكنك الحصول على رمز وصول مستخدم نظام دمج الأعمال عن طريق مبادلة الرمز الذي يتم إرجاعه عندما يكمل العميل عملية التسجيل المضمّن التي تم تكوينها باستخدام تسجيل دخول فيسبوك للأعمال. إذا كنت تستخدم التسجيل المضمّن الذي تم تكوينه باستخدام تسجيل دخول فيسبوك (ولا يوصى بذلك)، فيجب استخدام رمز وصول مستخدم النظام بدلاً من ذلك.

لاحظ أنه بالنسبة إلى رموز وصول مستخدم النظام، يجب أن يكون مستخدم النظام قد منح تطبيقك الإذن whatsapp_business_management (والذي يمكنك منحه عند إنشاء الرمز)، ويجب منح مستخدم النظام دور المحرر المالي حتى يتمكن من مشاركة حد الائتمان مع العملاء الذين تم تأهيلهم.

لمنح مستخدم النظام دور المحرر المالي:

  1. قم بتسجيل الدخول إلى Meta Business Suite.
  2. حدّد حساب الأعمال في القائمة المنسدلة أعلى اليمين وانقر على أيقونة (الترس) "الإعدادات".
  3. انقر على إعدادات مدير الأعمال.
  4. انتقل إلى المستخدمون > مستخدمو النظام.
  5. قم بتعديل المستخدم ومنحه دور المحرر المالي.

حد الائتمان

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

لمعرفة معلومات حول مشاركة حد الائتمان من خلال مدير الأعمال بدلاً من API، راجع مشاركة الوصول إلى الفواتير الشهرية.

عميل API داخل المواقع الخاصة بمنصة واتساب للأعمال

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

عملية الدمج

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

1: تضمين دفق التسجيل

يمكنك إعداد مجموعة SDK للغة JavaScript في فيسبوك وتسجيل دخول فيسبوك لتضمين دفق التسجيل في موقع الويب أو بوابة العميل. لا تتردد في تضمين دفق التسجيل في عدة صفحات ويب أو بوابات تمتلكها.

2: الدمج مع نقاط النهاية المطلوبة

بعد تضمين دفق التسجيل، يمكنك إجراء الدمج مع نقاط نهاية API اللازمة لإكمال عملية الدمج. وللانتقال إلى الخطوة التالية، يجب أن تكون قادرًا على:

بمجرد اكتمال التسجيل، استخدم نقطة النهاية message_templates للحصول على مساحات اسم وقوالب رسائل معتمدة مسبقًا بحيث يمكن للأنشطة التجارية بدء إرسال الرسائل.

يجب استخدام نقطة نهاية آمنة (HTTPS). لمزيد من المعلومات، يمكنك الرجوع إلى أمان تسجيل الدخول.

3: الاشتراك في حسابات واتساب للأعمال لتلقي أحداث Webhooks‎

بمجرد اكتمال عملية التسجيل من جانب الأنشطة التجارية، يمكنك الاشتراك في كل حسابات واتساب للأعمال التي ترغب في تلقي أحداث Webhooks التابعة لها. ويمكنك إعداد أحداث webhooks بحيث يتم إرسال إشعار إليك عند:

  • تحديث اسم رقم الهاتف،
  • تحديث حالة جودة رقم الهاتف
  • مراجعة أي حساب أو تحديثه أو حظره.

اختياري

إذا أردت تنفيذ إجراءات أخرى، فيمكنك: