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

تسمح لك الردود السريعة بالحصول على إدخال مستلم الرسائل عن طريق إرسال الأزرار في رسالة. عند الضغط على رد سريع، يتم إرسال قيمة الزر في المحادثة، وترسل منصة Messenger حدث messages إلى حدث webhook لديك. الردود السريعة هي نوع رسالة يتم إرساله من خلال API الإرسال. للحصول على تفاصيل كاملة حول إرسال الرسائل، راجع الرسائل.

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

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

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "messaging_type": "RESPONSE",
  "message":{
    "text": "Pick a color:",
    "quick_replies":[
      {
        "content_type":"text",
        "title":"Red",
        "payload":"<POSTBACK_PAYLOAD>",
        "image_url":"http://example.com/img/red.png"
      },{
        "content_type":"text",
        "title":"Green",
        "payload":"<POSTBACK_PAYLOAD>",
        "image_url":"http://example.com/img/green.png"
      }
    ]
  }
}' "https://graph.facebook.com/v19.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

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

{
  "recipient_id": "1254477777772919",
  "message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}

الخصائص

الخاصية	النوع	الوصف
`text`	String (سلسلة)	نص رسالة غير فارغ يتم إرساله مع الردود السريعة. يجب تعيين `text` أو `attachment`.
`attachment`	Object (كائن)	مرفق يتم إرساله مع الردود السريعة. يجب تعيين `text` أو `attachment`.
`quick_replies`	Array (مصفوفة)<`quick_reply`>	مصفوفة كائنات تصف أزرار الرد السريع المطلوب إرسالها. يتم دعم 13 من الردود السريعة بحد أقصى.

`quick_reply`

الخاصية	النوع	الوصف
`content_type`	String (سلسلة)	يجب أن تكون واحدة مما يلي `text`: يرسل زرًا نصيًا `user_phone_number`: يرسل زرًا يسمح للمستلم بإرسال رقم الهاتف المرتبط بالحساب. `user_email`: يرسل زرًا يسمح للمستلم بإرسال البريد الإلكتروني المرتبط بالحساب.
`title`	String (سلسلة)	مطلوب إذا كان `content_type` "نصًا". يمثل النص الذي سيتم عرضه على زر الرد السريع. أقصى عدد للأحرف هو 20 حرفًا.
`payload`	String (سلسلة)، Number (رقم)	مطلوب إذا كان `content_type` "نصًا". البيانات المخصصة التي ستتم إعادة إرسالها إليك مرة أخرى عبر حدث webhook `messaging_postbacks`. علمًا بأن الحد الأقصى لعدد الأحرف هو 1000 حرف. يمكن تعيينه إلى سلسلة فارغة إذا تم تعيين `image_url`.
`image_url`	String (سلسلة)	*اختياري.* عنوان URL للصورة المطلوب عرضها على زر الرد السريع للردود السريعة النصية. يجب أن تكون الصورة بحد أدنى 24 بيكسل × 24 بيكسل. سيتم اقتصاص الصور الأكبر حجمًا وتغيير حجمها تلقائيًا. مطلوب إذا كان `title` يمثل سلسلة فارغة.