الحساب
/v1/account
نحن بصدد إيقاف استخدام API داخل المواقع. لم يعد من الممكن استخدام نقطة النهاية هذه لتسجيل أرقام هواتف الأنشطة التجارية وأصبحت ترجع الآن الخطأ التالي:
{
"code": 1005,
"title": "Access denied",
"details": "Unknown error: biz_link_on_prem_reg_blocked"
}
تُستخدم العقدة account في تسجيل عميل API الخاصة بتطبيق واتساب للأعمال.
يُرجى الانتباه إلى أنه ستتم إعادة تشغيل Coreapp إذا تم تسجيل رقم جديد في مجموعة تحتوي على رقم آخر مسجّل بالفعل.
عناصر الربط
ترتبط عناصر الربط التالية بهذه العقدة:
| عنصر الربط | الوصف |
|---|---|
بمجرد تلقي رمز التسجيل عبر الأسلوب المحدد، استخدم عنصر الربط هذا لإكمال تسجيل حسابك. |
قبل البدء
ستحتاج إلى ما يلي:
- رموز المصادقة حتى تتمكن من تسجيل الدخول إلى الخدمة
- اسم عرض معتمد في واتساب مرتبط برقم الهاتف هذا
نسخ الشهادة بتشفير Base64
يتم إنشاء سلسلة شهادة بتشفير base64 من أجلك ويتم استخدامها للتحقق من الصحة أثناء تسجيل عميل API الخاصة بتطبيق واتساب للأعمال.
- انتقل إلى إعدادات مدير الأعمال في مدير الأعمال من Meta.
- انقر على حسابات WhatsApp ضمن القائمة الحسابات، ثم حدد حساب واتساب لديك من القائمة حسابات واتساب إذا لم يكن محددًا بالفعل.
- انتقل إلى علامة التبويب الإعدادات وانقر على الزر مدير WhatsApp.
- ضمن علامة التبويب أرقام الهواتف، يجب أن تكون أرقام هاتفك مدرجة. وانقر على الزر عرض الخاص برقم الهاتف الذي تريد الحصول على شهادة من أجله.
الحصول على الشهادة - سيعرض مربع الحوار المنبثق سلسلة الشهادة في مربع رمادي. وانقر على الحصول على شهادة.
تنزيل سلسلة الشهادة - استخدم سلسلة الشهادة هذه في المعلمة
certعند التسجيل باستخدام نقطة النهايةaccount.
لمزيد من المعلومات، يمكنك الرجوع إلى وثائق اسم العرض.
القيود
- يجب أن تستخدم حساب
adminلتسجيل التطبيق. - إذا كنت تعيد تسجيل حسابك، فيلزم إعادة تشغيل حاوية Coreapp بمجرد إكمال التسجيل.
الطلب
يمكنك إجراء الاستدعاء POST إلى نقطة النهاية هذه لطلب رمز التسجيل. وفي الاستدعاء الذي تُجريه، أضف رقم هاتفك وسلسلة الشهادة بتشفير base64. ويمكنك تلقي الرمز عبر رسالة SMS أو مكالمة صوتية.
مثال
POST /v1/account
{
"cc": "COUNTRY_CODE",
"phone_number": "PHONE_NUMBER_WITHOUT_COUNTRY_CODE",
"method": "sms" or "voice",
"cert": "VERIFIED_NAME_CERT_IN_BASE64",
"pin": "EXISTING_6_DIGIT_PIN" # required if two-step verification is enabled
}
استنادًا إلى الاستجابة التي تم تلقيها، يمكن اعتبار ما إذا كان إجراء التسجيل مكتملاً أم يتطلب خطوة أخرى لإكماله. وإذا كان ناجحًا، فستحصل على أحد رموز حالة HTTP التالية. ويمكن اتباع الإرشادات التي تتطابق مع الاستجابة التي تلقيتها:
201 Created— الحساب موجود بالفعل. وأنت مسجّل بالفعل، لذا لا تحتاج إلى القيام بأي إجراء آخر.202 Accepted— الحساب غير موجود. واستنادًا إلى الأسلوب المحدد في الطلب، تحقق من رسالة SMS أو الرقم الصوتي لديك للحصول على رمز التسجيل. وستتضمن هذه الاستجابة حمولة بيانات تم إرجاعها تحتوي علىvnameالذي تم فك تشفيره من المعلمةcertنيابة عنك للتأكيد على أنه تم تعيين اسم العرض الصحيح. وإذا كان الاسم صحيحًا، فانتقل إلى إكمال تسجيل حسابك لإكمال التسجيل.
{
"account": [{
"vname": "decoded-vname-from-cert"
}]
}
إذا تم إرجاع أي أخطاء، فيمكنك الرجوع إلى رسائل الخطأ والحالة للحصول على مزيد من المعلومات.
المعلمات
| الاسم | الوصف |
|---|---|
| مطلوب. يمثل كود البلد الرقمي لرقم الهاتف الذي تسجّله |
| مطلوب. يمثل رقم الهاتف الذي تسجّله بدون كود البلد أو علامة الجمع ( |
| مطلوب. يمثل أسلوب تلقي رمز التسجيل |
| مطلوب. شهادة بتشفير Base64. |
| اختياري. رقم التعريف الشخصي (PIN) الحالي والمكوّن من 6 أرقام — يكون هذا الرقم مطلوبًا فقط عند تمكين التحقق بخطوتين بهذا الحساب. |
تغيير رقم التعريف الشخصي (PIN) للتحقق بخطوتين
لتغيير رقم التعريف الشخصي (PIN) للتحقق بخطوتين الخاص برقم هاتف النشاط التجاري:
- قم بتحميل حافظة الأعمال في مدير واتساب.
- إذا لم يتم تحميل لوحة أرقام الهواتف تلقائيًا، فانتقل إلى أدوات الحساب (أيقونة صندوق الأدوات) > أرقام الهواتف.
- انقر على أيقونة إعدادات رقم الهاتف (الترس).
- انقر على التحقق بخطوتين.
- انقر على تغيير رقم التعريف الشخصي وأكمل الدفق.
يجب إدخال رقم التعريف الشخصي الحالي الخاص بك لتغييره. لاحظ أنه يمكنك أيضًا تعيين رقم تعريف شخصي جديد باستخدام واجهات API التي نوفرها:
تعطيل التحقق بخطوتين
لتعطيل التحقق بخطوتين، اتبع خطوات تغيير رقم التعريف الشخصي، ولكن انقر على زر إيقاف تشغيل التحقق بخطوتين كخطوة أخيرة بدلاً من ذلك. سيتم إرسال رسالة بريد إلكتروني تحتوي على رابط إلى عنوان البريد الإلكتروني المرتبط بحافظة الأعمال. استخدم الرابط لتعطيل التحقق بخطوتين. بمجرد تعطيل الميزة، يمكنك إعادة تمكينها من خلال تعيين رقم تعريف شخصي جديد.
الأسئلة المتكررة
نعم، يمكننا إعداد رقم هاتف جديد أو تغيير الاسم المُتحقق منه عندما تكون مستعدًا للبث المباشر.
مسموح باستخدام الأرقام المجانية طالما أن كود البلد مضمّن. ويرجع السبب في ذلك إلى أنه لا يمكن تحديد الأرقام المجانية بدون أكواد البلدان بشكل فريد بحيث يمكن أن ينطبق الرقم نفسه على بلدين مختلفين.
لاحظ أيضًا أنه توجد تعقيدات مُضافة بشأن الأرقام المجانية. فبصفة أساسية إذا كنت تتصل برقم مجاني بكود البلد أثناء تواجدك في هذا البلد، فلن ينجح الاتصال. ويعني ذلك أن عملاءك المتواجدين في بلدك سيحاولون الاتصال بالرقم الذي يظهر لهم في جهة اتصال النشاط التجاري (يكون كود البلد مضمّنًا) ولن يمكنهم الوصول إليك. وإذا كان هذا الأمر يثير القلق، فستحتاج إلى إخبارهم بشكل صريح.
يمكنك الاطلاع على المزيد حول الأرقام المجانية هنا.
في حالة نسخ عملية إعدادك الحالية احتياطيًا واستعادتها على الجهاز الجديد، يجب نقل معلومات التسجيل مع بقية إجراءات التنفيذ لديك. ولمزيد من المعلومات، راجع وثائق النسخ الاحتياطي والاستعادة.
يمكنك تسجيل أرقام هواتف جديدة وحذف أرقام الهواتف القديمة الموجودة في حسابك على واتساب في مدير فيسبوك للأعمال.
- في حسابك على واتساب، انتقل إلى الإعدادات.
- انقر على مدير واتساب.
- حدد علامة التبويب أرقام الهواتف. ويمكنك هنا إدارة كل أرقام الهواتف الخاصة بهذا الحساب.
في حالة فشل التسجيل باستخدام "رسالة sms" بسبب إجراء محاولات عديدة للغاية وظهور الرسالة "تم رفض الوصول"، من ثمّ يرجى محاولة التسجيل باستخدام "مكالمة صوتية"
للأسف، ستحتاج إلى اختيار رقم هاتف آخر يمكنه تلقي رسالة SMS أو مكالمة صوتية حتى نتمكّن من إرسال الرمز البرمجي للتسجيل. وفي السابق، كنا نسمح باستخدام الرموز البرمجية للتسجيل اليدوي، ولكن لم يعد ذلك مدعومًا. علمًا بأن أرقام الهواتف التي استخدمت الرموز البرمجية للتسجيل اليدوي من قبل ستظل مدعومة حسب الحاجة. وبالنسبة لأرقام الهواتف الجديدة، لن نعرض سوى الرموز البرمجية للتسجيل عبر رسالة SMS أو مكالمة صوتية.
إذا كنت تريد استخدام الرقم 1800 أو الرقم المجاني، فيرجى الاطلاع على هذا الدليل.