جدول المحتويات
- فوائد الترحيل إلى WhatsApp Cloud API
- ماذا سيتم ترحيله؟
- متطلبات ما قبل الترحيل: ما يجب التحضير لإعداد الترحيل الخاص بك
- وثائق API لعملية الترحيل
ترحيل رقم الهاتف إلى WhatsApp Cloud API
- فوائد الترحيل إلى WhatsApp Cloud API
- ماذا سيتم ترحيله؟
- متطلبات ما قبل الترحيل: ما يجب التحضير لإعداد الترحيل الخاص بك
- وثائق API لعملية الترحيل
فوائد الترحيل إلى WhatsApp Cloud API
WhatsApp Cloud API عبارة عن نظام أساسي جديد يوفر للشركات اتصالاً مباشرًا بالبنية التحتية لـ WhatsApp وهو خيار خدمة ذاتية مقارنة بالمرور عبر شركاء WhatsApp (BSPs). بعض فوائد استخدام 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. بدلاً من ذلك ، إذا كان لديك رقم حالي غير مستخدم ، فيمكنك حذف هذا الرقم.
وثائق API لعملية الترحيل
الخطوة 1: ابدأ ترحيل رقم الهاتف
عاود الاتصال بالعنوان:
POST <https://graph.facebook.com/{version}/{wabaId}/phone_numbers> اسم | في | مطلوب | يكتب | وصف |
إصدار | طريق | حقيقي | خيط | إصدار API. |
wabaId | طريق | حقيقي | خيط | معرف WhatsApp Cloud API WABA. |
حدود
رأس
Authorization: Bearer {Access Token}
جسم
اسم | يكتب | وصف |
| الأس | رمز البلد الرقمي لرقم الهاتف الجاري تسجيله. ملاحظة: علامة الجمع (+) ليست ضرورية لرمز الدولة. |
| الأس | يتم ترحيل رقم الهاتف ، بدون رمز البلد أو رمز الجمع (+). |
| قيمة منطقية | اضبط على صواب لترحيل رقم الهاتف. |
حالة
اسم | وصف |
200 جيد | نجاح. |
إجابة
{
"id": "phoneNumberId"
}الخطوة 2: طلب رمز (PIN) للتحقق من ملكية الهاتف
عاود الاتصال بالعنوان
POST <https://graph.facebook.com/{version}/{phoneNumberId}/request_code> اسم | في | مطلوب | يكتب | وصف |
إصدار | طريق | حقيقي | خيط | إصدار API. |
رقم الهاتف | طريق | حقيقي | خيط | هذا هو الرد الذي تم إرجاعه في الخطوة 1. انسخ الرقم والصقه في عنوان URL لمعاودة الاتصال في هذه الخطوة. |
حدود
رأس
Authorization: Bearer {Access Token}
جسم
اسم | يكتب | وصف |
| تعداد | طريقة استلام كود التسجيل. القيم المدعومة: الرسائل القصيرة والصوت. |
| تعداد | اللغة التي تريد استلام رمز التسجيل بها. انظر رموز اللغة . |
حالة
اسم | وصف |
200 جيد | نجاح. |
إجابة
{
"success": true
}الخطوة 3: تحقق من الرمز
عاود الاتصال بالعنوان
POST: <https://graph.facebook.com/{version}/{phoneNumberId}/verify_code>حدود
رأس
Authorization: Bearer {Access Token}
جسم
اسم | يكتب | وصف |
| الأس | تم استلام رمز التسجيل المكون من 6 أرقام بعد إكمال الخطوة 2. |
حالة
اسم | وصف |
200 جيد | نجاح. |
إجابة
{
"success": true
}الخطوة 4: تسجيل رقم الهاتف
عاود الاتصال بالعنوان
POST <https://graph.facebook.com/{version}/{phoneNumberId}/register>حدود
رأس
Authorization: Bearer {Access Token}
جسم
اسم | يكتب | وصف |
| تعداد | تم استخدام خدمة الرسائل. في هذه الحالة ، استخدم "whatsapp". |
| الأس | تم استلام رمز التسجيل المكون من 6 أرقام بعد الخطوة 2. |
حالة
اسم | وصف |
200 جيد | نجاح. |
إجابة
{
"success": true
}الخطوة 5: تحقق من رقم الهاتف الذي تم ترحيله في تطبيق Meta Developer
يمكن التحقق من عملية الترحيل الناجحة من خلال تطبيق Meta Developer. لكي تفعل هذا، اتبع هذه الخطوات:
- انتقل إلى WhatsApp > البدء
- في القائمة المنسدلة لرقم الهاتف ، تأكد من وجود الرقم وانعكاسه بدقة.
