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

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

تعيين إعدادات المعاملات التجارية

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

المتطلبات

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

الحصول على أرقام هواتف الأنشطة التجارية

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

تمكين/تعطيل عربة التسوق

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

عند التمكين، تظهر الأزرار المتعلقة بعربة التسوق في طرق عرض المحادثة والكتالوج وتفاصيل المنتج:

Three WhatsApp messenger screenshots with callout of various cart UI components displayed

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

بنية الطلب

POST /<BUSINESS_PHONE_NUMBER_ID>/whatsapp_commerce_settings
  ?is_cart_enabled=<IS_CART_ENABLED>

المعلمات

العنصر النائب	عينة من القيمة	الوصف
`<BUSINESS_PHONE_NUMBER_ID>`	`106850078877666`	معرف رقم هاتف النشاط التجاري.
`<IS_CART_ENABLED>`	`true`	Boolean (قيمة منطقية). يتم التعيين على `true` لتمكين عربة التسوق أو على `false` لتعطيل عربة التسوق. علمًا بأن القيمة الافتراضية هي `true`.

عينة من الطلب

curl -X POST 'https://graph.facebook.com/v21.0/106850078877666/whatsapp_commerce_settings?is_cart_enabled=true' \
-H 'Authorization: Bearer EAAJB...'

عينة من الاستجابة

{
  "success": true
}

تمكين/تعطيل الكتالوج

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

عند التمكين، تظهر أيقونة واجهة المتجر للكتالوج والأزرار المتعلقة بالكتالوج في طرق عرض المحادثة وملف النشاط التجاري:

Two WhatsApp messenger screenshots with callout of various catalog UI components displayed

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

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

بنية الطلب

POST /<BUSINESS_PHONE_NUMBER_ID>/whatsapp_commerce_settings
  ?is_catalog_visible=<IS_CATALOG_VISIBLE>

المعلمات

العنصر النائب	عينة من القيمة	الوصف
`<BUSINESS_PHONE_NUMBER_ID>`	`106850078877666`	معرف رقم هاتف النشاط التجاري.
`<IS_CATALOG_VISIBLE>`	`true`	Boolean (قيمة منطقية). يتم التعيين على `true` لعرض أيقونة واجهة المتجر المرتبطة بالكتالوج أو على `false` لإخفائها. علمًا بأن القيمة الافتراضية هي `false`.

عينة من الطلب

curl -X POST 'https://graph.facebook.com/v21.0/106850078877666/whatsapp_commerce_settings?is_catalog_visible=true' \
-H 'Authorization: Bearer EAAJB...'

عينة من الاستجابة

{
  "success": true
}

الحصول على إعدادات المعاملات التجارية

استخدم نطقة نهاية رقم هاتف النشاط التجاري > إعدادات المعاملات التجارية في واتساب للحصول على إعدادات المعاملات التجارية لرقم هاتف النشاط التجاري الفردي.

بنية الطلب

GET /<BUSINESS_PHONE_NUMBER_ID>/whatsapp_commerce_settings

المعلمات

العنصر النائب	عينة من القيمة	الوصف
`<BUSINESS_PHONE_NUMBER_ID>`	`106850078877666`	معرف رقم هاتف النشاط التجاري.

عينة من الطلب

curl -X GET 'https://graph.facebook.com/v21.0/106850078877666/whatsapp_commerce_settings' \
-H 'Authorization: Bearer EAAJB...'

عينة من الاستجابة

{
  "data": [
    {
      "is_cart_enabled": true,
      "is_catalog_visible": true,
      "id": "727705352028726"
    }
  ]
}