Čitanje povijesti razgovora na Messengeru putem API-ja
Povijest Messengera Facebook stranice čita se pozivom GET /{page-id}/conversations?platform=messenger, koji vraća ID-jeve razgovora s vremenom zadnje izmjene, zatim GET /{conversation-id}?fields=messages za ID-jeve poruka i GET /{message-id} za pošiljatelja, primatelja, tekst i privitke svake poruke. Meta vraća detalje za 20 najnovijih poruka razgovora, a pozivi zahtijevaju token stranice s dozvolom pages_messaging.
easyCoexistence prosljeđuje nove Messenger poruke stranice vašem endpointu čim stignu, a send_social_dm odgovara u 24-satnom prozoru, iz Claudea, ChatGPT-ja ili vašeg vlastitog koda.
Detalje vraćaju samo 20 najnovijih poruka u razgovoru; starije vraćaju pogrešku da je poruka obrisana.
Broj poziva Conversations API-ja koje aplikacija može uputiti po Facebook stranici.
Razgovori u mapi Requests koji nisu bili aktivni ovoliko dugo ispadaju iz rezultata API-ja.
Zadatak stranice koji osoba iza tokena mora moći obavljati da bi čitala razgovore.
Pogreška zbog previše poziva Messenger API-ja na račun stranice; Meta savjetuje kratko čekanje i ponovni pokušaj.
Kako dohvatiti razgovore stranice?
Pozivom GET /{page-id}/conversations uz platform postavljen na messenger. Rezultat sadrži niz data s ID-jevima razgovora, svaki s updated_time, vremenom kada je dodana zadnja poruka, i objektom paging. Metina referenca navodi da na ovom endpointu nije dostupna paginacija po vremenu, pa se kroz popis kreće praćenjem objekta paging.
GET /{page-id}/conversations?platform=messenger
{
"data": [
{ "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" },
{ "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" }
],
"paging": { ... }
}Kako pronaći razgovor jedne osobe?
Dodajte istom zahtjevu user_id, postavljen na ID osobe vezan za stranicu (PSID). Meta odgovara ID-jem razgovora između stranice i te osobe, što je najkraći put od webhooka za poruke, u kojem PSID stiže u polju sender.id, do povijesti iza njega:
GET /{page-id}/conversations?platform=messenger&user_id=<PSID>
{ "data": [ { "id": "<CONVERSATION_ID>" } ] }Kako čitati poruke u razgovoru?
U dva koraka. GET /{conversation-id} s fields=messages vraća ID-jeve poruka razgovora, svaki s created_time, od najnovije prema najstarijoj; zatim GET /{message-id} s poljima koja trebate, primjerice id, created_time, from, to, message i reply_to, vraća sadržaj jedne poruke. Zadana polja su id i created_time, a polje bez podataka izostaje iz odgovora.
Koja polja možete čitati?
Razgovor i poruka imaju različita polja. Ovo su ona koja Metine reference navode za razmjenu poruka stranice:
- Razgovor: id,
updated_time, participants s ID-jem, imenom i e-poštom, messages, teis_ownerkada je uključen Conversation Routing. - Poruka: id,
created_time, from i to, svaki s ID-jem, imenom i e-poštom, te message, tekst, prazan kad ga nema. - attachments: datoteke, slike i videozapisi s CDN URL-ovima, te
is_unsupported, koji se vraća samo kada poruka sadrži nepodržani sadržaj. - reactions,
reply_tos vrijednošću mid na koju odgovara iis_self_reply, te shares za podijeljene objave i reelove. - tags: mapa i izvor poruke, primjerice inbox, read ili source:chat.
Koliko daleko možete čitati?
Za ID-jeve dokle god razgovor seže, a za sadržaj ne. Metin vodič kaže da endpoint razgovora vraća sve ID-jeve poruka u razgovoru, dok se detalji vraćaju samo za 20 najnovijih poruka; zahtjev za starijom porukom vraća pogrešku da je poruka obrisana. Razgovori u mapi Requests koji nisu bili aktivni 30 dana uopće se ne vraćaju.
Koja dopuštenja i zadaci su potrebni?
Token pristupa stranici od osobe koja može obavljati zadatak MESSAGING ili MODERATE na stranici, uz dopuštenja pages_manage_metadata, pages_read_engagement i pages_messaging. Čitanje razgovora s osobama koje nemaju ulogu u aplikaciji, na stranici ili u tvrtki zahtijeva Advanced Access, koji Meta odobrava kroz App Review.
Koja ograničenja vrijede za pozive?
Metina ograničenja brzine daju Conversations API-ju 2 poziva u sekundi po stranici, a pozivi preko ograničenja vraćaju 613 ili 80006, uz poruku da je bilo previše poziva Messenger API-ju za ovaj račun stranice. Stranica koja dosegne Metino ograničenje velikog obujma, primjerice slanje više od 40 poruka u sekundi, ne može popisati svoje razgovore dok obujam ne padne, iako se pojedini razgovor i dalje može čitati za nove poruke.
Kada koristiti API umjesto webhooka?
Za prošlost. Webhookovi isporučuju nove poruke čim se dogode, a Meta napominje da se prošle obavijesti kasnije ne mogu upitati, pa je Conversations API način da integracija pročita ono što je bilo prije nego što je počela slušati ili nadoknadi vrijeme nakon prekida rada. Uz uključen Conversation Routing, polje is_owner sužava popis na razgovore za koje je aplikacija zadužena odgovarati, što Meta preporučuje za oporavak nakon prekida rada.
Kako easyCoexistence čita povijest Messengera?
Ne čita povijest. Stranica se povezuje s dopuštenjima pages_messaging, pages_manage_metadata i pages_read_engagement, ali nijedan alat ne poziva Conversations API, a tokeni stranice se ne daju. Nove poruke stižu do vašeg endpointa putem set_social_webhook_destination čim pristignu, proslijeđene bez kopije, pa vaš vlastiti sustav čuva povijest koja mu je potrebna.
Uobičajene pogreške
- Očekivanje sadržaja poruka u pozivu za popis. Endpoint razgovora vraća ID-jeve poruka; polja svake čitajte s /{message-id}.
- Oslanjanje na cijelu povijest. Detalji staju na 20 najnovijih poruka, zato spremite što trebate iz webhookova dok poruke stižu.
- Stalno provjeravanje novih poruka. Uz 2 poziva u sekundi po stranici, petlja brzo dolazi do ograničenja, a webhook poruke isporučuje čim se dogode.
- Straničenje razgovora po datumu s since i until. Paginacija po vremenu nije dostupna na endpointu razgovora; slijedite objekt paging.
Nema alat za Conversations API, pa se ranija povijest čita u inboxu stranice. Od US$ 9 do US$ 0,75 po vezi mjesečno, uz pad cijene kako dodajete veze, a prva 3 dana su besplatna.
Često postavljana pitanja
Uključuje li Conversations API i poruke same stranice?
Da. Polja from i to navode osobu ili stranicu, pa poruke razgovora uključuju obje strane.
Mogu li čitati Messenger razgovore bez App Reviewa?
Za osobe s ulogom u aplikaciji ili na stranici dovoljan je Standard Access. Za razgovore s bilo kim drugim potreban je Advanced Access, koji se odobrava kroz App Review.
Može li Conversations API slati odgovore?
Ne. Metina referenca za razgovore kaže da endpoint ne može objavljivati; odgovori idu putem Send API-ja na /{page-id}/messages.
Sprema li easyCoexistence moje Messenger razgovore?
Ne prema zadanim postavkama. Proslijeđeni događaji se prosljeđuju bez zadržavanja kopije; uz uključenu automatizaciju, tekst poruka čuva se 7 dana, a zapisi izvođenja automatizacije 30 dana.
Nastavite čitati
Povežite svoj prvi kanal u dvije minute.
Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo službeni API-ji
- Nadzor 24/7
Provjereno na