MasukMulai uji coba gratis
easyCoexistence API resmi

Membaca riwayat percakapan Messenger lewat API

Riwayat Messenger sebuah Halaman Facebook dibaca dengan GET /{page-id}/conversations?platform=messenger, yang menampilkan ID percakapan beserta waktu pembaruan terakhirnya, lalu GET /{conversation-id}?fields=messages untuk ID pesan dan GET /{message-id} untuk pengirim, penerima, teks, dan lampiran setiap pesan. Meta hanya mengembalikan detail untuk 20 pesan terbaru dalam sebuah percakapan, dan panggilannya memerlukan token Halaman dengan pages_messaging.

easyCoexistence meneruskan pesan Messenger baru sebuah Halaman ke endpoint Anda saat tiba, dan send_social_dm membalas di dalam jendela 24 jam, dari Claude, ChatGPT, atau kode Anda sendiri.

20 messages

Hanya 20 pesan terbaru dalam sebuah percakapan yang mengembalikan detail; pesan yang lebih lama mengembalikan kesalahan yang menyatakan pesan telah dihapus.

2 per second

Panggilan Conversations API yang dapat dilakukan sebuah aplikasi per Halaman Facebook.

30 days

Percakapan di folder Permintaan yang tidak aktif selama jangka waktu ini tidak disertakan dalam hasil API.

MESSAGING or MODERATE

Tugas Halaman yang harus dapat dilakukan orang di balik token untuk membaca percakapan.

80006

Kesalahan untuk terlalu banyak panggilan Messenger API ke akun Halaman; Meta menyarankan menunggu sebentar lalu mencoba kembali.

Bagaimana cara menampilkan daftar percakapan sebuah Halaman?

Dengan GET /{page-id}/conversations, dengan platform diatur ke messenger. Hasilnya berisi array data berisi ID percakapan, masing-masing dengan updated_time, yaitu waktu pesan terakhir ditambahkan, dan objek paging; referensi Meta mencatat bahwa paginasi berbasis waktu tidak tersedia di endpoint ini, jadi ikuti objek paging untuk berpindah dalam daftar.

Listing a Page's Messenger conversations
GET /{page-id}/conversations?platform=messenger

{
  "data": [
    { "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" },
    { "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" }
  ],
  "paging": { ... }
}

Bagaimana cara menemukan percakapan dengan satu orang?

Tambahkan user_id, diatur ke Page-scoped ID orang tersebut, pada permintaan yang sama. Meta menjawab dengan ID percakapan antara Halaman dan orang itu, yang merupakan jalur terpendek dari webhook pesan, tempat PSID tiba sebagai sender.id, ke riwayat di baliknya:

One person's conversation
GET /{page-id}/conversations?platform=messenger&user_id=<PSID>

{ "data": [ { "id": "<CONVERSATION_ID>" } ] }

Bagaimana cara membaca pesan dalam sebuah percakapan?

Dalam dua langkah. GET /{conversation-id} dengan fields=messages mengembalikan ID pesan percakapan, masing-masing dengan created_time, dimulai dari yang terbaru; lalu GET /{message-id} dengan field yang dibutuhkan, seperti id, created_time, from, to, message, dan reply_to, mengembalikan isi satu pesan. Field default adalah id dan created_time, dan field tanpa data tidak disertakan dalam respons.

Field apa saja yang bisa dibaca?

Percakapan dan pesan menampilkan field yang berbeda. Berikut yang tercantum dalam referensi Meta untuk pesan Halaman:

  • Percakapan: id, updated_time, participants dengan ID, name, dan email mereka, messages, serta is_owner setelah Conversation Routing aktif.
  • Pesan: id, created_time, from dan to, masing-masing dengan ID, name, dan email, serta message, yaitu teks, kosong jika tidak ada.
  • attachments: file, gambar, dan video dengan URL CDN-nya, serta is_unsupported, yang hanya dikembalikan ketika pesan berisi konten yang tidak didukung.
  • reactions, reply_to dengan mid yang dijawabnya dan is_self_reply, serta shares untuk postingan dan reel yang dibagikan.
  • tags: folder dan sumber pesan, seperti inbox, read, atau source:chat.

Seberapa jauh ke belakang bisa dibaca?

