Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

Citirea istoricului conversațiilor Messenger prin API

Istoricul Messenger al unei Pagini Facebook se citește cu GET /{page-id}/conversations?platform=messenger, care listează ID-urile conversațiilor împreună cu ora ultimei actualizări, apoi cu GET /{conversation-id}?fields=messages pentru ID-urile mesajelor și cu GET /{message-id} pentru expeditorul, destinatarul, textul și atașamentele fiecărui mesaj. Meta returnează detalii pentru ultimele 20 de mesaje ale unei conversații, iar apelurile au nevoie de un token al Paginii cu permisiunea pages_messaging.

easyCoexistence transmite endpoint-ului dumneavoastră mesajele Messenger noi ale unei Pagini pe măsură ce sosesc, iar send_social_dm răspunde în fereastra de 24 de ore, din Claude, ChatGPT sau din codul dumneavoastră.

20 messages

Doar ultimele 20 de mesaje dintr-o conversație returnează detalii; cele mai vechi returnează o eroare care spune că mesajul a fost șters.

2 per second

Apeluri ale Conversations API pe care le poate face o aplicație pentru fiecare Pagină Facebook.

30 days

Conversațiile din folderul Requests care nu au fost active de atâta timp nu sunt incluse în rezultatele API.

MESSAGING or MODERATE

Sarcina din Pagină pe care persoana din spatele token-ului trebuie să o poată îndeplini pentru a citi conversațiile.

80006

Eroare pentru prea multe apeluri ale API-ului Messenger către un cont de Pagină; Meta recomandă să așteptați puțin și să încercați din nou.

Cum listați conversațiile unei Pagini?

Cu GET /{page-id}/conversations, setând platform la messenger. Rezultatul conține un array data cu ID-urile conversațiilor, fiecare cu updated_time, ora la care a fost adăugat ultimul mesaj, și un obiect paging. Referința Meta notează că paginarea pe bază de timp nu este disponibilă pe acest endpoint, așa că urmați obiectul paging pentru a parcurge lista.

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": { ... }
}

Cum găsiți conversația unei persoane?

Adăugați în aceeași cerere user_id, setat la ID-ul persoanei limitat la Pagină (PSID). Meta răspunde cu ID-ul conversației dintre Pagină și acea persoană, care este cea mai scurtă cale de la un webhook de mesaje, unde PSID-ul sosește ca sender.id, la istoricul din spatele acestuia:

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

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

Cum citiți mesajele dintr-o conversație?

În doi pași. GET /{conversation-id} cu fields=messages returnează ID-urile mesajelor conversației, fiecare cu created_time, cel mai recent primul; apoi GET /{message-id} cu câmpurile de care aveți nevoie, precum id, created_time, from, to, message și reply_to, returnează conținutul unui mesaj. Câmpurile implicite sunt id și created_time, iar un câmp fără date este omis din răspuns.

Ce câmpuri pot fi citite?

O conversație și un mesaj expun câmpuri diferite. Acestea sunt cele listate de referințele Meta pentru mesageria Paginii:

  • Conversație: id, updated_time, participants cu ID-ul, numele și e-mailul lor, messages și is_owner, odată ce Conversation Routing este activat.
  • Mesaj: id, created_time, from și to, fiecare cu ID, nume și e-mail, și message, textul, gol atunci când nu există.
  • attachments: fișiere, imagini și videoclipuri cu URL-urile lor CDN, și is_unsupported, returnat doar când un mesaj conține conținut nesuportat.
  • reactions, reply_to cu mid-ul la care răspunde și is_self_reply, și shares pentru postările și reel-urile distribuite.
  • tags: folderul și sursa mesajului, precum inbox, read sau source:chat.

Cât de departe în timp puteți citi?

Până la începutul conversației pentru ID-uri, dar nu pentru conținut. Ghidul Meta spune că endpoint-ul conversației returnează toate ID-urile mesajelor dintr-o conversație, în timp ce detaliile vin doar pentru ultimele 20 de mesaje; cererea unui mesaj mai vechi returnează o eroare că mesajul a fost șters. Conversațiile din folderul Requests inactive de 30 de zile nu sunt returnate deloc.

