API โปรไฟล์ Messenger

โปรไฟล์ Messenger สำหรับเพจของคุณเป็นจุดที่คุณสามารถตั้งค่าคุณสมบัติที่กำหนดฟีเจอร์ของแพลตฟอร์ม Messenger ต่อไปนี้ในด้านต่างๆ ได้ โปรดดูข้อมูลเพิ่มเติมที่ตารางคุณสมบัติของโปรไฟล์ Messenger ด้านล่าง

• ปุ่มเริ่มต้นใช้งาน
• หน้าต้อนรับ
• ประโยคเริ่มการสนทนา
• เมนูถาวร
• ไวท์ลิสต์สำหรับโดเมน
• การลิงก์บัญชี
• คำสั่ง
• แท็บค้นพบ (ยกเลิกการใช้งานแล้ว)

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

สิทธิ์การอนุญาต

ต้องใช้โทเค็นการเข้าถึงเพจที่มีสิทธิ์การอนุญาต pages_messaging เพื่อโต้ตอบกับตำแหน่งข้อมูลนี้

ในกรณีที่เป็นแอพในโหมดการพัฒนา การตั้งค่าโปรไฟล์ Messenger จะปรากฏต่อผู้ที่มีบทบาทในแอพดังกล่าวเท่านั้น

URI คำขอ

https://graph.facebook.com/v21.0/me/messenger_profile?access_token=<PAGE_ACCESS_TOKEN>

คุณสมบัติของโปรไฟล์ Messenger

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

เรียกดูคุณสมบัติ

เรียกดูค่าปัจจุบันของคุณสมบัติของโปรไฟล์ Messenger อย่างน้อย 1 รายการตามชื่อ

พารามิเตอร์คำขอ

พารามิเตอร์ต่อไปนี้รวมอยู่ในสตริงการสืบค้นของคำขอ

ตัวอย่างคำขอ

curl -X GET "https://graph.facebook.com/v21.0/me/messenger_profile?fields=whitelisted_domains,greeting&access_token=<PAGE_ACCESS_TOKEN>"

ตัวอย่างการตอบสนอง

ระบบจะส่งคืนค่าปัจจุบันของคุณสมบัติที่ได้รับการขอในอาร์เรย์ data

{
   "data": [
        {
          "whitelisted_domains": [
            "https://facebook.com/"
          ],
          "greeting": [
            {
               "locale": "default",
               "text": "Hello!"
            },
            {
               "locale": "en_US",
               "text": "Timeless apparel for the masses."
            }
         ]
      }
   ]
}

ตั้งค่า/อัพเดตคุณสมบัติ

ตั้งค่าปัจจุบันของคุณสมบัติของโปรไฟล์ Messenger อย่างน้อย 1 รายการ ระบบจะเขียนทับเฉพาะคุณสมบัติที่ตั้งค่าไว้ในเนื้อความของคำขอเท่านั้น

ตัวอย่างคำขอ

curl -X POST -H "Content-Type: application/json" -d '{
  "<PROPERTY_NAME>": "<NEW_PROPERTY_VALUE>",
  "<PROPERTY_NAME>": "<NEW_PROPERTY_VALUE>",
  ...
}' "https://graph.facebook.com/v21.0/me/messenger_profile?access_token=<PAGE_ACCESS_TOKEN>"

ตัวอย่างการตอบสนอง

{
    "result": "success"
}

ลบคุณสมบัติ

ลบคุณสมบัติของโปรไฟล์ Messenger อย่างน้อย 1 รายการ ระบบจะลบเฉพาะคุณสมบัติที่ระบุไว้ในอาร์เรย์ fields เท่านั้น

ตัวอย่างคำขอ

curl -X DELETE -H "Content-Type: application/json" -d '{
  "fields": [
    "<PROPERTY_NAME>",
    "<PROPERTY_NAME>",
    "<PROPERTY_NAME>",
    ...
  ]
}' "https://graph.facebook.com/v21.0/me/messenger_profile?access_token=<PAGE_ACCESS_TOKEN>"

ตัวอย่างการตอบสนอง

{
    "result": "success"
}