‏API داخل المواقع الخاصة بمنصة واتساب للأعمال‏

الحساب

/v1/account

تُستخدم العقدة account في تسجيل عميل واجهة API الخاصة بتطبيق WhatsApp للأعمال.

يُرجى الانتباه إلى أنه ستتم إعادة تشغيل Coreapp إذا تم تسجيل رقم جديد في مجموعة تحتوي على رقم آخر مسجّل بالفعل.

عناصر الربط

ترتبط عناصر الربط التالية بهذه العقدة:

عنصر الربطالوصف

/verify

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

قبل البدء

ستحتاج إلى ما يلي:

نسخ الشهادة بتشفير Base64

يتم إنشاء سلسلة شهادة بتشفير base64 نيابة عنك ويتم استخدامها للتحقق من الصحة أثناء تسجيل عميل API الخاصة بواتساب للأعمال.

  1. انتقل إلى إعدادات مدير الأعمال في مدير الأعمال من Meta.
  2. انقر على حسابات واتساب ضمن قائمة الحسابات، ثم حدّد حساب واتساب لديك من قائمة حسابات واتساب إذا لم يكن محددًا بالفعل.
  3. انتقل إلى علامة تبويب الإعدادات وانقر على الزر مدير واتساب.
  4. ضمن علامة تبويب أرقام الهواتف، يجب أن تكون أرقام هاتفك مدرجة. وانقر على الزر عرض الخاص برقم الهاتف الذي تريد الحصول على شهادة من أجله.
    الحصول على الشهادة
  5. سيعرض مربع الحوار المنبثق سلسلة الشهادة في مربع رمادي. وانقر على الحصول على شهادة.
    تنزيل سلسلة الشهادة
  6. استخدم سلسلة الشهادة هذه في المعلمة 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"
  }]
}

إذا تم إرجاع أي أخطاء، فيمكنك الرجوع إلى رسائل الخطأ والحالة للحصول على مزيد من المعلومات.

المعلمات

الاسمالوصف

cc

مطلوب.

كود البلد الرقمي المرتبط برقم الهاتف الذي تسجّله

phone_number

مطلوب.

يمثل رقم الهاتف الذي تسجّله بدون كود البلد أو علامة الجمع (+).

method

مطلوب.

يمثل أسلوب تلقي رمز التسجيل
الخياران هما:voice، sms

cert

مطلوب.

شهادة بتشفير Base64.

pin

اختياري.

رقم التعريف الشخصي (PIN) الحالي والمكوّن من 6 أرقام — يكون هذا الرقم مطلوبًا فقط عند تمكين التحقق بخطوتين بهذا الحساب.

تغيير رقم التعريف الشخصي (PIN) للتحقق بخطوتين

لتغيير رقم التعريف الشخصي (PIN) للتحقق بخطوتين الخاص برقم هاتف النشاط التجاري:

  1. قم بتحميل حافظة الأعمال في مدير واتساب.
  2. إذا لم يتم تحميل لوحة أرقام الهواتف تلقائيًا، فانتقل إلى أدوات الحساب (أيقونة صندوق الأدوات) > أرقام الهواتف.
  3. انقر على أيقونة إعدادات رقم الهاتف (الترس).
  4. انقر على التحقق بخطوتين.
  5. انقر على تغيير رقم التعريف الشخصي وأكمل الدفق.

يجب إدخال رقم التعريف الشخصي الحالي الخاص بك لتغييره. لاحظ أنه يمكنك أيضًا تعيين رقم تعريف شخصي جديد باستخدام واجهات API التي نوفرها:

تعطيل التحقق بخطوتين

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

الأسئلة المتكررة

نعم، يمكننا إعداد رقم هاتف جديد أو تغيير الاسم المُتحقق منه عندما تكون مستعدًا للبث المباشر.

الرابط الثابت

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

لاحظ أيضًا أنه توجد تعقيدات مُضافة بشأن الأرقام المجانية. فبصفة أساسية إذا كنت تتصل برقم مجاني بكود البلد أثناء تواجدك في هذا البلد، فلن ينجح الاتصال. ويعني ذلك أن عملاءك المتواجدين في بلدك سيحاولون الاتصال بالرقم الذي يظهر لهم في جهة اتصال النشاط التجاري (يكون كود البلد مضمّنًا) ولن يمكنهم الوصول إليك. وإذا كان هذا الأمر يثير القلق، فستحتاج إلى إخبارهم بشكل صريح.

يمكنك الاطلاع على المزيد حول الأرقام المجانية هنا.

الرابط الثابت

في حالة نسخ عملية إعدادك الحالية احتياطيًا واستعادتها على الجهاز الجديد، يجب نقل معلومات التسجيل مع بقية إجراءات التنفيذ لديك. ولمزيد من المعلومات، راجع وثائق النسخ الاحتياطي والاستعادة.

الرابط الثابت

يمكنك تسجيل أرقام هواتف جديدة وحذف أرقام الهواتف القديمة الموجودة في حسابك على واتساب في مدير فيسبوك للأعمال.

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

في حالة فشل التسجيل باستخدام "رسالة sms" بسبب إجراء محاولات عديدة للغاية وظهور الرسالة "تم رفض الوصول"، من ثمّ يرجى محاولة التسجيل باستخدام "مكالمة صوتية"

الرابط الثابت

للأسف، ستحتاج إلى اختيار رقم هاتف آخر يمكنه تلقي رسالة SMS أو مكالمة صوتية حتى نتمكّن من إرسال الرمز البرمجي للتسجيل. وفي السابق، كنا نسمح باستخدام الرموز البرمجية للتسجيل اليدوي، ولكن لم يعد ذلك مدعومًا. علمًا بأن أرقام الهواتف التي استخدمت الرموز البرمجية للتسجيل اليدوي من قبل ستظل مدعومة حسب الحاجة. وبالنسبة لأرقام الهواتف الجديدة، لن نعرض سوى الرموز البرمجية للتسجيل عبر رسالة SMS أو مكالمة صوتية.

إذا كنت تريد استخدام الرقم 1800 أو الرقم المجاني، فيرجى الاطلاع على هذا الدليل.

الرابط الثابت

معرفة المزيد