ข้อความตอบกลับด่วน

ข้อความตอบกลับด่วนช่วยให้คุณสามารถนำเสนอชุดปุ่มได้สูงสุดถึง 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/v21.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 จะกรอกข้อความตอบกลับด่วนที่แสดงขึ้นไว้ล่วงหน้าด้วยหมายเลขโทรศัพท์จากข้อมูลโปรไฟล์ของผู้ใช้โดยอัตโนมัติ

หากโปรไฟล์ของผู้ใช้ไม่มีหมายเลขโทรศัพท์ ระบบจะไม่แสดงข้อความตอบกลับด่วน

บอทจะไม่ได้รับหมายเลขโทรศัพท์จนกว่าผู้ใช้จะคลิกที่ข้อความตอบกลับด่วน

การเลือกข้อความตอบกลับด่วนจะเป็นการส่งข้อมูล 1 ครั้ง และไม่ถือเป็นการให้สิทธิ์การอนุญาตในการเข้าถึงข้อมูลในอนาคต

รูปแบบคำสั่ง

{
  "content_type":"user_phone_number"
}

เหตุการณ์ Webhook

เมื่อผู้ใช้แตะที่ข้อความตอบกลับด่วน ระบบจะส่งผ่านหมายเลขโทรศัพท์ในแอตทริบิวต์ payload ของเหตุการณ์ Webhook messages

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

ข้อความตอบกลับด่วนแบบอีเมลของผู้ใช้

ข้อความตอบกลับด่วนแบบอีเมลของผู้ใช้ช่วยให้คุณสามารถขออีเมลของผู้ใช้ได้ เมื่อมีการส่งข้อความตอบกลับด่วนแบบอีเมล แพลตฟอร์ม Messenger จะกรอกข้อความตอบกลับด่วนที่แสดงขึ้นไว้ล่วงหน้าด้วยอีเมลจากข้อมูลโปรไฟล์ของผู้ใช้โดยอัตโนมัติ

หากโปรไฟล์ของผู้ใช้ไม่มีอีเมล ระบบจะไม่แสดงข้อความตอบกลับด่วน

บอทจะไม่ได้รับอีเมลจนกว่าผู้ใช้จะคลิกที่ข้อความตอบกลับด่วน

การเลือกข้อความตอบกลับด่วนจะเป็นการส่งข้อมูล 1 ครั้ง และไม่ถือเป็นการให้สิทธิ์การอนุญาตในการเข้าถึงข้อมูลในอนาคต

รูปแบบคำสั่ง

{
  "content_type":"user_email"
}

เหตุการณ์ Webhook

เมื่อผู้ใช้แตะที่ข้อความตอบกลับด่วน ระบบจะส่งผ่านอีเมลในแอตทริบิวต์ payload ของเหตุการณ์ Webhook messages

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

หลักปฏิบัติที่ดีที่สุด

ใช้ข้อความตอบกลับด่วนเพื่อแจ้งให้ทำขั้นตอนต่อๆ ไปที่เฉพาะเจาะจง

ใช้ข้อความที่สั้นกระชับ — ระบบจะตัดข้อความตอบกลับด่วนที่ยาวให้สั้นลง

อย่าใช้สำหรับการดำเนินการที่คุณต้องการให้คงอยู่ถาวร เพราะข้อความตอบกลับด่วนจะหายไปเมื่อมีการส่งข้อความถัดจากนั้น

การสนับสนุนสำหรับผู้พัฒนา