Sejauh percakapan itu ada untuk ID, tetapi tidak untuk isi. Panduan Meta menyatakan endpoint percakapan mengembalikan semua ID pesan dalam sebuah percakapan, sedangkan detailnya hanya dikembalikan untuk 20 pesan terbaru; meminta pesan yang lebih lama mengembalikan kesalahan bahwa pesan telah dihapus. Percakapan di folder Permintaan yang tidak aktif selama 30 hari sama sekali tidak dikembalikan.

Izin dan tugas apa yang dibutuhkan?

Token akses Halaman dari seseorang yang dapat menjalankan tugas MESSAGING atau MODERATE pada Halaman, dengan izin pages_manage_metadata, pages_read_engagement, dan pages_messaging. Membaca percakapan dengan orang yang tidak memiliki peran di aplikasi, Halaman, atau bisnis memerlukan Advanced Access, yang diberikan Meta melalui App Review.

Batasan apa yang berlaku untuk panggilan?

Pembatasan laju Meta memberi Conversations API 2 panggilan per detik per Halaman, dan panggilan yang melewati batas dikembalikan sebagai 613 atau 80006, There have been too many messenger api calls to this Page account. Halaman yang mencapai batas volume tinggi Meta, misalnya mengirim lebih dari 40 pesan per detik, tidak dapat menampilkan daftar percakapannya sampai volume turun, meski satu percakapan tetap dapat dibaca untuk pesan baru.

Kapan sebaiknya memakai API dibandingkan webhook?

Untuk pesan yang sudah lewat. Webhook mengirim pesan baru saat terjadi, dan Meta mencatat bahwa notifikasi lama tidak dapat diminta kembali, sehingga Conversations API adalah cara integrasi membaca apa yang datang sebelum ia mulai mendengarkan, atau menyusul setelah downtime. Dengan Conversation Routing aktif, field is_owner mempersempit daftar ke percakapan yang menjadi tanggung jawab aplikasi untuk dijawab, yang disarankan Meta untuk pemulihan setelah downtime.

Bagaimana easyCoexistence membaca riwayat Messenger?

Ia tidak membaca riwayat. Halaman terhubung dengan izin pages_messaging, pages_manage_metadata, dan pages_read_engagement, tetapi tidak ada alat yang memanggil Conversations API, dan token Halaman tidak diberikan. Pesan baru sampai ke endpoint Anda melalui set_social_webhook_destination saat tiba, diteruskan tanpa salinan, sehingga sistem Anda sendiri menyimpan riwayat yang dibutuhkannya.

Kesalahan umum

  • Mengharapkan isi pesan pada panggilan daftar. Endpoint percakapan mengembalikan ID pesan; baca field setiap pesan dari /{message-id}.
  • Mengandalkan seluruh riwayat. Detail berhenti pada 20 pesan terbaru, jadi simpan apa yang Anda butuhkan dari webhook saat pesan datang.
  • Melakukan polling untuk pesan baru. Dengan 2 panggilan per detik per Halaman, loop polling segera mencapai pembatasan laju, sementara webhook pesan mengirimkannya saat terjadi.
  • Mem-paginasi percakapan berdasarkan tanggal dengan since dan until. Paginasi berbasis waktu tidak tersedia di endpoint percakapan; ikuti objek paging sebagai gantinya.
Melakukan ini dengan EasyCoexistence

Tidak ada alat untuk Conversations API, sehingga riwayat sebelumnya dibaca di kotak masuk Halaman. Dari US$ 9 turun hingga US$ 0.75 per koneksi per bulan, semakin murah seiring Anda menambah koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Apakah Conversations API menyertakan pesan dari Halaman itu sendiri?

Ya. Field from dan to menyebutkan orang atau Halaman, sehingga pesan dalam sebuah percakapan mencakup kedua sisi.

Bisakah saya membaca percakapan Messenger tanpa App Review?

Untuk orang yang memiliki peran di aplikasi atau Halaman, Standard Access sudah cukup. Percakapan dengan orang lain memerlukan Advanced Access, yang diberikan melalui App Review.

Apakah Conversations API bisa mengirim balasan?

Tidak. Referensi percakapan Meta menyatakan edge ini tidak dapat menerbitkan; balasan dikirim lewat Send API di /{page-id}/messages.

Apakah easyCoexistence menyimpan percakapan Messenger saya?

Tidak secara default. Peristiwa yang diteruskan dikirim tanpa menyimpan salinan; dengan otomatisasi aktif, teks pesan disimpan selama 7 hari dan log eksekusi otomatisasi selama 30 hari.

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