فوائد الانتقال إلى WhatsApp Cloud API
واجهة برمجة التطبيقات السحابية لواتساب هي منصة جديدة توفر للشركات اتصالًا مباشرًا بالبنية التحتية لـ WhatsApp، وهي خيار ذاتي الخدمة مقارنة بالاعتماد على شركاء WhatsApp (BSPs). بعض فوائد استخدام WhatsApp Cloud API هي:
خيار أكثر فعالية من حيث التكلفة.
اتصال أكثر موثوقية واستقرارًا بالمنصة.
القدرة على بناء تكاملات مخصصة تناسب احتياجات عملك المحددة.
حل مرن وقابل للتطوير للشركات من جميع الأحجام.
تعرف على المزيد حول WhatsApp Cloud API هنا.
ماذا سيتم ترحيله؟
لاحظ أنه يمكن نقل العناصر التالية من WhatsApp BSP إلى WhatsApp Cloud API.
يمكن نقلها
رقم الهاتف المرتبط بالحساب.
أي قوالب رسائل عالية الجودة تمت الموافقة عليها مسبقًا.
اسم العرض لرقم الهاتف.
تقييم جودة رقم الهاتف.
حدود الرسائل.
الحالة الرسمية لـWABA.
لا يمكن ترحيلها
قوالب الرسائل ذات الجودة المنخفضة أو المرفوضة أو المعلقة.
متطلبات ما قبل الهجرة: ما الذي يجب عليك تحضيره لإعداد الهجرة الخاص بك
انتبه للعبارات التي سيتم استخدامها بشكل متكرر في جميع أنحاء هذه الوثيقة:
-المصدر WABA: WhatsApp BSP الذي ننتقل منه.
-الوجهة WABA: واجهة برمجة تطبيقات WhatsApp Cloud التي ننتقل إليها.
قائمة التحقق من متطلبات ما قبل الهجرة:
تطبيق مطور ميتا الحالي: إذا لم يكن لديك تطبيق مطور مُنشأ، اضغط هنا لإنشاء تطبيقك في مدير أعمال ميتا (MBM) وابدأ باستخدام WhatsApp Cloud API. يجب إنشاء هذا التطبيق ضمن نفس حساب العمل (معرف العمل) مثل WABA المصدر.
معرف العمل: يجب أن تكون WABA المصدر والوجهة مرتبطتين بنفس MBM أو أن يكون لهما نفس معرف العمل.
التحقق من هوية العمل: يجب التحقق من هوية العمل. إذا لم يتم التحقق من عملك بعد، فاتبع الخطوات التالية للتحقق منه.
حالة مراجعة WABA: يجب الموافقة على حالة مراجعة WABA المصدر والوجهة.
الدفع الطريقة: يجب تكوين طريقة الدفع لكل من WABA المصدر والوجهة. تأكد من إعداد طريقة الدفع في كل من المصدر والوجهة.
التحقق بخطوتين: يجب تعطيل التحقق بخطوتين على رقم الهاتف الذي يتم نقله.
عندما يتم التحقق من جميع الخطوات المذكورة أعلاه واستكمالها، يمكن أن تستمر عملية الترحيل.
تكوين أرقام الهاتف ومعرفات WABA
لقد صممت Meta معرفات WABA بحيث لا يمكن نقلها. بسبب بعض القيود، تم تنفيذ حل بديل. لكي تتم عملية نقل أرقام الهواتف، يجب أن يكون كل من معرفات WABA المصدر والوجهة ضمن حساب Meta Business Manager نفسه. وهذا يعني أن نقل رقم الهاتف سيؤدي فقط إلى نقل هذا الرقم بين WABAs ولن يسمح بأي تغييرات أخرى. لترحيل رقم الهاتف بنجاح، يجب تنفيذ الخطوات التالية:
أضف رقمًا جديدًا إلى الوجهة WABA: سيؤدي هذا إلى إنشاء معرف WABA جديد للرقم الذي ترغب في الانتقال إليه. يمكنك تخطي هذه الخطوة إذا كان لديك حساب WABA موجود برقم لم يعد قيد الاستخدام.
تعرف على المزيد حول ربط أرقام الهواتف بـ WhatsApp Cloud API هنا.
حذف الرقم الجديد من WABA الوجهة: سيؤدي هذا إلى إفساح المجال لإضافة رقم إلى WABA الوجهة. وبدلاً من ذلك، إذا كان لديك رقم غير مستخدم موجود، فيمكنك حذف هذا الرقم.
بمجرد حذف الرقم، انتقل إلى ترحيل الرقم الحالي للعميل إلى حساب WhatsApp التجاري الجديد.
توثيق واجهة برمجة التطبيقات (API) لعملية الهجرة
من المهم ملاحظة أنه في الوقت الحالي، لا يمكن تنفيذ خطوات الترحيل الموضحة في وثائق واجهة برمجة التطبيقات إلا بواسطة مطور أو شخص لديه خلفية تقنية مماثلة. ومع ذلك، فإننا نتفهم أن هذا قد يشكل قيدًا بالنسبة للبعض، ونحن نعمل على تطوير حل أكثر سهولة في الاستخدام ويمكن الوصول إليه في المستقبل. هل تحتاج مساعدة؟ اتصل بناهنا!
الخطوة 1: بدء نقل رقم الهاتف
عنوان URL للاتصال العكسي:
منشور <https://graph.facebook.com/{version}/{wabaId}/phone\_numbers>
اسم | في | مطلوب | يكتب | وصف |
|---|---|---|---|---|
إصدار | طريق | حقيقي | خيط | إصدار API. |
معرف وابا | طريق | حقيقي | خيط | معرف WABA لـ WhatsApp Cloud API. |
انتقل إلى مدير الأعمال > إعدادات الأعمال > الحسابات > حسابات WhatsApp Business للعثور على معرف حساب WhatsApp Business. حدد الحساب الذي تريد استخدامه. ستظهر لوحة تحتوي على معلومات الحساب، بما في ذلك المعرف.
حدود
رأس الصفحة
التفويض: حامل {Access Token}
يقوم مستخدم النظام بإنشاء رمز الوصول الخاص بك في علامة التبويب حسابات WhatsApp Business في Business Manager. اقرأ هذا الدليل لتتعلم كيفية الوصول إلى المستخدم في النظام وإنشاء واحد أو نسخه.
جسم
اسم | يكتب | وصف |
|---|---|---|
نسخة | رقم | رمز الدولة الرقمي لرقم الهاتف الذي يتم تسجيله. ملاحظة: لا حاجة لعلامة الجمع (+) لرمز الدولة. |
رقم التليفون | رقم | رقم الهاتف الذي يتم نقله، بدون رمز الدولة أو رمز الجمع (+). |
نقل رقم الهاتف | منطقي | تم ضبطه على "صحيح" لنقل رقم الهاتف. |
حالة
اسم | وصف |
|---|---|
200 موافق | نجاح. |
إجابة
{
"المعرف": "phoneNumberId"
}
الخطوة 2: طلب رمز (PIN) للتحقق من ملكية الهاتف
عنوان URL للاتصال العكسي
منشور <https://graph.facebook.com/{version}/{phoneNumberId}/request\_code>
اسم | في | مطلوب | يكتب | وصف |
|---|---|---|---|---|
إصدار | طريق | حقيقي | خيط | إصدار API. |
معرف رقم الهاتف | طريق | حقيقي | خيط | هذه هي الاستجابة التي تم إرجاعها في الخطوة 1. في هذه الخطوة، قم بنسخ الرقم ولصقه في عنوان URL للاتصال العكسي. |
حدود
رأس الصفحة
التفويض: حامل {Access Token}
جسم
اسم | يكتب | وصف |
|---|---|---|
طريقة الكود | عدّ | طريقة الحصول على رمز التسجيل. القيم المدعومة: الرسائل القصيرة والصوت. |
لغة | عدّ | اللغة التي تريد تلقي رمز التسجيل بها. انظر رموز اللغة. |
حالة
اسم | وصف |
|---|---|
200 موافق | نجاح. |
إجابة
{
"نجاح": صحيح
}
لقد تم إرسال الرمز إلى رقم الهاتف الذي يتم نقله عبر الطريقة المحددة (رسالة نصية قصيرة أو صوتية).
الخطوة 3: التحقق من الكود
عنوان URL للاتصال العكسي
التدوينة: <https://graph.facebook.com/{version}/{phoneNumberId}/verify\_code>
سيتم استخدام الرمز (رقم التعريف الشخصي المكون من 6 أرقام) الذي تم استلامه في رقم الهاتف من الخطوة 2 للتحقق من الملكية.
حدود
رأس الصفحة
التفويض: حامل {Access Token}
جسم
اسم | يكتب | وصف |
|---|---|---|
شفرة | رقم | تم استلام رمز التسجيل المكون من 6 أرقام بعد إكمال الخطوة 2. |
حالة
اسم | وصف |
|---|---|
200 موافق | نجاح. |
إجابة
{
"نجاح": صحيح
}
تأكيد أن ملكية الهاتف تم التحقق منها.
الخطوة 4: تسجيل رقم الهاتف
عنوان URL للاتصال العكسي
منشور <https://graph.facebook.com/{version}/{phoneNumberId}/register>
حدود
رأس الصفحة
التفويض: حامل {Access Token}
جسم
اسم | يكتب | وصف |
|---|---|---|
منتج المراسلة | عدّ | تم استخدام خدمة الرسائل. في هذه الحالة استخدم "whatsapp". |
دبوس | رقم | تم استلام رمز التسجيل المكون من 6 أرقام بعد الخطوة 2. |
حالة
اسم | وصف |
|---|---|
200 موافق | نجاح. |
إجابة
{
"نجاح": صحيح
}
تم تسجيل رقم الهاتف بنجاح في WhatsApp Cloud API WABA. يمكنك الآن إرسال الرسائل إلى وجهتك WABA.
لم يتم نقل معرف WABA. سيتم ربط الرقم المهاجر حديثًا بمعرف WABA للرقم المحذوف مسبقًا.
الخطوة 5: التحقق من رقم الهاتف المهاجر في تطبيق Meta Developer
يمكن التحقق من نجاح عملية الهجرة من خلال تطبيق Meta Developer. للقيام بذلك، اتبع الخطوات التالية:
انتقل إلى WhatsApp > البدء
في القائمة المنسدلة لرقم الهاتف، تأكد من أن الرقم موجود وينعكس بشكل دقيق.
