เวอร์ชันของ API กราฟ

ข้อความ

ข้อความแต่ละรายการในการสนทนาผ่านการส่งข้อความบน Messenger หรือ Instagram

หากต้องการรับ ID ข้อความ ให้ใช้ตำแหน่งข้อมูลการสนทนาหรือ Webhooks เพื่อเรียกดู ID ข้อความแต่ละรายการ

การอ่าน

GET /v21.0/{message-id} HTTP/1.1
Host: graph.facebook.com

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{message-id}',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

/* make the API call */
FB.api(
    "/{message-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{message-id}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{message-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

ข้อกำหนด

ประเภท	คำอธิบาย
การตรวจสอบแอพ	คุณจำเป็นต้องมีการเข้าถึงข้อมูลสำหรับผู้ที่ไม่มีบทบาทในแอพของคุณ เช่น ผู้พัฒนา ผู้ทดสอบ หรือผู้ดูแล
ฟีเจอร์	ไม่สามารถใช้งานได้
โทเค็น	โทเค็นการเข้าถึงเพจจากบุคคลที่สามารถดำเนินงาน `MODERATE` หรือ `MESSAGING` บนเพจที่มีการสืบค้นหรือลิงก์กับบัญชีมืออาชีพบน Instagram
สิทธิ์การอนุญาต	สิทธิ์การอนุญาต `pages_messaging` และ `pages_manage_metadata` นอกจากนี้ยังต้องมีสิทธิ์การอนุญาต `instagram_basic` และ `instagram_manage_messaging` สำหรับการส่งข้อความบน Instagram

ข้อจำกัด

สำหรับการส่งข้อความบน Instagram

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

ช่อง

หากช่องไม่มีข้อมูล ระบบจะไม่ส่งข้อมูลกลับมาในการตอบกลับ JSON

ชื่อ คำอธิบาย

attachments.data

อาร์เรย์

file_url

generic_template

id

image_data

name

video_data

สื่อ เช่น URL CDN ของรูปภาพ วิดีโอ หรือไฟล์ที่แนบมากับข้อความ

URL สำหรับไฟล์ที่แนบมากับข้อความ

URL สำหรับรูปภาพที่แนบมากับข้อความ สามารถใส่คู่คีย์:ค่าต่อไปนี้ได้

cta: อ็อบเจ็กต์ที่มี title, type, url
medial_url: สตริง, URL สำหรับรูปภาพ

subtitle: สตริง, มีหน่วยเป็นพิกเซล
title: สตริง,

ID ของไฟล์แนบ

URL สำหรับรูปภาพที่แนบมากับข้อความ คุณสามารถใส่คู่ คีย์:ค่า ต่อไปนี้ได้:

animated_gif_preview_url: สตริง, URL สำหรับภาพตัวอย่างของ GIF
animated_gif_url: สตริง, URL สำหรับ GIF
height: จำนวนเต็ม, มีหน่วยเป็นพิกเซล
max_height: จำนวนเต็ม, มีหน่วยเป็นพิกเซล
max_width: จำนวนเต็ม, มีหน่วยเป็นพิกเซล

preview_url: สตริง, ภาพตัวอย่างสำหรับ URL
render_as_sticker: บูลีน, true หรือ false
url: สตริง, URL สำหรับรูปภาพ
width: จำนวนเต็ม, มีหน่วยเป็นพิกเซล

ชื่อสำหรับไฟล์แนบ

URL สำหรับวิดีโอที่แนบมากับข้อความ

created_time

วันที่และเวลา

เวลาที่สร้างข้อความขึ้น

from

อ็อบเจ็กต์

id

email

name

username

ข้อมูลเกี่ยวกับผู้ที่ส่งข้อความ โดยอาจเป็นบุคคล เพจ หรือบัญชีมืออาชีพบน Instagram

ID อาจเป็น ID ใน Instagram หรือ ID ในเพจสำหรับผู้ใช้ หรืออาจเป็น ID ของเพจหรือ ID บัญชีมืออาชีพบน Instagram สำหรับธุรกิจของคุณ

อีเมลของบุคคลหรือเพจ Facebook การส่งข้อความบนเพจเท่านั้น

ชื่อของบุคคลหรือเพจ Facebook การส่งข้อความบนเพจเท่านั้น

ชื่อผู้ใช้ของบุคคลใน Instagram หรือบัญชีมืออาชีพบน Instagram ของคุณ การส่งข้อความบน Instagram เท่านั้น

"from": {
    "username": "INSTAGRAM-USERNAME",
    "id": "ID"
  }

id

สตริง

ID ของข้อความ

is_unsupported

บูลีน

ส่งคืนเมื่อเป็น true เท่านั้น โดยข้อความมีเนื้อหาที่ไม่รองรับ

message

สตริง

เนื้อหาที่เป็นตัวอักษรของข้อความ ส่วนนี้จะว่างหากข้อความไม่มีตัวอักษร

reactions

อาร์เรย์

data อาร์เรย์

reaction อีโมจิ

users อาร์เรย์ของอ็อบเจ็กต์

id

username

ประเภทของความรู้สึกที่ข้อความได้รับพร้อมรายชื่อทุกคนที่แสดงความรู้สึกด้วยความรู้สึกประเภทนั้นๆ

อาร์เรย์ของอ็อบเจ็กต์ความรู้สึก

ประเภทอีโมจิแสดงความรู้สึก

รายชื่อบุคคลที่แสดงความรู้สึกกับข้อความ

ID อาจเป็น ID ใน Instagram สำหรับบุคคลใน Instagram หรืออาจเป็น ID บัญชีมืออาชีพบน Instagram สำหรับธุรกิจของคุณ

"reactions":
  {
    "reaction": "❤️",
    "users" : [
      {
        "username": "INSTAGRAM-USERNAME",
        "id": "ID", 
      },
    ]
  }

shares

อาร์เรย์

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

"shares": {
  "data": [{
    "template": {
      "payload":{
        "product": {
           "elements":{     //Can contain multiple products if applicable
             "data": [
              {
                "id" : "PRODUCT-ID",    // 0 if business can't see this product
                "retailer_id": "ID-ASSIGNED-BY-THE-RETAILER", 
                "image_url" : "IMAGE-URL", 
                "name" : "PRODUCT-NAME",
                "price" : "$10"
              },
            ],
          }
        }
      }
    }
  }]
}

story

อาร์เรย์

ลิงก์และ ID ของสตอรี่ รองรับเฉพาะการกล่าวถึงและข้อความตอบกลับเท่านั้น

StoryReply: 
{
    "link": "CDN-URL",
    "id": "STORY-ID"
}

StoryMention: 
{
    "link": "CDN-URL",
    "id": "STORY-ID"
}

tags

อ็อบเจ็กต์

อาร์เรย์ data ที่มีชื่อของแท็กที่ระบุถึงโฟลเดอร์ข้อความและแหล่งที่มาของข้อความ

สำหรับเพจ Facebook name อาจเป็น inbox, read, source:chat

to

อ็อบเจ็กต์

data อาร์เรย์

id

email

name

username

ข้อมูลเกี่ยวกับผู้ที่รับข้อความ

อีเมลของบุคคลหรือเพจ Facebook การส่งข้อความบนเพจเท่านั้น

ชื่อของบุคคลหรือเพจ Facebook การส่งข้อความบนเพจเท่านั้น

"to": {
  "data": [
    { 
      "username": "INSTAGRAM-USERNAME", 
      "id": "ID" 
    }
  ]
}

จุดเชื่อมโยง

ชื่อ	คำอธิบาย
`/attachments`	ไฟล์ที่แนบมากับข้อความ
`/shares`	รายการที่แชร์ ซึ่งรวมถึงลิงก์ รูปภาพ วิดีโอ สติกเกอร์ และสินค้า

สร้าง

คุณไม่สามารถดำเนินการนี้กับตำแหน่งข้อมูลนี้ได้

อัพเดต

คุณไม่สามารถดำเนินการนี้กับตำแหน่งข้อมูลนี้ได้

ลบ

คุณไม่สามารถดำเนินการนี้กับตำแหน่งข้อมูลนี้ได้