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

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

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

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

لإرسال رد سريع، أضف المصفوفة quick_replies إلى رسالة نصية وقم بتضمين الكائنات التي تحدد ما يصل إلى 13 زرًا للرد السريع.

وفيما يلي أنواع الردود السريعة المدعومة:

• النص
• رقم الهاتف
• البريد الإلكتروني

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>"    

الرد السريع النصي

كما يمكن إرسال الردود السريعة النصية مزوّدة بصورة اختيارية تظهر كأيقونة بجوار العنوان. وإذا تم تحديد content_type للرد السريع باعتباره text، فيلزم تحديد title غير فارغ.

البنية

{
  "content_type":"text",
  "title":"<BUTTON_TEXT>",
  "image_url":"http://example.com/img/red.png",
  "payload":"<DEVELOPER_DEFINED_PAYLOAD>"
}

حدث Webhook

عند الضغط على زر الرد السريع، سيتم إرسال رسالة نصية إلى استدعاء استلام الرسالة لحدث webhook.

وستتوافق الخاصية text التابعة للحدث مع عنوان الرد السريع. كما سيحتوي كائن الرسالة على حقل باسم quick_reply يحتوي على بيانات payload في الرد السريع.

{
  "object": "page",
  "entry": [
    {
      "id": "<PAGE_ID>",
      "time": 1502905976963,
      "messaging": [
        {
          "sender": {
            "id": "1254459154682919"
          },
          "recipient": {
            "id": "682498171943165"
          },
          "timestamp": 1502905976377,
          "message": {
            "quick_reply": {
              "payload": "DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_GREEN"
            },
            "mid": "m_AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P",
            "text": "Green"
          }
        }
      ]
    }
  ]
}

الرد السريع لطلب رقم هاتف المستخدم

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

إذا لم يكن الملف الشخصي للمستخدم يحتوي على رقم الهاتف، فلن يظهر الرد السريع.

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

يؤدي اختيار الرد السريع إلى إرسال المعلومات مرة واحدة فقط ولا يتضمن إذنًا بالوصول إلى المعلومات مرة أخرى في المستقبل.

البنية

{
  "content_type":"user_phone_number"
}

حدث Webhook

عندما يضغط المستخدم على الرد السريع، سيتم إدخال رقم الهاتف ضمن السمة payload في حدث messages webhook.

{
  "object": "page",
  "entry": [
    {
      "id": "

الرد السريع لطلب البريد الإلكتروني للمستخدم

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

إذا لم يكن الملف الشخصي للمستخدم يحتوي على عنوان بريد إلكتروني، فلن يظهر الرد السريع.

ولن يتلقى البرنامج التلقائي البريد الإلكتروني إلا بعد أن يقوم المستخدم بالنقر على الرد السريع.

يؤدي اختيار الرد السريع إلى إرسال المعلومات مرة واحدة فقط ولا يتضمن إذنًا بالوصول إلى المعلومات مرة أخرى في المستقبل.

البنية

{
  "content_type":"user_email"
}

حدث Webhook

عندما يضغط المستخدم على الرد السريع، سيتم إدخال عنوان البريد الإلكتروني ضمن السمة payload في حدث messages webhook.

{
  "object": "page",
  "entry": [
    {
      "id": "

أفضل الممارسات