respond-io
New
🚀 TikTok Business Messaging مباشرة! تحويل المحادثات إلى تحويلات بسلاسة. اعرف المزيد.
arrow-icon

الصفحة الرئيسية >

القنوات >
WhatsApp >
نقل رقم الهاتف إلى واتسآب Cloud API

نقل رقم الهاتف إلى واتسآب Cloud API

Avatar
Joshua Lim
· 04 Apr 2025
less than a minute read

فوائد الهجرة إلى واجهة برمجة التطبيقات السحابية لواتساب.

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

  • خيار أكثر فعالية من حيث التكلفة.

  • اتصال أكثر موثوقية واستقراراً بالمنصة.

  • القدرة على بناء تكاملات مخصصة تناسب احتياجاتك التجارية المحددة.

  • حل مرن وقابل للتوسع للأعمال التجارية من جميع الأحجام.

تعرف على المزيد حول واتسآب Cloud API هنا.

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

يرجى ملاحظة أنه يمكن ترحيل العناصر التالية من WhatsApp BSP إلى واجهة برمجة التطبيقات السحابية لواتساب.

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

  • رقم الهاتف المرتبط بالحساب.

  • أي قوالب رسائل عالية الجودة تم الموافقة عليها مسبقًا.

  • اسم العرض لرقم الهاتف.

  • تقييم جودة رقم الهاتف.

  • حدود الرسائل.

  • الحالة الرسمية للـ WABA.

لا يمكن ترحيل

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

متطلبات ما قبل الهجرة: ما تحتاج إلى إعداده لنقل بياناتك.

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

قائمة متطلبات ما قبل الهجرة:

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

  • معرف الأعمال التجارية: يجب أن يرتبط المصدر والوجهة بنفس MBM أو أن يكون لها نفس معرف الأعمال.

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

  • WABA Review Status: يجب الموافقة على حالة مراجعة المصدر والوجهة .

  • يجب تكوين طريقة الدفع لـ WABA المصدر والوجهة. تأكد من أن طريقة الدفع يتم وضعها في كل من المصدر والمقصد.

  • يجب تعطيل التحقق بخطوتين على رقم الهاتف الذي يتم ترحيله.

وعندما يتم التحقق من كل ما سبق وإنجازه، يمكن أن تستمر عملية الهجرة.

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

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

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

تعرف على المزيد حول توصيل أرقام الهواتف بـ WhatsApp Cloud API هنا.

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

بمجرد حذف الرقم ، انتقل إلى ترحيل الرقم الحالي للعميل إلى الواحة الجديدة.

وثائق API لعملية الهجرة

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

الخطوة 1: بدء نقل رقم الهاتف

Callback URL:

منشور <https://graph.facebook.com/{version}/{wabaId}/phone\_numbers>.

الاسم

في

مطلوب

نوع

الوصف

الإصدار

المسار

صحيح

سلسلة

إصدار API.

وابايد

المسار

صحيح

سلسلة

معرف واجهة برمجة تطبيقات الواتساب السحابية.

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

البارامترات

رأس الصفحة

تفويض: حامل {Access Token}.

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

الجسم

الاسم

نوع

الوصف

cc

num

رمز البلد الرقمي لرقم الهاتف قيد التسجيل.ملاحظة: علامة بلس (+) ليست مطلوبة لرمز البلد.

رقم_الهاتف

num

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

تحويل_الهاتف_رقم

boolean

تعيين إلى "صواب" لترحيل رقم الهاتف.

الحالة

الاسم

الوصف

200 موافق

نجاح.

الاستجابات

{  
    "id": "phoneNumberId"  
}

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

معاودة الاتصال بعنوان ويب

منشور <https://graph.facebook.com/{version}/{phoneNumberId}/request\_code>

الاسم

في

مطلوب

نوع

الوصف

الإصدار

المسار

صحيح

سلسلة

إصدار API.

رقم هاتف المستلم.

المسار

صحيح

سلسلة

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

البارامترات

رأس الصفحة

التفويض: حامل {Access Token}

الجسم

الاسم

نوع

الوصف

طريقة الكود.

enum.

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

اللغة

enum.

اللغة التي تريد أن تتلقى بها رمز التسجيل. راجع رموز اللغة.

الحالة

الاسم

الوصف

200 موافق

نجاح.

الاستجابات

{  
    "النجاح": true  
}

تم إرسال الرمز إلى رقم الهاتف الذي يتم نقله عبر الطريقة المحددة (SMS أو صوت).

الخطوة 3: التحقق من الكود

معاودة الاتصال بعنوان ويب

التدوينة: <https://graph.facebook.com/{version}/{phoneNumberId}/verify\_code>

سيتم استخدام الرمز (رقم الدبوس المكون من 6 أرقام) المستلم في رقم الهاتف من الخطوة 2 للتحقق من الملكية.

البارامترات

رأس الصفحة

التفويض: حامل {Access Token}

الجسم

الاسم

نوع

الوصف

الكود

num

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

الحالة

الاسم

الوصف

200 موافق

نجاح.

الاستجابات

{  
    "النجاح": true  
}

يؤكد أنه تم التحقق من ملكية الهاتف.

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

معاودة الاتصال بعنوان ويب

منشور <https://graph.facebook.com/{version}/{phoneNumberId}/register>

البارامترات

رأس الصفحة

التفويض: حامل {Access Token}

الجسم

الاسم

نوع

الوصف

رسالة_المنتج.

enum.

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

دبوس

رقم

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

الحالة

الاسم

الوصف

200 موافق

نجاح.

الاستجابات

{  
    "النجاح": true  
}

تم تسجيل رقم الهاتف بنجاح في واجهة برمجة تطبيقات واتسآب السحابية WABA. يمكنك الآن إرسال رسائل إلى WABA الوجهة الخاصة بك.

لم يتم ترحيل معرف WABA. الرقم المنقول حديثاً سوف يرتبط بمعرف WABA الخاص بالرقم المحذوف سابقاً.

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

يمكن التحقق من الترحيل الناجح من خلال تطبيق مطوري ميتا. وللقيام بذلك، ينبغي اتخاذ الخطوات التالية:

  1. انتقل إلى WhatsApp > بدأ

  2. في قائمة أرقام الهاتف المنسدلة، تأكد من أن الرقم موجود ويعكس بدقة.

مشاركة هذه المقالة
Telegram
Facebook
Linkedin
Twitter

المقالات ذات الصلة 👩‍💻

البدء السريع لمنصة واتساب للأعمال (API)
احصل على حساب API الخاص بـ WhatsApp Business بسرعة لبدء الدردشة مع عملائك.
التعايش عبر واتساب
تعرف على كيفية ربط تطبيق WhatsApp Business بـ response.io لتسهيل المراسلة والأتمتة.
جاهز للمحادثات الواردة
تعرف على نوافذ المحادثة، إرسال قوالب الرسائل وإعداد نقطة دخول بسيطة لإدارة رسائل واتساب من عملائك.
مستعد للرسائل الترويجية
تعلم كيفية بث الرسائل الترويجية باستخدام قوالب رسائل WhatsApp.
حساب الأعمال الرسمية في WhatsApp (علامة زرقاء)
تعلم كيفية الحصول على حساب الأعمال الرسمية في WhatsApp.

لا يمكن العثور على ما تبحث عنه؟ 🔎