هل هذه المادة مفيدة؟

كيف أبلينا؟

مشكلة مع النظام الأساسي؟ تواصل مع فريق الدعم هنا.

جدول المحتويات

ترحيل رقم الهاتف إلى WhatsApp Cloud API

Joshua Lim محدث بواسطة Joshua Lim

فوائد الترحيل إلى WhatsApp Cloud API

WhatsApp Cloud API عبارة عن نظام أساسي جديد يوفر للشركات اتصالاً مباشرًا بالبنية التحتية لـ WhatsApp وهو خيار خدمة ذاتية مقارنة بالمرور عبر شركاء WhatsApp (BSPs). بعض فوائد استخدام WhatsApp Cloud API هي:

  • خيار أكثر فعالية من حيث التكلفة.
  • اتصال أكثر موثوقية واستقرارًا بالمنصة.
  • القدرة على إنشاء عمليات تكامل مخصصة تناسب احتياجات عملك المحددة.
  • حل مرن وقابل للتطوير للشركات من جميع الأحجام.
تعرف على المزيد حول WhatsApp Cloud API هنا .

ماذا سيتم ترحيله؟

لاحظ أنه يمكن ترحيل العناصر التالية من WhatsApp BSP إلى WhatsApp Cloud API.

يمكن ترحيلها

  • رقم الهاتف المرتبط بالحساب.
  • أي قوالب رسائل عالية الجودة تمت الموافقة عليها مسبقًا.
  • عرض اسم رقم الهاتف.
  • تصنيف جودة رقم الهاتف.
  • حدود المراسلة.
  • وضع WABA الرسمي.

لا يمكن ترحيلها

  • قوالب رسائل منخفضة الجودة أو مرفوضة أو معلقة.

متطلبات ما قبل الترحيل: ما يجب التحضير لإعداد الترحيل الخاص بك

قم بتدوين العبارات التي سيتم استخدامها بشكل متكرر في هذا المستند:
- المصدر WABA : WhatsApp BSP الذي نرحل منه.
- الوجهة WABA : واجهة برمجة تطبيقات WhatsApp Cloud التي نرحل إليها.

قائمة التحقق من متطلبات ما قبل الترحيل:

  • تطبيق Meta Developer الحالي: إذا لم يكن لديك تطبيق مطور تم إنشاؤه ، فانقر هنا لإنشاء تطبيقك في Meta Business Manager (MBM) وابدأ في استخدام WhatsApp Cloud API. يجب إنشاء هذا التطبيق تحت نفس حساب الأعمال (معرف العمل) مثل WABA المصدر.
  • معرف العمل: يجب أن يقترن المصدر والوجهة WABA بنفس MBM أو أن يكون لهما نفس معرف العمل.
  • التحقق من العمل: يجب التحقق من معرف النشاط التجاري. إذا لم يتم التحقق من عملك بعد ، فاتبع هذه الخطوات للتحقق منه .
  • حالة مراجعة WABA : يجب الموافقة على حالة مراجعة المصدر والوجهة لـ WABA.
  • طريقة الدفع : يجب تكوين طريقة الدفع لكل من المصدر والوجهة WABA. تأكد من إعداد طريقة الدفع في كل من المصدر والوجهة.
  • التحقق بخطوتين : يجب تعطيل التحقق بخطوتين على رقم الهاتف الذي يتم ترحيله.
عندما يتم التحقق من كل ما سبق واكتماله ، يمكن أن تستمر عملية الترحيل.

تكوين أرقام الهواتف ومعرفات WABA

صممت Meta معرفات WABA بحيث لا يمكن ترحيلها. نظرًا لقيود معينة ، تم تنفيذ حل بديل كحل. لترحيل أرقام الهواتف ، يجب أن تكون معرفات WABA المصدر والوجهة تحت نفس حساب Meta business manager. هذا يعني أن ترحيل رقم الهاتف سيؤدي فقط إلى نقل هذا الرقم بين WABA ولن يسمح بأي تغييرات أخرى. لترحيل رقم هاتف بنجاح ، يجب تنفيذ الخطوات التالية:

  • أضف رقمًا جديدًا إلى الوجهة WABA : سيؤدي هذا إلى إنشاء معرف WABA جديد للرقم الذي ترغب في الترحيل إليه. يمكنك تخطي هذه الخطوة إذا كان لديك WABA موجود برقم لم يعد مستخدمًا.
  • احذف الرقم الجديد من الوجهة WABA : سيؤدي هذا إلى إخلاء مكان لإضافته إلى الوجهة WABA. بدلاً من ذلك ، إذا كان لديك رقم حالي غير مستخدم ، فيمكنك حذف هذا الرقم.
بمجرد حذف الرقم ، تابع ترحيل الرقم الحالي للعميل إلى أعمال WhatsApp الجديدة.

وثائق API لعملية الترحيل

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

الخطوة 1: ابدأ ترحيل رقم الهاتف

عاود الاتصال بالعنوان:
 POST <https://graph.facebook.com/{version}/{wabaId}/phone_numbers>

اسم

في

مطلوب

