ترحيل أرقام الهواتف بين حسابات واتساب للأعمال عبر التسجيل المُضمن
يشرح هذا المستند كيفية استخدام التسجيل المُضمن لترحيل أرقام هواتف النشاط التجاري من حساب واتساب للأعمال (WABA) إلى حساب آخر.
بإمكان العملاء ترحيل أرقام هواتف النشاط التجاري بين حسابات واتساب للأعمال (WABAs) والاحتفاظ بأسماء العرض وتقييمات الجودة وتقييدات مراسلة القالب وحالات الحساب التجاري الرسمي والقوالب المعتمدة عالية الجودة. لا يتم إجراء الترحيل عادةً إلا عندما يريد العميل نقل رقم هاتف النشاط التجاري من شريك حلول إلى شريك آخر.
لإجراء الترحيل للعميل، لديك خياران، الترحيل عبر التسجيل المُضمن أو الترحيل البرمجي.
الترحيل عبر التسجيل المُضمن هو الحل الأبسط والمفضل حيث يمكن للعملاء بدئه وينشئ تلقائيًا الملكية ويمنحها لكل الأصول الضرورية ويمنح للتطبيق إمكانية الوصول إلى هذه الأصول ويتطلب عدد أقل من استدعاءات API.
يجب بدء الترحيل البرمجي من جانبك ويتضمن المزيد من استدعاءات API، حيث يجب التحقق من تكوين الأصول التابعة بشكل صحيح وإنشاء كل الأصول المطلوبة الجديدة بذاتك وربطها بالأصول الأخرى. لهذا السبب، لا يوصى بالترحيل البرمجي إلا إذا كنت ستعمل مع عميل يستخدم نموذج الإنابة (أي ستقوم بإنشاء حساب واتساب للأعمال الوجهة وامتلاك أصوله وستشاركها مع العميل).
إذا كنت ترغب في ترحيل أرقام هواتف العميل برمجيًا، راجع مستند ترحيل الأرقام بين حسابات واتساب للأعمال برمجيًا.
طريقة العمل
بإمكان العملاء استخدام تنفيذ التسجيل المُضمن (الإصدار 2) لبدء عملية الترحيل. سيطالب التسجيل المُضمن العملاء برقم هاتف النشاط التجاري وحساب واتساب للأعمال (WABA) الوجهة الجديد.
عندما يكمل العميل الدفق، ينشئ التسجيل المُضمن حساب واتساب للأعمال الجديد ويربطه بحافظة الأعمال من Meta ويمنح للتطبيق إمكانية الوصول إلى حساب واتساب للأعمال ثم يرجع معرف حساب واتساب للأعمال الذي تم إنشاؤه حديثًا ومعرف رقم هاتف النشاط التجاري.
يجب تسجيل هذه المعرفات واستخدامها مع API لمشاركة حد الائتمان والاشتراك في أحداث webhooks وتسجيل الرقم المطلوب استخدامه مع API السحابة. بمجرد إكمال الخطوة الأخيرة (التسجيل)، ستتم إعادة ربط رقم هاتف النشاط التجاري مع حساب واتساب للأعمال الوجهة ويمكن استخدام الرقم حينها لإرسال الرسائل واستلامها مرة أخرى.
نظرًا إلى أن رقم هاتف النشاط التجاري للعميل لا يتغير، سيتم الاحتفاظ باسم العرض وتقييم الجودة وتقييد المراسلة وحالة الحساب التجاري الرسمي.
بالإضافة إلى ذلك، يتم تكرار كل القوالب المؤهلة تلقائيًا في حساب واتساب للأعمال الوجهة ويتم منحها الحالات ذاتها مثل نظائرها المصدر ويمكن متابعة استخدام كل الوسائط التي تم تحميلها على رقم هاتف النشاط التجاري للعميل.
حسابات واتساب للأعمال
ينشئ التسجيل المُضمن تلقائيًا حساب واتساب للأعمال الجديد للعميل، ويربطه بحساب الأعمال من Meta ويمنح للتطبيق إمكانية الوصول إلى حساب واتساب للأعمال.
القوالب
Templates are automatically duplicated in the destination WABA and granted the same quality ratings and statuses as their source counterparts. The duplicated templates will be subjected to Template Categorization Guidelines checks to ensure that the templates are correctly categorized. This may result in some of the duplicated templates being REJECTED.
Only templates with both a status of APPROVED and quality_score of GREEN are eligible for duplication. If the destination WABA cannot accommodate all of the new templates, we will duplicate as many as we can until the destination WABA'S template limit has been reached. Unduplicated templates must be re-created and submitted for approval if they are to be used by the destination WABA.
Please note that the quality ratings of templates will NOT be migrated. All migrated templates will start with an UNKNOWN rating. This rating will remain for the first 24 hours, after which a new rating will be generated if sufficient data is available.
الفوترة
Messages sent before migration is complete are charged to the old Solution Partner. Undelivered messages sent before migration is complete will be charged to the old Solution Partner if they are delivered after migration is complete.
Messages sent after migration is complete are charged to the new Solution Partner.
زمن توقف القالب
يتم تسجيل رقم هاتف النشاط التجاري على الفور، وبالتالي يمكنك الاستمرار في إرسال الرسائل واستقبالها من دون انقطاع.
ومع ذلك، فإن تكرار القالب يستغرق وقتًا، وبالتالي لن تتمكن من استخدام القوالب المتأثرة حتى يتم ترحيلها.
لتجنب زمن التوقف هذا، يمكنك البدء في ترحيل القالب أولاً، قبل تسجيل رقم الهاتف.
تقييدات معدلات الاستدعاء
لا يتم احتساب تكرار القالب الذي تم تشغيله تلقائيًا كجزء من عملية الترحيل ضمن تقييد معدلات الاستدعاء. ومع ذلك، يتم احتساب استدعاءات API التي تم إجراؤها ضمن التقييد.
التقييدات
- لا يمكن ترحيل أرقام هواتف الأنشطة التجارية الاختبارية الصادرة عن واتساب.
- لا يمكن تسجيل أرقام هواتف النشاط التجاري التي تم ترحيلها إلا في حالة الاستخدام مع API السحابة.
- لن يتم ترحيل سجل الرسائل والوسائط التي تم تحميلها إذا كان حساب واتساب للأعمال المصدر في API داخل المواقع.
- يجب أن يكون لأرقام هواتف العمل اسم عرض معتمدًا (
name_statusهيAPPROVED). - لا يمكن أن تحتوي أرقام هواتف العمل على أي طلبات معلقة لتغيير اسم العرض المرتبطة بها.
- لن يتم ترحيل تقييمات جودة القوالب. ستبدأ كل القوالب التي تم ترحيلها بتقييم
UNKNOWN. سيظل هذا التقييم لأول 24 ساعة، وبعد ذلك سيتم إنشاء تقييم جديد إذا توفرت بيانات كافية.
المتطلبات
العملاء
يمكنك سؤال العميل الذي يملك رقم هاتف النشاط التجاري للتأكد من استيفائه للمتطلبات التالية. يمكنه إجراء ذلك من خلال استخدام مدير الأعمال من Meta، إذا كان يملك حساب واتساب للأعمال، عن طريق الانتقال إلى حسابات واتساب > (اسم حساب واتساب للأعمال) > الإعدادات. إذا لم يملك العميل حساب واتساب للأعمال، فيجب أن يسأل موفر حلول الأعمال (BSP) للتأكيد.
- يجب أن تكون حالة حساب الأعمال من Meta تم التحقق منه.
- يجب أن تكون حالة حساب واتساب للأعمال الموجود معتمد.
- يجب أن يكون لحساب واتساب للأعمال الموجود طريقة دفع صالحة مرفقة (في إعدادات الدفع).
- يجب تعطيل التحقق بخطوتين لرقم هاتف النشاط التجاري. بإمكان العملاء الذين يملكون حساب واتساب للأعمال استخدام مدير واتساب لتعطيل التحقق بخطوتين في الرقم، بخلاف ذلك يجب مطالبة موفر الحلول بتعطيله.
موفري الحلول
يجب أن يشترك تطبيق واحد على الأقل بالفعل في أحداث webhooks في حساب واتساب للأعمال الوجهة (راجع أحداث Webhooks)، ويجب استخدام التسجيل المُضمن بالإصدار 2 مع تمكين تسجيل الجلسة.
خطوات الترحيل
الخطوة الأولى: توجيه العميل لتعطيل التحقق بخطوتين
إذا لم تقم بذلك بالفعل، فيمكنك توجيه العميل لاستخدام مدير واتساب لتعطيل التحقق بخطوتين في رقم هاتف النشاط التجاري (أو مطالبة موفر الحلول الحالي بتعطيله).
يتعذر عليك إكمال الخطوات المتبقية حتى يتم تعطيل التحقق بخطوتين.
الخطوة الثانية: عرض التسجيل المُضمن
يمكنك توجيه العميل للوصول إلى تنفيذ التسجيل المُضمن (الإصدار 2) وتقديم رقم هاتف النشاط التجاري واسم العرض عند مطالبتهم في الدفق.
الخطوة الثالثة: الحصول على معرفات الأصول
عندما يكمل العميل الدفق، احصل على معرف رقم هاتف النشاط التجاري وحساب واتساب للأعمال الجديد الذي تم إرجاعه في حدث الرسالة.
الخطوة الرابعة: مشاركة حد الائتمان
يمكنك مشاركة حد الائتمان مع حساب واتساب للأعمال تمامًا كما تفعل بشكل طبيعي بعد إعداد العميل عبر التسجيل المُضمن.
الخطوة الخامسة: الاشتراك في أحداث webhooks
يمكنك تسجيل اشتراك التطبيق في أحداث webhooks ضمن حساب واتساب للأعمال الجديد للعميل.
الخطوة السادسة: تسجيل رقم الهاتف في API السحابة
يمكنك تسجيل رقم هاتف النشاط التجاري لاستخدامه مع API السحابة (يتعذر عليك تسجيل رقم هاتف النشاط التجاري الذي تم ترحيله لاستخدامه مع API داخل المواقع).
استكشاف الأخطاء وإصلاحها
إذا فشلت عملية ترحيل القوالب، فيرجى الرجوع إلى الوثائق التالية للحصول على تعليمات حول كيفية بدء ترحيل القالب يدويًا: ترحيل القالب.