MasukMulai uji coba gratis
easyCoexistence API resmi

Membaca riwayat DM Instagram: Conversations API

Conversations API Instagram membaca riwayat DM akun profesional di graph.instagram.com. GET /me/conversations?platform=instagram mencantumkan percakapan beserta updated_time-nya, GET /<CONVERSATION_ID>?fields=messages mencantumkan pesan sebuah percakapan berdasarkan ID dan waktu, dan GET /<MESSAGE_ID>?fields=id,created_time,from,to,message mengembalikan satu pesan. Detail tersedia untuk 20 pesan terbaru di setiap percakapan.

easyCoexistence meneruskan DM Instagram baru ke endpoint Anda saat masuk, dan membalas dengan send_social_dm dalam jendela 24 jam, dari Claude, ChatGPT, atau kode Anda sendiri, di atas API resmi Meta; tidak ada tool untuk riwayat Conversations API.

20

Pesan terbaru per percakapan yang detailnya dikembalikan API; pesan yang lebih lama dijawab dengan kesalahan yang menyatakan pesan tersebut telah dihapus.

30 days

Batas waktu tanpa aktivitas, setelah itu percakapan di folder Requests tidak lagi dikembalikan.

2/sec

Panggilan Conversations API per detik yang dapat dilakukan aplikasi untuk setiap akun profesional Instagram.

2 permissions

instagram_business_basic dan instagram_business_manage_messages, pada token dari orang yang dapat mengelola pesan akun tersebut.

Bagaimana cara mencantumkan percakapan sebuah akun?

Dengan GET /me/conversations, atau /<IG_ID>/conversations, serta platform=instagram, menggunakan token akses Instagram User dari orang yang dapat mengelola pesan di akun tersebut. Setiap entri dalam array data adalah satu percakapan, dengan id dan updated_time-nya.

Listing conversations
GET https://graph.instagram.com/me/conversations
  ?platform=instagram
  &access_token=<ACCESS_TOKEN>

{
  "data": [
    { "id": "<CONVERSATION_ID>", "updated_time": "<UPDATED_TIME>" }
  ]
}

Bagaimana cara menemukan percakapan dengan satu orang?

Tambahkan user_id dengan ID yang dicakup Instagram milik orang tersebut, yaitu IGSID yang diterima sebagai sender.id saat mereka mengirim pesan ke akun. Respons akan mengembalikan id percakapan tersebut. Dengan cara ini, sebuah event webhook diubah menjadi utasnya tanpa menelusuri seluruh daftar halaman demi halaman.

One person's conversation
GET https://graph.instagram.com/me/conversations
  ?user_id=<IGSID>
  &access_token=<ACCESS_TOKEN>

Bagaimana cara membaca pesannya?

Dalam dua langkah. GET /<CONVERSATION_ID>?fields=messages mencantumkan pesan percakapan berdasarkan id dan created_time, yaitu field default. Lalu GET /<MESSAGE_ID> dengan fields=id,created_time,from,to,message mengembalikan satu pesan: siapa pengirimnya dan kepada siapa, masing-masing dengan username dan ID, serta teksnya.

A conversation's messages, then one message
GET https://graph.instagram.com/<CONVERSATION_ID>
  ?fields=messages
  &access_token=<ACCESS_TOKEN>

GET https://graph.instagram.com/<MESSAGE_ID>
  ?fields=id,created_time,from,to,message
  &access_token=<ACCESS_TOKEN>

Seberapa jauh ke belakang bisa dibaca?

Panduan dan ikhtisar Meta menetapkan empat batasan pada apa yang dikembalikan:

  • Detail pesan: 20 pesan terbaru di setiap percakapan; meminta pesan yang lebih lama mengembalikan kesalahan yang menyatakan pesan tersebut telah dihapus.
  • Requests: percakapan di folder Requests tanpa aktivitas selama 30 hari tidak dikembalikan.
  • Bagikan: postingan atau Reel yang dibagikan hanya dikembalikan sebagai URL gambar atau videonya.
  • Rate: 2 panggilan per detik untuk setiap akun profesional Instagram.

Apa yang dibutuhkan?

Dengan Instagram Login, izin instagram_business_basic dan instagram_business_manage_messages, serta token dari orang yang dapat mengelola pesan di akun tersebut. Standard Access cukup untuk akun yang Anda miliki atau kelola dan telah ditambahkan ke aplikasi; melayani akun lain membutuhkan Advanced Access. Akun juga harus mengaktifkan Allow access to messages di pengaturan aplikasi Instagram-nya.

Mengapa perlu menyimpan catatan dari webhook?

Karena API hanya mengembalikan detail untuk 20 pesan terbaru di setiap percakapan, riwayat lengkap harus disimpan seiring kejadiannya. Webhook messages mengirimkan DM saat masuk, dengan IGSID orang tersebut sebagai sender.id. Pesan yang dikirim akun juga datang, dengan ID yang dibalik, sehingga kedua sisi percakapan dapat direkam.

Bagaimana cara membaca riwayat DM melalui easyCoexistence?

Ia meneruskan DM, bukan membaca riwayat. DM baru sampai ke endpoint Anda saat masuk setelah Anda menetapkannya dengan set_social_webhook_destination, diteruskan tanpa salinan yang disimpan, dan send_social_dm membalas dalam jendela 24 jam, dari Claude, ChatGPT, atau kode Anda sendiri. Tidak ada tool yang memanggil me/conversations, jadi pesan sebelumnya dibaca di aplikasi Instagram, atau disimpan oleh sistem Anda sendiri saat masuk.

Kesalahan umum

  • Mengharapkan seluruh utas dari API. Detailnya berhenti pada 20 pesan terbaru, jadi simpan DM dari webhook messages seiring kedatangannya.
  • Melakukan polling percakapan untuk mencari DM baru. API mengizinkan 2 panggilan per detik per akun, sedangkan webhook messages mengirimkan setiap DM saat masuk.
  • Mencari permintaan pesan lama. Percakapan di Requests dengan 30 hari tanpa aktivitas tidak lagi dikembalikan.
  • Membaca kesalahan yang menyatakan pesan telah dihapus sebagai penghapusan oleh orang tersebut. Meta menjawab begitu untuk pesan apa pun yang lebih lama dari 20 pesan terbaru.
Melakukan ini dengan EasyCoexistence

US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Bisakah saya mengekspor seluruh riwayat DM sebuah akun Instagram?

Tidak secara lengkap melalui API: API mencantumkan percakapan tetapi hanya mengembalikan detail untuk 20 pesan terbaru di setiap percakapan. Catatan lengkap diperoleh dengan menyimpan DM seiring webhook mengirimkannya.

Apakah membaca pesan melalui API menandainya sebagai sudah dibaca?

Tidak. Meta menyatakan pesan yang diambil melalui API tidak ditandai sudah dibaca di aplikasi Instagram sampai balasan dikirim.

Apakah Conversations API bekerja dengan Instagram Login?

Ya. Panduan Meta untuknya ditulis untuk Instagram Login, dengan panggilan ke graph.instagram.com dan izin instagram_business_*.

Bagaimana cara mendapatkan username seseorang dari sebuah percakapan?

Minta from pada sebuah pesan, yang mengembalikan username dan ID pengirim. User Profile API mengembalikan lebih banyak, seperti nama, dari IGSID mereka setelah mereka mengirim pesan ke akun.

Lanjut membaca

Hubungkan saluran pertama Anda dalam dua menit.

Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.

  • Gratis 3 hari
  • Batalkan kapan saja
  • Hanya API resmi
  • Dipantau 24/7

Diverifikasi pada