الردود السريعة

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

تحتوي الردود السريعة على نصوص. ويمكنك إضافة صور بشكل اختياري.

يمكنك أيضًا استخدام الردود السريعة لمطالبة الأشخاص بموقعهم.

مثال

نصوص فقط

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"USER_ID"
  },
  "message":{
    "text":"Pick a color:",
    "quick_replies":[
      {
        "content_type":"text",
        "title":"Red",
        "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_RED"
      },
      {
        "content_type":"text",
        "title":"Green",
        "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_GREEN"
      }
    ]
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=PAGE_ACCESS_TOKEN"    

نصوص وصور

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"USER_ID"
  },
  "message":{
    "text":"Pick a color:",
    "quick_replies":[
      {
        "content_type":"text",
        "title":"Red",
        "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_RED",
        "image_url":"http://petersfantastichats.com/img/red.png"
      },
      {
        "content_type":"text",
        "title":"Green",
        "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_GREEN",
        "image_url":"http://petersfantastichats.com/img/green.png"
      }
    ]
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=PAGE_ACCESS_TOKEN"    

الموقع

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"USER_ID"
  },
  "message":{
    "text":"Please share your location:",
    "quick_replies":[
      {
        "content_type":"location",
      }
    ]
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=PAGE_ACCESS_TOKEN"

الحقول

الكائن message

• الحد الأقصى لقيمة quick_replies هو 11

الكائن attachment

تعمل ميزة الردود السريعة مع جميع أنواع الرسائل بما في ذلك الرسائل النصية ومرفقات الصور والقوالب. يرجى الرجوع إلى وثائق API الإرسال لمزيد من المعلومات عن كيفية استخدام الكائن attachment.

الكائن quick_reply

• الحد الأقصى لعدد أحرف title هو 20 حرفًا وبعد ذلك يتم اقتطاعه
• الحد الأقصى لعدد أحرف payloadهو 1000 حرف
• إذا كان content_type هو location لا يُستخدم title وpayload
• يجب ألا تقل دقة صورة image_url عن 24×24 مع قابلية الاقتصاص وتغيير الحجم

الاستدعاء

عند الضغط على أحد الردود السريعة، يتم إرسال رسالة نصية إلى webhook لديك استدعاء تم استلام الرسالة. يتوافق نص الرسالة مع عنوان زر الرد السريع. يحتوي كائن الرسالة أيضًا على حقل باسم quick_reply يحتوي على بيانات payload في الرد السريع.

{
  "sender": {
    "id": "USER_ID"
  },
  "recipient": {
    "id": "PAGE_ID"
  },
  "timestamp": 1464990849275,
  "message": {
    "mid": "mid.1464990849238:b9a22a2bcb1de31773",
    "seq": 69,
    "text": "Red",
    "quick_reply": {
      "payload": "DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_RED"
    }
  }
}    

عند قيام الشخص بمشاركة موقعه، يظهر الاستدعاء بالشكل التالي:

{
  "object": "page",
  "entry": [
    {
      "id": "PAGE_ID",
      "time": 1472672934319,
      "messaging": [
        {
          "sender": {
            "id": "USER_ID"
          },
          "recipient": {
            "id": "PAGE_ID"
          },
          "timestamp": 1472672934259,
          "message": {
            "mid": "mid.1472672934017:db566db5104b5b5c08",
            "seq": 297,
            "attachments": [
              {
                "title": "Facebook HQ",
                "url": "https://www.facebook.com/l.php?u=https%....5-7Ocxrmg",
                "type": "location",
                "payload": {
                  "coordinates": {
                    "lat": 37.483872693672,
                    "long": -122.14900441942
                  }
                }
              }
            ]
          }
        }
      ]
    }
  ]
}