Ce permisiuni și sarcini sunt necesare?

Un token de acces al Paginii de la cineva care poate îndeplini sarcina MESSAGING sau MODERATE pe Pagină, cu permisiunile pages_manage_metadata, pages_read_engagement și pages_messaging. Citirea conversațiilor cu persoane care nu au niciun rol în aplicație, pe Pagină sau în afacere necesită Advanced Access, pe care Meta o acordă prin App Review.

Ce limite se aplică apelurilor?

Limitele de rată ale Meta acordă Conversations API 2 apeluri pe secundă pentru fiecare Pagină, iar apelurile peste limită returnează 613 sau 80006, There have been too many messenger api calls to this Page account. O Pagină care atinge limita de volum ridicat a Meta, precum trimiterea a mai mult de 40 de mesaje pe secundă, nu își poate lista conversațiile până când volumul scade, deși o singură conversație poate fi citită în continuare pentru mesaje noi.

Când ar trebui să folosiți API-ul în locul webhook-urilor?

Pentru trecut. Webhook-urile livrează mesajele noi pe măsură ce apar, iar Meta notează că notificările trecute nu pot fi interogate ulterior, deci Conversations API este modul în care o integrare citește ce a venit înainte să înceapă să asculte sau recuperează după o întrerupere. Cu Conversation Routing activat, câmpul is_owner restrânge lista la conversațiile pe care aplicația are responsabilitatea să le răspundă, ceea ce Meta recomandă pentru recuperarea după o întrerupere.

Cum citește easyCoexistence istoricul Messenger?

Nu citește istoricul. Pagina se conectează cu permisiunile pages_messaging, pages_manage_metadata și pages_read_engagement, dar niciun instrument nu apelează Conversations API, iar token-urile Paginii nu sunt predate. Mesajele noi ajung la endpoint-ul dumneavoastră prin set_social_webhook_destination pe măsură ce sosesc, transmise mai departe fără o copie, astfel încât sistemul dumneavoastră păstrează istoricul de care are nevoie.

Greșeli frecvente

  • Așteptarea conținutului mesajelor în apelul listei. Endpoint-ul conversației returnează ID-urile mesajelor; citiți câmpurile fiecărui mesaj din /{message-id}.
  • Contarea pe întregul istoric. Detaliile se opresc la ultimele 20 de mesaje, deci stocați ce vă trebuie din webhook-uri pe măsură ce mesajele sosesc.
  • Interogarea periodică pentru mesaje noi. La 2 apeluri pe secundă pentru fiecare Pagină, o buclă de interogare ajunge curând la limita de rată, în timp ce webhook-ul de mesaje le livrează pe măsură ce apar.
  • Paginarea conversațiilor după dată cu since și until. Paginarea pe bază de timp nu este disponibilă pe endpoint-ul conversațiilor; urmați în schimb obiectul paging.
Faceți acest lucru cu EasyCoexistence

Nu are niciun instrument pentru Conversations API, așa că istoricul anterior se citește în inbox-ul Paginii. De la US$ 9 până la US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.

Întrebări frecvente

Conversations API include și mesajele proprii ale Paginii?

Da. Câmpurile from și to ale unui mesaj indică persoana sau Pagina, deci mesajele unei conversații includ ambele părți.

Pot citi conversațiile Messenger fără App Review?

Pentru persoanele cu un rol în aplicație sau pe Pagină, Standard Access este suficient. Conversațiile cu oricine altcineva necesită Advanced Access, acordat prin App Review.

Poate Conversations API să trimită răspunsuri?

Nu. Referința Meta pentru conversații spune că endpoint-ul nu poate publica; răspunsurile trec prin Send API, la /{page-id}/messages.

easyCoexistence îmi stochează conversațiile Messenger?

Nu implicit. Evenimentele transmise sunt trimise mai departe fără să se păstreze o copie; cu o automatizare activată, textul mesajelor este păstrat 7 zile, iar jurnalele de rulare ale automatizării 30 de zile.

Continuați să citiți

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la