Membaca sejarah perbualan Messenger melalui API
Sejarah Messenger Halaman Facebook dibaca dengan GET /{page-id}/conversations?platform=messenger, yang menyenaraikan ID perbualan beserta masa kemas kini terakhir, kemudian GET /{conversation-id}?fields=messages untuk ID mesej dan GET /{message-id} bagi pengirim, penerima, teks dan lampiran setiap mesej. Meta memulangkan butiran bagi 20 mesej terkini dalam sesuatu perbualan, dan panggilan memerlukan token Halaman dengan pages_messaging.
easyCoexistence meneruskan mesej Messenger baharu sebuah Halaman ke endpoint anda semasa ia tiba, dan send_social_dm membalas dalam tetingkap khidmat pelanggan 24 jam, daripada Claude, ChatGPT atau kod anda sendiri.
Hanya 20 mesej terkini dalam perbualan memulangkan butiran; mesej yang lebih lama memulangkan ralat yang menyatakan mesej telah dipadam.
Bilangan panggilan Conversations API yang boleh dibuat oleh sesuatu aplikasi bagi setiap Halaman Facebook.
Perbualan dalam folder Requests yang tidak aktif selama tempoh ini tidak disertakan dalam hasil API.
Tugasan Halaman yang mesti dimiliki oleh individu di sebalik token untuk membaca perbualan.
Ralat bagi terlalu banyak panggilan API Messenger ke akaun Halaman; Meta menasihatkan supaya tunggu sebentar dan cuba semula.
Bagaimana anda menyenaraikan perbualan sesebuah Halaman?
Dengan GET /{page-id}/conversations, dengan platform ditetapkan kepada messenger. Hasilnya mengandungi tatasusunan data bagi ID perbualan, setiap satu dengan updated_time, iaitu masa mesej terakhir ditambah, dan objek paging; rujukan Meta menyatakan bahawa paging berasaskan masa tidak tersedia pada endpoint ini, jadi ikuti objek paging untuk bergerak dalam senarai.
GET /{page-id}/conversations?platform=messenger
{
"data": [
{ "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" },
{ "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" }
],
"paging": { ... }
}Bagaimana anda mencari perbualan seseorang?
Tambahkan user_id, ditetapkan kepada ID berskop Halaman orang itu, ke permintaan yang sama. Meta menjawab dengan ID perbualan antara Halaman dengan orang tersebut, iaitu laluan terpendek dari webhook mesej, di mana PSID tiba sebagai sender.id, ke sejarah di sebaliknya:
GET /{page-id}/conversations?platform=messenger&user_id=<PSID>
{ "data": [ { "id": "<CONVERSATION_ID>" } ] }Bagaimana anda membaca mesej dalam perbualan?
Dalam dua langkah. GET /{conversation-id} dengan fields=messages memulangkan ID mesej perbualan, setiap satu dengan created_time, yang paling terkini dahulu; kemudian GET /{message-id} dengan medan yang diperlukan, seperti id, created_time, from, to, message dan reply_to, memulangkan kandungan satu mesej. Medan lalai ialah id dan created_time, dan medan yang tiada data dikeluarkan daripada respons.
Medan apa yang boleh dibaca?
Perbualan dan mesej mendedahkan medan yang berbeza. Inilah yang disenaraikan oleh rujukan Meta untuk pemesejan Halaman:
- Perbualan: id,
updated_time, participants dengan ID, nama dan e-mel mereka, messages, danis_ownerapabila Conversation Routing dihidupkan. - Mesej: id,
created_time, from dan to, setiap satu dengan ID, nama dan e-mel, dan message, iaitu teks, kosong jika tiada. - attachments: fail, imej dan video dengan URL CDN mereka, dan
is_unsupported, dipulangkan hanya apabila mesej mengandungi kandungan yang tidak disokong. - reactions,
reply_todengan mid yang dibalasnya danis_self_reply, serta shares bagi siaran dan reel yang dikongsi. - tags: folder dan sumber mesej, seperti inbox, read atau source:chat.
Sejauh mana anda boleh membaca ke belakang?
Sejauh perbualan itu wujud bagi ID, tetapi tidak bagi kandungan. Panduan Meta menyatakan endpoint perbualan memulangkan semua ID mesej dalam sesuatu perbualan, manakala butiran hanya dipulangkan bagi 20 mesej terkini; meminta mesej yang lebih lama memulangkan ralat bahawa mesej telah dipadam. Perbualan dalam folder Requests yang tidak aktif selama 30 hari tidak dipulangkan langsung.
Apakah kebenaran dan tugasan yang diperlukan?
Token akses Halaman daripada seseorang yang boleh melaksanakan tugasan MESSAGING atau MODERATE pada Halaman, dengan kebenaran pages_manage_metadata, pages_read_engagement dan pages_messaging. Membaca perbualan dengan orang yang tiada peranan dalam aplikasi, Halaman atau perniagaan memerlukan Advanced Access, yang diberikan Meta melalui App Review.
Apakah had yang terpakai pada panggilan?
Had kadar Meta memberikan Conversations API 2 panggilan sesaat bagi setiap Halaman, dan panggilan melebihi had dipulangkan sebagai 613 atau 80006, There have been too many messenger api calls to this Page account. Halaman yang mencapai had volum tinggi Meta, seperti menghantar lebih 40 mesej sesaat, tidak dapat menyenaraikan perbualannya sehingga volum menurun, walaupun satu perbualan masih boleh dibaca untuk mesej baharu.
Bilakah anda patut guna API dan bukannya webhook?
Untuk masa lampau. Webhook menghantar mesej baharu semasa ia berlaku, dan Meta menyatakan bahawa pemberitahuan lampau tidak boleh ditanya kemudian, maka Conversations API ialah cara sesuatu integrasi membaca apa yang berlaku sebelum ia mula mendengar, atau mengejar ketinggalan selepas gangguan. Dengan Conversation Routing dihidupkan, medan is_owner mempersempit senarai kepada perbualan yang aplikasi itu bertanggungjawab menjawab, yang disarankan Meta untuk pemulihan selepas gangguan.
Bagaimana easyCoexistence membaca sejarah Messenger?
Ia tidak membaca sejarah. Halaman disambungkan dengan kebenaran pages_messaging, pages_manage_metadata dan pages_read_engagement, tetapi tiada alat yang memanggil Conversations API, dan token Halaman tidak diberikan. Mesej baharu sampai ke endpoint anda melalui set_social_webhook_destination semasa ia tiba, dihantar terus tanpa salinan, supaya sistem anda sendiri menyimpan sejarah yang diperlukannya.
Kesilapan biasa
- Menjangka kandungan mesej dalam panggilan senarai. Endpoint perbualan memulangkan ID mesej; baca medan setiap mesej daripada /{message-id}.
- Bergantung pada keseluruhan sejarah. Butiran berhenti pada 20 mesej terkini, jadi simpan apa yang anda perlukan daripada webhook semasa mesej tiba.
- Meninjau mesej baharu secara berulang. Pada 2 panggilan sesaat bagi setiap Halaman, gelung tinjauan tidak lama lagi akan mencapai had kadar, sedangkan webhook mesej menghantarnya semasa ia berlaku.
- Menyusun perbualan mengikut tarikh dengan since dan until. Paging berasaskan masa tidak tersedia pada endpoint perbualan; ikut objek paging sebagai gantinya.
Ia tiada alat untuk Conversations API, jadi sejarah terdahulu dibaca dalam peti masuk Halaman. US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari pertama percuma.
Soalan lazim
Adakah Conversations API termasuk mesej Halaman itu sendiri?
Ya. Medan from dan to menamakan orang atau Halaman, jadi mesej dalam perbualan merangkumi kedua-dua pihak.
Bolehkah saya membaca perbualan Messenger tanpa App Review?
Bagi orang yang mempunyai peranan dalam aplikasi atau Halaman, Standard Access sudah memadai. Perbualan dengan mana-mana pihak lain memerlukan Advanced Access, yang diberikan melalui App Review.
Bolehkah Conversations API menghantar balasan?
Tidak. Rujukan perbualan Meta menyatakan bahawa edge itu tidak boleh menerbitkan; balasan dihantar melalui Send API di /{page-id}/messages.
Adakah easyCoexistence menyimpan perbualan Messenger saya?
Tidak secara lalai. Peristiwa yang diteruskan dihantar tanpa menyimpan salinan; apabila automasi dihidupkan, teks mesej disimpan selama 7 hari dan log larian automasi selama 30 hari.
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