Versi Graph API

Pesan

Pesan individu dalam percakapan Messenger atau percakapan pengiriman pesan Instagram.

Untuk mendapatkan ID pesan, gunakan endpoint percakapan atau Webhooks untuk mengambil ID pesan individu.

Membaca

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
}];

Persyaratan

Jenis	Deskripsi
Tinjauan Aplikasi	Diperlukan untuk mengakses data bagi orang yang tidak memiliki peran di aplikasi Anda, seperti: developer, penguji, atau admin
Fitur	Tidak berlaku
Token	Token akses Halaman dari orang yang dapat melakukan tugas `MODERATE` atau `MESSAGING` di Halaman yang sedang di-kueri atau tertaut ke akun Profesional Instagram.
Izin	Izin `pages_messaging` dan `pages_manage_metadata` Izin `instagram_basic` dan `instagram_manage_messaging` juga diperlukan untuk Berkirim Pesan di Instagram

Batasan

Untuk Berkirim Pesan di Instagram

Hanya akun Profesional Instagram dengan Halaman Facebook tertaut yang dapat mengakses endpoint ini.
Saat meng-kueri endpoint ini, semua pesan untuk percakapan ini akan ditampilkan. Namun, Anda hanya dapat melakukan kueri data untuk 20 pesan terbaru dalam percakapan. Jika pesan tidak berada dalam 20 yang terbaru, kesalahan akan ditampilkan, menyatakan bahwa pesan telah dihapus.

Kolom

Jika kolom tidak memiliki data, kolom tidak akan ditampilkan dalam tanggapan JSON.

Nama Deskripsi

attachments.data

array

file_url

generic_template

id

image_data

name

video_data

Media, seperti gambar, video, atau file URL CDN, terlampir pada pesan.

URL file yang terlampir pada pesan

URL gambar yang terlampir pada pesan. Dapat menyertakan pasangan kode:nilai berikut:

cta: object dengan title, type, url
medial_url: string, URL untuk gambar

subtitle: string, dalam piksel
title: string

ID lampiran

URL gambar yang terlampir pada pesan. Dapat menyertakan pasangan kode:nilai berikut:

animated_gif_preview_url: string, URL untuk pratinjau GIF
animated_gif_url: string, URL untuk GIF
height: bilangan bulat, dalam piksel
max_height: bilangan bulat, dalam piksel
max_width: bilangan bulat, dalam piksel

preview_url: string, Pratinjau untuk URL
render_as_sticker: bool, true (benar) atau false (salah)
url: string, URL untuk gambar
width: bilangan bulat, dalam piksel

Nama lampiran

URL video yang terlampir pada pesan

created_time

datetime

Waktu pesan dibuat

from

objek

id

email

name

username

Informasi tentang siapa yang mengirim pesan. Dapat berupa orang, Halaman, atau akun Profesional Instagram

ID dapat berupa ID lingkup Instagram atau ID lingkup Halaman untuk orang atau ID Halaman atau ID akun Profesional Instagram untuk bisnis Anda.

Email seseorang atau Halaman Facebook. Hanya Berkirim Pesan di Halaman

Nama seseorang atau Halaman Facebook. Hanya Berkirim Pesan di Halaman

Nama pengguna untuk seseorang di Instagram atau akun Profesional Instagram Anda. Hanya Berkirim Pesan di Instagram

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

id

string

ID pesan

is_unsupported

Boolean

Hanya ditampilkan ketika true; sebuah pesan berisi konten yang tidak didukung.

message

string

Konten teks pesan tersebut. Jika tidak ada teks yang menjadi bagian dari pesan, ini akan kosong.

reactions

array

data array

reaction emoji

users array objek

id

username

Jenis tanggapan yang diterima pesan dengan daftar semua orang yang menanggapi dengan jenis tanggapan itu.

Array objek tanggapan

Jenis emoji tanggapan

Daftar orang yang telah menanggapi pesan

ID tersebut bisa berupa ID lingkup Instagram untuk seseorang di Instagram atau ID akun Profesional Instagram untuk bisnis Anda.

Nama pengguna untuk seseorang di Instagram atau akun Profesional Instagram Anda. Hanya Berkirim Pesan di Instagram

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

shares

array

Media yang dibagikan, seperti template produk atau postingan, disertakan dalam pesan. Harap diperhatikan, untuk objek yang dibagikan Anda perlu meminta sub-kolom juga untuk mengambil data.

"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

array

Tautan dan ID cerita. Hanya penyebutan dan balasan yang didukung.

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

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

tags

objek

Array data berisi nama untuk tanda yang menunjukkan folder pesan dan sumber pesan.

Untuk Halaman Facebook, name dapat berupa inbox, read, source:chat,

to

objek

data array

id

email

name

username

Informasi tentang siapa yang menerima pesan

ID dapat berupa ID lingkup Instagram atau ID lingkup Halaman untuk orang atau ID Halaman atau ID akun Profesional Instagram untuk bisnis Anda.

Email seseorang atau Halaman Facebook. Hanya Berkirim Pesan di Halaman

Nama seseorang atau Halaman Facebook. Hanya Berkirim Pesan di Halaman

Nama pengguna untuk seseorang di Instagram atau akun Profesional Instagram Anda. Hanya Berkirim Pesan di Instagram

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

Edge

Nama	Deskripsi
`/attachments`	File yang terlampir pada pesan.
`/shares`	Item yang dibagikan, termasuk tautan, foto, video, stiker, dan produk.

Membuat

Anda tidak dapat melakukan operasi ini di endpoint ini.

Memperbarui

Anda tidak dapat melakukan operasi ini di endpoint ini.

Menghapus

Anda tidak dapat melakukan operasi ini di endpoint ini.