يكتب

وصف

إصدار

طريق

حقيقي

خيط

إصدار API.

wabaId

طريق

حقيقي

خيط

معرف WhatsApp Cloud API WABA.

انتقل إلى Business Manager> Business Settings> Accounts> WhatsApp Business Accounts للعثور على معرف حساب WhatsApp Business. حدد الحساب الذي تريد استخدامه. ستظهر لوحة تحتوي على معلومات الحساب ، بما في ذلك المعرّف.
حدود

رأس

Authorization: Bearer {Access Token}

يقوم مستخدم النظام بإنشاء رمز الوصول الخاص بك في علامة التبويب حسابات الأعمال في WhatsApp في Business Manager. اقرأ هذا الدليل للتعرف على كيفية الوصول إلى مستخدم النظام وإنشاء واحد أو نسخه.

جسم

اسم

يكتب

وصف

cc

الأس

رمز البلد الرقمي لرقم الهاتف الجاري تسجيله.

ملاحظة: علامة الجمع (+) ليست ضرورية لرمز الدولة.

phone_number

الأس

يتم ترحيل رقم الهاتف ، بدون رمز البلد أو رمز الجمع (+).

migrate_phone_number

قيمة منطقية

اضبط على صواب لترحيل رقم الهاتف.

حالة

اسم

وصف

200 جيد

نجاح.

إجابة

 {
"id": "phoneNumberId"
}

الخطوة 2: طلب رمز (PIN) للتحقق من ملكية الهاتف

عاود الاتصال بالعنوان
 POST <https://graph.facebook.com/{version}/{phoneNumberId}/request_code>

اسم

في

مطلوب

يكتب

وصف

إصدار

طريق

حقيقي

خيط

إصدار API.

رقم الهاتف

طريق

حقيقي

خيط

هذا هو الرد الذي تم إرجاعه في الخطوة 1. انسخ الرقم والصقه في عنوان URL لمعاودة الاتصال في هذه الخطوة.

حدود

رأس

Authorization: Bearer {Access Token}

جسم

اسم

يكتب

وصف

code_method

تعداد

طريقة استلام كود التسجيل. القيم المدعومة: الرسائل القصيرة والصوت.

language

تعداد

اللغة التي تريد استلام رمز التسجيل بها. انظر رموز اللغة .

حالة

اسم

وصف

200 جيد

نجاح.

إجابة

 {
"success": true
}
تم إرسال الرمز إلى رقم الهاتف الذي يتم ترحيله عبر الطريقة المحددة (الرسائل القصيرة أو الصوت).

الخطوة 3: تحقق من الرمز

عاود الاتصال بالعنوان
 POST: <https://graph.facebook.com/{version}/{phoneNumberId}/verify_code>
سيتم استخدام الرمز (رقم التعريف الشخصي المكون من 6 أرقام) الذي تم استلامه في رقم الهاتف من الخطوة 2 للتحقق من الملكية.
حدود

رأس

Authorization: Bearer {Access Token}

جسم

اسم

يكتب

وصف

code

الأس

تم استلام رمز التسجيل المكون من 6 أرقام بعد إكمال الخطوة 2.

حالة

اسم

وصف

200 جيد

نجاح.

إجابة

 {
"success": true
}
يؤكد أنه تم التحقق من ملكية الهاتف.

الخطوة 4: تسجيل رقم الهاتف

عاود الاتصال بالعنوان
 POST <https://graph.facebook.com/{version}/{phoneNumberId}/register>
حدود

رأس

Authorization: Bearer {Access Token}

جسم

اسم

يكتب

وصف

messaging_product

تعداد

تم استخدام خدمة الرسائل. في هذه الحالة ، استخدم "whatsapp".

pin

الأس

تم استلام رمز التسجيل المكون من 6 أرقام بعد الخطوة 2.

حالة

اسم

وصف

200 جيد

نجاح.

إجابة

 {
"success": true
}
تم تسجيل رقم الهاتف بنجاح في WhatsApp Cloud API WABA. يمكنك الآن إرسال رسائل إلى وجهتك WABA.
لم يتم ترحيل معرف WABA. سيتم ربط الرقم الذي تم ترحيله حديثًا بمعرف WABA للرقم الذي تم حذفه مسبقًا.

الخطوة 5: تحقق من رقم الهاتف الذي تم ترحيله في تطبيق Meta Developer

يمكن التحقق من عملية الترحيل الناجحة من خلال تطبيق Meta Developer. لكي تفعل هذا، اتبع هذه الخطوات:

  1. انتقل إلى WhatsApp > البدء
  2. في القائمة المنسدلة لرقم الهاتف ، تأكد من وجود الرقم وانعكاسه بدقة.

يشعر بالضيق؟ لا تخف.

احتاج مساعدة؟ اتصل بنا للحصول على الدعم. المساعدة هنا!

Vonage WhatsApp

ليس ما كنت تبحث عنه؟

تحدث إلى خبير هنا!

اتصل بنا
Powered by HelpDocs (opens in a new tab)

Powered by HelpDocs (opens in a new tab)