واجهة برمجة التطبيقات السحابية لواتساب هي منصة جديدة توفر للشركات اتصالًا مباشرًا بالبنية التحتية لـ 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 جديد. يمكنك تخطي هذه الخطوة إذا كان لديك وابا موجود مع رقم لم يعد مستخدما.
تعرف على المزيد حول توصيل أرقام الهواتف بـ WhatsApp Cloud API هنا.
حذف الرقم الجديد من الوجهة WABA: سيؤدي هذا إلى إخلاء نقطة لعدد لإضافته إلى الوجهة WABA. بدلاً من ذلك، إذا كان لديك رقم موجود غير مستخدم، يمكنك حذف هذا الرقم.
بمجرد حذف الرقم ، انتقل إلى ترحيل الرقم الحالي للعميل إلى الواحة الجديدة.
من المهم ملاحظة أنه في هذه اللحظة ، لا يمكن تنفيذ خطوات الترحيل إلا من قبل مطور. نحن نعمل حاليا على إيجاد حل أكثر سهولة في الاستخدام. بحاجة إلى مساعدة؟ اتصل بنا هنا!
منشور <https://graph.facebook.com/{version}/{wabaId}/phone\_numbers>.
الاسم | في | مطلوب | نوع | الوصف |
---|---|---|---|---|
الإصدار | المسار | صحيح | سلسلة | إصدار API. |
وابايد | المسار | صحيح | سلسلة | معرف واجهة برمجة تطبيقات الواتساب السحابية. |
انتقل إلى مدير الأعمال > إعدادات الأعمال > الحسابات > حسابات الأعمال على WhatsApp للعثور على معرف حساب الأعمال على WhatsApp. حدد الحساب الذي تريد استخدامه. ستظهر لوحة تحتوي على معلومات الحساب ، بما في ذلك معرف الهوية.
رأس الصفحة
تفويض: حامل {Access Token}.
يقوم مستخدم النظام بإنشاء رمز الوصول الخاص بك في تبويب حسابات الأعمال في WhatsApp الخاص بمدير الأعمال. اقرأ هذا الدليل لمعرفة كيفية الوصول إلى مستخدم النظام وإنشاء أو نسخ واحد.
الجسم
الاسم | نوع | الوصف |
---|---|---|
cc | num | رمز البلد الرقمي لرقم الهاتف قيد التسجيل.ملاحظة: علامة بلس (+) ليست مطلوبة لرمز البلد. |
رقم_الهاتف | num | يتم ترحيل رقم الهاتف بدون رمز البلد أو الرمز زائدا (+). |
تحويل_الهاتف_رقم | boolean | تعيين إلى "صواب" لترحيل رقم الهاتف. |
الحالة
الاسم | الوصف |
---|---|
200 موافق | نجاح. |
الاستجابات
{
"id": "phoneNumberId"
}
منشور <https://graph.facebook.com/{version}/{phoneNumberId}/request\_code>
الاسم | في | مطلوب | نوع | الوصف |
---|---|---|---|---|
الإصدار | المسار | صحيح | سلسلة | إصدار API. |
رقم هاتف المستلم. | المسار | صحيح | سلسلة | هذه هي الاستجابة التي أعيدت في الخطوة 1. نسخ وصق الرقم إلى عنوان URL الخاص برد الاتصال في هذه الخطوة. |
رأس الصفحة
التفويض: حامل {Access Token}
الجسم
الاسم | نوع | الوصف |
---|---|---|
طريقة الكود. | enum. | طريقة تلقي رمز التسجيل. القيم المدعومة: الرسائل القصيرة والصوت. |
اللغة | enum. | اللغة التي تريد أن تتلقى بها رمز التسجيل. راجع رموز اللغة. |
الحالة
الاسم | الوصف |
---|---|
200 موافق | نجاح. |
الاستجابات
{
"النجاح": true
}
تم إرسال الرمز إلى رقم الهاتف الذي يتم نقله عبر الطريقة المحددة (SMS أو صوت).
التدوينة: <https://graph.facebook.com/{version}/{phoneNumberId}/verify\_code>
سيتم استخدام الرمز (رقم الدبوس المكون من 6 أرقام) المستلم في رقم الهاتف من الخطوة 2 للتحقق من الملكية.
رأس الصفحة
التفويض: حامل {Access Token}
الجسم
الاسم | نوع | الوصف |
---|---|---|
الكود | num | تم استلام رمز التسجيل من 6 أرقام بعد اكتمال الخطوة 2. |
الحالة
الاسم | الوصف |
---|---|
200 موافق | نجاح. |
الاستجابات
{
"النجاح": true
}
يؤكد أنه تم التحقق من ملكية الهاتف.
منشور <https://graph.facebook.com/{version}/{phoneNumberId}/register>
رأس الصفحة
التفويض: حامل {Access Token}
الجسم
الاسم | نوع | الوصف |
---|---|---|
رسالة_المنتج. | enum. | خدمة المراسلة المستخدمة. في هذه الحالة، استخدم "Whatsapp". |
دبوس | رقم | تم تلقي رمز التسجيل من 6 أرقام بعد الخطوة 2. |
الحالة
الاسم | الوصف |
---|---|
200 موافق | نجاح. |
الاستجابات
{
"النجاح": true
}
تم تسجيل رقم الهاتف بنجاح في واجهة برمجة تطبيقات واتسآب السحابية WABA. يمكنك الآن إرسال رسائل إلى WABA الوجهة الخاصة بك.
لم يتم ترحيل معرف WABA. الرقم المنقول حديثاً سوف يرتبط بمعرف WABA الخاص بالرقم المحذوف سابقاً.
يمكن التحقق من الترحيل الناجح من خلال تطبيق مطوري ميتا. وللقيام بذلك، ينبغي اتخاذ الخطوات التالية:
انتقل إلى WhatsApp > بدأ
في قائمة أرقام الهاتف المنسدلة، تأكد من أن الرقم موجود ويعكس بدقة.
المقالات ذات الصلة 👩💻