نظرة عامة

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

المتطلبات

• حساب Meta للأعمال.
• حساب واتساب للأعمال مرتبط بحساب Meta للأعمال.
• تطبيق أعمال مرتبط بحساب Meta للأعمال.
• رمز وصول مستخدم نظام دمج الأعمال أو رمز وصول مستخدم النظام أو رمز وصول المستخدم.
• الإذن whatsapp_business_management.
• إذا كان تطبيقك يمكنه الوصول إلى نقاط النهاية التي تستهدف حساب Meta للأعمال، فستحتاج إلى الإذن business_management.
• إذا كان تطبيقك يمكنه الوصول إلى نقاط نهاية API السحابة، فستحتاج إلى الإذن whatsapp_business_messaging.

رموز الوصول

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

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

رموز وصول مستخدم النظام

رموز وصول مستخدم النظام تمثلك أنت أو النشاط التجاري أو المؤسسة أو الأشخاص ضمن النشاط التجاري أو المؤسسة. الميزة الرئيسية لهذه الرموز هي أنها لا تنتهي صلاحيتها، ويمكن أن تمثل الخدمات التلقائية ضمن النشاط التجاري التي لا تتطلب أي إدخال من جانب المستخدم.

رموز وصول مستخدمي النظام هي النوع الوحيد من الرموز التي يمكن استخدامها من قبل شركاء الحل لمشاركة حدود الائتمان مع العملاء الذين تم إعدادهم.

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

يمكن أن يكون مستخدمو النظام موظفين أو مسؤولين.

مستخدمو النظام الموظفون

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

بمجرد إنشاء المستخدم، يجب منح الوصول الكامل أو الجزئيلأصول النشاط التجاري لكل حساب واتساب للأعمال يحتاج مستخدم النظام إلى الوصول إليه.

مستخدمو النظام المسؤولون

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

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

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

إنشاء مستخدمي النظام

لإنشاء مستخدم نظام:

1. قم بتسجيل الدخول إلى Meta Business Suite.
2. حدّد حساب الأعمال في القائمة المنسدلة أعلى اليمين وانقر على أيقونة (الترس) الإعدادات.
3. انقر على إعدادات مدير الأعمال.
4. انتقل إلى المستخدمون > مستخدمو النظام.
5. انقر على الزر إضافة وأنشئ مستخدم نظام مسؤول أو موظف.

إنشاء رموز وصول مستخدمي النظام

لإنشاء رمز وصول مستخدم النظام بعد إنشاء مستخدم النظام:

1. قم بتسجيل الدخول إلى Meta Business Suite.
2. حدّد حساب الأعمال في القائمة المنسدلة أعلى اليمين وانقر على أيقونة (الترس) الإعدادات.
3. انقر على إعدادات مدير الأعمال.
4. انتقل إلى المستخدم > مستخدمو النظام.
5. حدّد مستخدم النظام الملائم من قائمة مستخدمي النظام.
6. انقر على زر إنشاء رمز جديد.
7. حدّد التطبيق الذي سيستخدم الرمز.
8. حدّد أي أذونات Graph API يتطلبها التطبيق للعمل بشكل سليم وأنشئ الرمز.

رموز وصول مستخدم نظام دمج الأعمال

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

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

لإنشاء رموز وصول مستخدم نظام دمج الأعمال، يجب تنفيذ التسجيل المُضمن (الذي تم تكوينه مع تسجيل دخول فيسبوك للأعمال)، واستبدال الرمز الذي تم إرجاعه إليك عندما يكمل المستخدم الدفق.

راجع مستند التسجيل المُضمن ومستند رموز وصول مستخدم نظام دمج الأعمال للتعرف على المزيد حول هذه الرموز وكيفية إنشائها.

رموز وصول المستخدم

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

توجد عدة طرق لإنشاء رمز وصول المستخدم:

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

استخدام الرموز في الطلبات

عند إجراء طلبات API، يمكنك تضمين الرمز في عنوان طلب المصادقة، مسبوقًا بـ Bearer. على سبيل المثال:

curl 'https://graph.facebook.com/v18.0/102290129340398/message_templates' \
-H 'Authorization: Bearer EAAJB...' \

