مشاركة المنتجات مع العملاء

توجد طرق متعددة لمشاركة المنتجات مع عملائك:

• رسائل الكتالوج — رسائل حرة تحتوي على زر يعرض كتالوج المنتجات ضمن واتساب عندما يتم الضغط عليه.
• رسائل قالب الكتالوج — رسائل قالب تحتوي على زر يعرض كتالوج المنتجات ضمن واتساب عندما يتم الضغط عليه.
• رسائل رابط الكتالوج — رسائل مجانية تحتوي على صور مصغرة للكتالوج ورابط لكتالوج المنتجات بالكامل.
• رسائل المنتجات — رسائل مجانية تحتوي على معلومات عن منتج واحد أو ما يصل إلى 30 منتجًا من كتالوج المنتجات.
• قوالب رسائل المنتجات المتعددة — رسائل قالب تحتوي على معلومات حول ما يصل إلى 30 منتجًا من كتالوج التجارة الإلكترونية، منظمة في ما يصل إلى 10 أقسام في رسالة واحدة.

رسائل الكتالوج

رسائل الكتالوج هي رسائل حرة تسمح لك بعرض كتالوج المنتجات بالكامل ضمن واتساب.

تعرض رسائل الكتالوج صورة عنوان لصورة مصغرة للمنتج من اختيارك ونص رئيسي مخصص وعنوان نصي ثابت وعنوان فرعي نصي ثابت وزر عرض الكتالوج.

عندما يضغط العميل على زر عرض الكتالوج، سيظهر كتالوج المنتجات ضمن واتساب.

المتطلبات

يجب تحميل المخزون على Meta في كتالوج التجارة الإلكترونية المرتبط بحساب واتساب للأعمال.

بنية الطلب

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

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

نص المنشور

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<TO>",
  "type": "interactive",
  "interactive" : {
    "type" : "catalog_message",
    "body" : {
      "text": "<BODY_TEXT>"
    },
    "action": {
      "name": "catalog_message",
      
      /* Parameters object is optional */
      "parameters": {
        "thumbnail_product_retailer_id": "<THUMBNAIL_PRODUCT_RETAILER_ID>"
      }
    },

    /* Footer object is optional */
    "footer": {
      "text": "<FOOTER_TEXT>"
  }
}

الخصائص

عينة من الطلب

curl 'https://graph.facebook.com/v17.0/106540352242922/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "+16505551234",
  "type": "interactive",
  "interactive": {
    "type": "catalog_message",
    "body": {
      "text": "Hello! Thanks for your interest. Ordering is easy. Just visit our catalog and add items to purchase."
    },
    "action": {
      "name": "catalog_message",
      "parameters": {
        "thumbnail_product_retailer_id": "2lc20305pt"
      }
    },
    "footer": {
      "text": "Best grocery deals on WhatsApp!"
    }
  }
}'

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

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "+16505551234",
      "wa_id": "16505551234"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBI0ODVEREUwQzEzQkVBRjQ1RUUA"
    }
  ]
}

رسائل قالب الكتالوج

رسائل قالب الكتالوج هي رسائل قالب تحتوي على زر يعرض كتالوج المنتجات ضمن واتساب عندما يتم الضغط عليه.

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

رسائل رابط الكتالوج

يمكنك إرسال رابط لكتالوج المنتجات بالكامل عن طريق تجميع رابط wa.me وتضمينه في رسالة نصية قياسية. عند إرسال رسالة نصية، يمكنك استخدام preview_url الاختياري مع تعيينه على true لجعل الرسالة تعرض مجموعة من الصور المصغرة في كتالوج المنتجات لأي عنوان URL في سلسلة body للرسالة.

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

لتجميع رابط wa.me، يمكنك إلحاق رقم هاتف النشاط التجاري، بما في ذلك كود البلد في نهاية السلسلة التالية:

https://wa.me/c/

على سبيل المثال:

https://wa.me/c/15555455657

رسائل المنتجات

تُعد كل من رسائل المنتجات المتعددة ورسائل المنتج الواحد أنواع من رسائل interactive.

