الترحيل من API السحابة إلى API داخل المواقع

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

لاحظ أن ترحيل رقم هاتف النشاط التجاري من API إلى أخرى لا يشبه عملية ترحيل رقم الهاتف من حساب واتساب للأعمال (WABA) إلى آخر.

لا يؤثر الترحيل على ما يلي:

• اسم عرض رقم هاتف النشاط التجاري أو حالة التحقق أو تقييم الجودة
• القوالب المستخدمة بواسطة رقم هاتف النشاط التجاري أو حالاتها
• حساب واتساب للأعمال المالك أو حالة الحساب التجاري الرسمي أو تقييد المراسلة

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

أفضل الممارسات

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

نوصي أيضًا بإجراء الترحيل عندما يكون عدد زيارات النشر في API داخل المواقع منخفضًا.

اختلافات API

تأكد من قدرة التطبيق على معالجة هذه الاختلافات قبل بدء عملية الترحيل.

Webhooks

تختلف بنيات حمولة بيانات أحداث webhooks في API السحابة وAPI إدارة الأعمال عن بنيات حمولة بيانات API داخل المواقع. نوصي بإنشاء نقطة نهاية webhook جديدة يمكنها التعامل مع أحداث webhooks في API داخل المواقع بشكل حصري.

يرجى الرجوع إلى المستندات التالية لمساعدتك في فهم اختلافات الحمولة:

• التكوين: أحداث Webhooks لواتساب
• حمولات بيانات حدث webhook في API السحابة: مرجع حمولة بيانات إشعار أحداث Webhooks
• حمولات بيانات حدث webhook في API إدارة الأعمال: إعداد أحداث Webhooks

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

الوسائط

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

رموز الأخطاء

تختلف رموز الأخطاء في API السحابة وAPI إدارة الأعمال عن رموز الأخطاء في API داخل المواقع. راجع المستندات التالية:

• رموز الأخطاء في API السحابة
• رموز الأخطاء في API إدارة الأعمال

رسائل الضغط للتحدث

تتعرف الواجهة داخل المواقع على رسائل الضغط للتحدث (PTT) في أحداث webhooks عن طريق تعيين messages.type على voice، ولكن تتعرف API السحابة على رسائل PTT عن طريق تعيين messages.audio.voice على true.

زمن التوقف

يبدأ زمن التوقف بمجرد تنفيذ خطوة التسجيل (الخطوة الثالثة) ومن المفترض أن يستمر لبضع ثوانٍ فقط. أثناء هذا الوقت، سيتم تجاهل الرسائل المرسلة إلى الرقم من مستخدمي واتساب.

نوصي بشدة بجدولة الترحيل في وقت يكون نشاط الرقم فيه منخفضًا، لتقليل أي تأثير في زمن التوقف.

الخطوة الأولى: دمج API داخل المواقع

نظرًا لأنك تقوم بترحيل رقم هاتف النشاط التجاري إلى API داخل المواقع، تأكد من أن تطبيقك يمكنه استخدام API داخل المواقع بنجاح وأن حساب واتساب للأعمال المرتبط برقم هاتف النشاط التجاري قد تم تكوين أحداث webhooks لديه بشكل صحيح.

الخطوة الثانية: الاستعداد للترحيل

نوصي بالتوقف عن إرسال الرسائل أثناء إكمال عملية الترحيل.

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

الخطوة الثالثة: تسجيل عميل API

يمكنك تسجيل رقم هاتف النشاط التجاري في عميل API داخل المواقع. لإجراء ذلك، يمكنك استدعاء نقطة النهاية /account:

POST /v1/account

{
    "cc": "COUNTRY_CODE",
    "phone_number": "PHONE_NUMBER_WITHOUT_COUNTRY_CODE",
    "method": "sms" or "voice",
    "cert": "VERIFIED_NAME_CERT_IN_BASE64",
    "pin": "EXISTING_6_DIGIT_PIN" # required if two-step verification is enabled
}

راجع كل الحقول المتوفرة لنقطة النهاية هذه هنا.

بمجرد اكتمال التسجيل، سيكون عميل API داخل المواقع هو الطرف الذي يتلقى الرسائل.

الخطوة الرابعة: تعيين الأقسام

بمجرد تسجيل العميل، يمكنك تعيين الأقسام إذا لزم الأمر.

الخطوة الخامسة: بدء إرسال الرسائل

أصبحت مستعدًا الآن لإرسال الرسائل إلى العملاء. راجع دلائل إرسال الرسائل للحصول على الإرشادات.