الوصول إلى أحد أصول النشاط التجاري

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

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

لتعيين صلاحية الوصول إلى أصول النشاط التجاري في حساب واتساب للأعمال:

1. قم بتسجيل الدخول إلى Meta Business Suite.
2. حدّد حساب الأعمال في القائمة المنسدلة أعلى اليمين وانقر على أيقونة (الترس) الإعدادات.
3. انتقل إلى الحسابات > حسابات واتساب.
4. حدّد حساب واتساب للأعمال المناسب.
5. حدّد علامة التبويب الوصول إلى حساب واتساب.
6. انقر على زر +إضافة أشخاص.
7. حدّد مستخدم النظام المناسب وقم بتعيين مستويات الوصول المناسبة في حساب واتساب للأعمال.

اختبار نقاط النهاية

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

الحصول على معلومات حول النشاط التجاري

للحصول على معلومات حول النشاط التجاري، أرسل طلب GET إلى نقطة النهاية WhatsAppBusinessAccount حيث يكون <WHATSAPP_BUSINESS_ACCOUNT_ID> هو معرف حساب واتساب للأعمال.

مثال على الطلب

curl -i -X GET 'https://graph.facebook.com/v21.0/<WHATSAPP_BUSINESS_ACCOUNT_ID>' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>'

مثال على الاستجابة

{
  "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
  "name": "Your WhatsApp Business Account Name",
  "timezone_id": "1",
  "message_template_namespace": "05155c78_261e_4b2f_82b3_d7958d4cf75f"
}

للحصول على معلومات محددة حول نشاط تجاري، مثل الاسم وقوالب الرسائل وأرقام الهواتف، أرسل طلب GET إلى نقطة النهاية WhatsAppBusinessAccount حيث يكون <WHATSAPP_BUSINESS_ACCOUNT_ID> هو معرف حساب واتساب للأعمال وقم بتعيين المعلمة fields إلى قائمة من العناصر التي ترغب في إرجاعها.

مثال على الطلب

curl -i -X GET 'https://graph.facebook.com/v21.0/<WHATSAPP_BUSINESS_ACCOUNT_ID>?fields=id,name,message_templates,phone_numbers' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>'

مثال على الاستجابة

{
  "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
  "name": "Your WhatsApp Business Account Name",
  "message_templates": {
    "data": [
      {
        "name": "hello_world",
        "components": [
          {
            "type": "HEADER",
            "format": "TEXT",
            "text": "Hello World"
          },
          {
            "type": "BODY",
            "text": "Welcome and congratulations!! This message demonstrates your ability to send a message notification from WhatsApp Business Platform. Thank you for taking the time to test with us."
          },
          {
            "type": "FOOTER",
            "text": "WhatsApp Business Team"
          }
        ],
        "language": "en_US",
        "status": "APPROVED",
        "category": "ACCOUNT_UPDATE",
        "id": "307191531401674"
      },
      {
        "name": "sample_flight_confirmation",
        "components": [
          {
            "type": "HEADER",
            "format": "DOCUMENT"
          },
          {
            "type": "BODY",
            "text": "Confirmamos tu vuelo a {{1}}-{{2}} para el {{3}}."
          },
          {
            "type": "FOOTER",
            "text": "Este mensaje proviene de un negocio no verificado."
          }
        ],
        "language": "es",
        "status": "APPROVED",
        "category": "TICKET_UPDATE",
      },
      ...
    

تقييدات معدلات الاستدعاء

معرفة المزيد

• مجموعات Facebook SDK – لطلب أذونات من المستخدمين باستخدام تسجيل دخول فيسبوك، يمكنك تنفيذ إحدى مجموعات SDK التي نوفرها.
• مدير أعمال API التسويق – تعرف على المزيد حول مدير أعمال API التسويق.
• مراجعة التطبيقات - تعرف على المزيد حول العملية التي يجب الخضوع لها للوصول إلى بياناتك الخاصة أو البيانات المملوكة بواسطة الآخرين.
• شاهد فيديو إعداد منصة واتساب للأعمال.

الخطوات التالية

• الدلائل – تعرف على المزيد حول ما يمكنك فعله باستخدام API إدارة حساب واتساب للأعمال.
• استكشاف مجموعة Postman