Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Membaca sejarah DM Instagram: API perbualan

API Perbualan Instagram membaca sejarah DM akaun profesional di graph.instagram.com. GET /me/conversations?platform=instagram menyenaraikan perbualan beserta updated_time, GET /<CONVERSATION_ID>?fields=messages menyenaraikan mesej perbualan mengikut ID dan masa, dan GET /<MESSAGE_ID>?fields=id,created_time,from,to,message memulangkan satu mesej. Butiran tersedia bagi 20 mesej terbaru dalam setiap perbualan.

easyCoexistence memajukan DM Instagram baharu ke endpoint anda sebaik tiba dan membalas dengan send_social_dm dalam tetingkap 24 jam, daripada Claude, ChatGPT atau kod anda sendiri, melalui API rasmi Meta; ia tiada alat untuk sejarah Conversations API.

20

Mesej terbaru bagi setiap perbualan yang butirannya dipulangkan API; yang lebih lama dijawab dengan ralat yang menyatakan ia telah dipadam.

30 days

Tempoh tidak aktif selepas itu perbualan dalam folder Permintaan tidak lagi dipulangkan.

2/sec

Bilangan panggilan API Perbualan sesaat yang boleh dibuat oleh aplikasi bagi setiap akaun profesional Instagram.

2 permissions

instagram_business_basic dan instagram_business_manage_messages, pada token daripada seseorang yang boleh mengurus mesej akaun tersebut.

Bagaimana anda menyenaraikan perbualan sesuatu akaun?

Dengan GET /me/conversations, atau /<IG_ID>/conversations, dan platform=instagram, menggunakan token akses Instagram User daripada seseorang yang boleh mengurus mesej pada akaun tersebut. Setiap entri dalam tatasusunan data ialah satu perbualan, 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 anda mencari perbualan dengan seorang individu?

Tambahkan user_id dengan ID berskop Instagram orang itu, iaitu IGSID yang diterima sebagai sender.id apabila dia menghantar mesej kepada akaun, dan respons akan memulangkan id perbualan tersebut. Ia menukar peristiwa webhook kepada benangnya tanpa menyelak keseluruhan senarai.

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

Bagaimana anda membaca mesej?

Dalam dua langkah. GET /<CONVERSATION_ID>?fields=messages menyenaraikan mesej perbualan mengikut id dan created_time, iaitu medan lalai. Kemudian GET /<MESSAGE_ID> dengan fields=id,created_time,from,to,message memulangkan satu mesej: siapa yang menghantarnya dan kepada siapa, setiap satu 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>

Setakat mana ke belakang anda boleh membaca?

Panduan dan gambaran keseluruhan Meta menetapkan empat had ke atas apa yang dipulangkan:

  • Butiran mesej: 20 mesej terbaru dalam setiap perbualan; meminta yang lebih lama memulangkan ralat yang menyatakan ia telah dipadam.
  • Permintaan: perbualan dalam folder Permintaan yang tiada aktiviti selama 30 hari tidak dipulangkan.
  • Kongsi: hantaran atau Reel yang dikongsi hanya dipulangkan sebagai URL imej atau videonya.
  • Kadar: 2 panggilan sesaat bagi setiap akaun profesional Instagram.

Apa yang diperlukan?

Dengan Instagram Login, kebenaran instagram_business_basic dan instagram_business_manage_messages serta token daripada seseorang yang boleh mengurus mesej pada akaun tersebut. Standard Access sudah mencukupi bagi akaun yang anda miliki atau urus dan tambahkan ke aplikasi; melayani akaun lain memerlukan Advanced Access. Akaun juga mesti mempunyai Allow access to messages dihidupkan dalam tetapan aplikasi Instagramnya.

Mengapa perlu menyimpan rekod daripada webhook?

Kerana API hanya memulangkan butiran bagi 20 mesej terbaru setiap perbualan, sejarah penuh perlu disimpan semasa ia berlaku. Webhook mesej menghantar DM sebaik tiba, dengan IGSID orang itu sebagai sender.id, dan mesej yang dihantar oleh akaun juga tiba, dengan ID dalam arah sebaliknya, supaya kedua-dua pihak perbualan boleh direkodkan.

Bagaimana anda membaca sejarah DM melalui easyCoexistence?

Ia memajukan DM dan bukan membaca sejarah. DM baharu sampai ke endpoint anda sebaik tiba selepas anda menetapkannya dengan set_social_webhook_destination, dihantar tanpa salinan disimpan, dan send_social_dm membalas dalam tetingkap 24 jam, daripada Claude, ChatGPT atau kod anda sendiri. Tiada alat yang memanggil me/conversations, jadi mesej terdahulu dibaca dalam aplikasi Instagram, atau disimpan oleh sistem anda sendiri sebaik tiba.

Kesilapan biasa

  • Menjangka keseluruhan benang daripada API. Butiran berhenti pada 20 mesej terbaru, jadi simpan DM daripada webhook mesej sebaik tiba.
  • Meninjau perbualan untuk DM baharu. API membenarkan 2 panggilan sesaat bagi setiap akaun, manakala webhook mesej menghantar setiap DM sebaik ia tiba.
  • Mencari mesej permintaan lama. Perbualan dalam Permintaan dengan 30 hari tidak aktif tidak lagi dipulangkan.
  • Menganggap ralat dipadam sebagai pemadaman oleh orang itu. Meta menjawab begitu bagi mana-mana mesej yang lebih lama daripada 20 terbaru.
Menggunakan EasyCoexistence untuk ini

Daripada US$ 9 sebulan bagi setiap sambungan, menurun kepada US$ 0.75 apabila sambungan ditambah, dengan 3 hari pertama percuma.

Soalan lazim

Bolehkah saya mengeksport sejarah DM penuh akaun Instagram?

Tidak sepenuhnya melalui API: ia menyenaraikan perbualan tetapi memulangkan butiran bagi 20 mesej terbaru dalam setiap satu. Rekod lengkap diperoleh dengan menyimpan DM seperti yang dihantar webhook.

Adakah membaca mesej melalui API menandakannya sebagai sudah dibaca?

Tidak. Meta menyatakan mesej yang dihantar melalui API tidak ditandakan sebagai sudah dibaca dalam aplikasi Instagram sehingga balasan dihantar.

Adakah Conversations API berfungsi dengan Instagram Login?

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

Bagaimana saya mendapatkan username seseorang daripada perbualan?

Minta from pada satu mesej, yang memulangkan username dan ID pengirim. User Profile API memulangkan lebih banyak, seperti nama, daripada IGSID mereka selepas mereka pernah menghantar mesej kepada akaun.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada