أدوات تشجيع التفاعل

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

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

تعيين أدوات تشجيع التفاعل

التنسيق الجديد (موصى به)

curl -X POST -H "Content-Type: application/json" -d '{
     "platform": "instagram",
     "ice_breakers":[
       {
          "call_to_actions":[
             {
                "question":"

التنسيق القديم (يجب ألا يتم استخدامه لإعداد أداة تشجيع التفاعل الجديدة)

curl -X POST -H "Content-Type: application/json" -d '{
  "platform": "instagram",
  "ice_breakers":[
     {
        "question": "

الحصول على أدوات تشجيع التفاعل

سيرجع طلب GET تنسيقًا مختلفًا، استنادًا إلى كيفية إعداد أداة تشجيع التفاعل. يتم تطبيق السلوك التالي:

• إذا تم إعداد أداة تشجيع التفاعل باستخدام التنسيق القديم، فسيرجع طلب GET استجابة بالتنسيق القديم.
• إذا تم إعداد أداة تشجيع التفاعل باستخدام التنسيق الجديد، فسيرجع طلب GET استجابة بالتنسيق الجديد.

نشجع المطوّرين على الترحيل إلى التنسيق الجديد حيث إننا سنعمل على إيقاف استخدام التنسيق القديم مستقبلاً.

curl -X GET "https://graph.facebook.com/v11.0/me/messenger_profile?fields=ice_breakers&platform=instagram&access_token=<PAGE_ACCESS_TOKEN>

استجابة التنسيق الجديد

{
   "data": [
        {
          "call_to_actions" : [
               {
                "question": "

استجابة التنسيق القديم

{
   "data": [
        {
          "ice_breakers": [
            {
                "question": "

حذف أدوات تشجيع التفاعل

curl -X DELETE -H "Content-Type: application/json" -d '{
  "fields": [
    "ice_breakers",
  ]
}' "https://graph.facebook.com/v11.0/me/messenger_profile?platform=instagram&access_token=%lt;PAGE_ACCESS_TOKEN>"

حدث Webhook

لتلقي أحداث webhooks مُعاد نشرها من أدوات التفاعل، يجب أن يشترك التطبيق في حدث webhook لـ messaging_postbacks بالإصدار 8.0 والإصدارات الأحدث ضمن موضوع Instagram حول إعدادات التطبيق.

سيتلقى حدث webhook حمولة بيانات بلغة json مماثلة للمثال أدناه.

{
  "object": "instagram",
  "entry": [
    {
      "id": "<IGID>",
      "time": 1502905976963,
      "messaging": [
        {
          "sender": {
            "id": "<IGSID>"
          },
          "recipient": {
            "id": "<IGID>"
          },
          "timestamp": 1502905976377,
          "postback": {
            "title": "<SELECTED_ICEBREAKER_QUESTION>",
            "payload": "<USER_DEFINED_PAYLOAD>",
          }
        }
      ]
    }
  ]
}