مثال على رسالة منتجات متعددة:	مثال على رسالة منتج واحد:
القائمة التي يتم تشغيلها عندما ينقر المستخدم على بدء التسوق:	مثال على صفحة تفاصيل المنتج:

نظرة عامة

بإمكان العملاء الذين يتلقون رسائل منتجات متعددة ورسائل منتج واحد تنفيذ 3 إجراءات أساسية:

1. عرض المنتجات: يمكن للعملاء عرض قائمة منتجات أو منتج واحد فقط. عندما ينقر العميل على عنصر محدد، تظهر أحدث معلومات حول المنتج ونعرض المنتج بتنسيق صفحة تفاصيل المنتج (PDP). لا تدعم صفحات PDP حاليًا إلا صور المنتجات — أي لن يتم عرض أي مقاطع فيديو و/أو صور GIF تمت إضافتها إلى المنتج في صفحة PDP.
2. إضافة المنتجات إلى عربة تسوق: عندما يضيف المستخدم منتجًا إلى عربة التسوق، نعرض أحدث معلومات حول العنصر. إذا حدث تغيير في حالة أي من العناصر، فسنعرض مربع حوار يتضمن الرسالة "تم تحديث عنصر واحد أو أكثر في عربة التسوق" — راجع تحديثات المنتج لمزيد من المعلومات. تظل عربة التسوق في سلسلة الدردشة بينك وبين العميل حتى يتم إرسال عربة التسوق إليك — راجع تجربة عربة التسوق لمزيد من التفاصيل.
3. إرسال عربة التسوق إليك: بعد إضافة جميع العناصر المطلوبة، يمكن للعملاء إرسال عربة التسوق إليك. بعد ذلك، ستتمكن من تحديد الخطوات التالية، مثل طلب معلومات التسليم أو توفير خيارات الدفع.

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

في الوقت الحالي، يمكن تلقي هذه الأنواع من الرسائل في المنصات التالية:

• iOS: 2.21.100 (رسائل المنتجات المتعددة) و2.21.210 (رسائل المنتج الواحد).
• Android: 2.21.9.15 (رسائل المنتجات المتعددة) و2.21.19 (رسائل المنتج الواحد).
• الويب: تم طرح عميل الويب الذي يدعم هذه الميزات.

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

السلوك المتوقع للرسائل

يمكن إجراء ما يلي بالنسبة لرسائل المنتجات المتعددة ورسائل المنتج الواحد:

• إعادة توجيهها من جانب مستخدم إلى آخر.
• إعادة فتحها من جانب مستخدم موجود ضمن المحادثة ذاتها.

لا يمكن إجراء ما يلي بالنسبة لرسائل المنتجات المتعددة ورسائل المنتج الواحد:

• إرسالها كإشعارات. لا يمكن إرسالها إلا كجزء من محادثات موجودة.

التقييدات

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

تحديثات المنتجات

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

تجربة عربة التسوق

بعد عرض المنتجات، يمكن للعميل إضافتها إلى عربة التسوق وإرسال عربة التسوق هذه إليك. لأغراض المعاملات التجارية في واتساب، تكون عربة التسوق:

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

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

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

مثال على تجربة عربة التسوق والسلوك المتوقع لتغيير حالة العنصر.

مزايا الاستخدام

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

بسيطة وفعّالة

الجمع بين الميزات وأدوات التنقل مثل معالجة اللغة الطبيعية أو البحث عن النص أو رسائل قائمة المعروضات وأزرار الرد للوصول إلى ما يبحث عنه العميل بسرعة.

التخصيص

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

نتائج النشاط التجاري

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

بدون قوالب

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

متى يمكن استخدامها

تُعد رسائل المنتجات المتعددة أفضل خيار لتوجيه العملاء إلى مجموعة فرعية محددة من المخزون المتوفر لديك، مثل:

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

تُعد رسائل المنتج الواحد أفضل خيار لتوجيه العملاء إلى عنصر واحد محدد من المخزون المتوفر لديك، حيث توفر ردودًا سريعة من مجموعة محدودة من الخيارات، مثل:

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

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

البدء

قبل إرسال رسائل المنتجات، اتبع دليل بدء الاستخدام الأنسب لاحتياجاتك:

• بدء الاستخدام للأشخاص الذين يطوّرون التجارب لصالح أنفسهم أو مؤسستهم
• دليل بدء الاستخدام لشركاء الحلول

يجب مصادقة كل استدعاءات API المذكورة في هذا الدليل باستخدام رمز وصول. بإمكان المطوّرين مصادقة استدعاءات API باستخدام رمز الوصول الذي تم إنشاؤه في لوحة معلومات التطبيق > واتساب > لوحة إعداد API. يجب على شركاء الحلول مصادقة أنفسهم باستخدام رمز وصول يتضمن الإذن whatsapp_business_messaging.

الخطوة الأولى: تكوين الكائن التفاعلي

رسائل المنتج الواحد

لإرسال رسالة منتج واحد، يمكنك تكوين كائن interactive من النوع product يتضمن المكونات التالية:

راجع الرسائل، الكائن التفاعلي للحصول على معلومات كاملة. في نهاية العملية، من المفترض أن يبدو الكائن التفاعلي كما يلي:

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "interactive",
  "interactive": {
    "type": "product",
    "body": {
      "text": "BODY_TEXT"
    },
    "footer": {
      "text": "FOOTER_TEXT"
    },
    "action": {
      "catalog_id": "CATALOG_ID",
      "product_retailer_id": "ID_TEST_ITEM_1"
    }
  }
}

رسائل المنتجات المتعددة

لإرسال رسالة منتجات متعددة، يمكنك تكوين كائن interactive من النوع product_list يتضمن المكونات التالية:

راجع الرسائل، الكائن التفاعلي للحصول على معلومات كاملة. في نهاية العملية، من المفترض أن يبدو الكائن التفاعلي كما يلي:

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "interactive",
  "interactive": {
    "type": "product_list",
    "header":{
      "type": "text",
      "text": "HEADER_CONTENT"
    },
    "body": {
      "text": "BODY_CONTENT"
    },
    "footer": {
      "text": "FOOTER_CONTENT"
    },
    "action": {
      "catalog_id": "CATALOG_ID",
      "sections": [
        {
          "title": "SECTION_TITLE",
          "product_items": [
            { "product_retailer_id": "PRODUCT-SKU" },
            { "product_retailer_id": "PRODUCT-SKU" },
            ...
          ]

        },
        {
          "title": "SECTION_TITLE",
          "product_items": [
            { "product_retailer_id": "PRODUCT-SKU" },
            { "product_retailer_id": "PRODUCT-SKU" },
            ...
          ]
        }
      ]
    }
  }
}

العناصر المفقودة

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

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

• يتم إرسال الرسائل بنجاح
• يتم تجاهل العناصر غير المتطابقة
• تتلقى رسالة خطأ تطلب تحديث الكتالوج

الخطوة الثانية: إضافة معلمات الرسائل الشائعة

بمجرد إكمال الكائن التفاعلي، يمكنك إلحاق المعلمات الأخرى التي تكون الرسالة: recipient_type وto وmessaging_product وtype. لا تنس تعيين type على interactive.

curl -X  POST https://graph.facebook.com/v19.0/FROM_PHONE_NUMBER/messages \
 -H 'Authorization: Bearer ACCESS_TOKEN' \
 - d '{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "interactive",
  "interactive": {
  // INTERACTIVE OBJECT GOES HERE    
}'

للحصول على كل المعلمات المتوفرة، راجع المرجع، الرسائل.

الخطوة الثالثة: إرسال طلب إلى نقطة نهاية الرسائل

أرسل طلب POST إلى نقطة النهاية /PHONE_NUMBER_ID/messages تتضمن كائن JSON الذي تم تكوينه في الخطوتين 1 و2. إذا تم إرسال الرسالة بنجاح، فستحصل على الاستجابة التالية:

{
  "messaging_product": "whatsapp",
  "contacts": [{
      "input": "PHONE_NUMBER",
      "wa_id": "WHATSAPP_ID",
    }]
  "messages": [{
      "id": "wamid.ID",
    }]
}

قوالب رسائل المنتجات المتعددة

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