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

Citirea istoricului DM-urilor de pe Instagram: API-ul Conversations

API-ul Conversations de la Instagram citește istoricul DM-urilor contului profesional de pe graph.instagram.com. GET /me/conversations?platform=instagram listează conversațiile cu updated_time, GET /<CONVERSATION_ID>?fields=messages listează mesajele unei conversații după ID și oră, iar GET /<MESSAGE_ID>?fields=id,created_time,from,to,message returnează un singur mesaj. Detaliile sunt disponibile pentru ultimele 20 de mesaje din fiecare conversație.

easyCoexistence transmite DM-urile noi de pe Instagram către endpoint-ul dumneavoastră pe măsură ce sosesc și răspunde cu send_social_dm în fereastra de 24 de ore, din Claude, ChatGPT sau propriul cod, prin API-ul oficial al Meta; nu are un instrument pentru istoricul din Conversations API.

20

Cele mai recente mesaje din fiecare conversație ale căror detalii le returnează API-ul; cele mai vechi primesc o eroare care spune că au fost șterse.

30 days

Perioada de inactivitate după care conversațiile din folderul Requests nu mai sunt returnate.

2/sec

Numărul de apeluri ale Conversations API pe care o aplicație le poate face pe secundă pentru fiecare cont profesional de Instagram.

2 permissions

instagram_business_basic și instagram_business_manage_messages, cu un token de la cineva care poate gestiona mesajele contului.

Cum listați conversațiile unui cont?

Cu GET /me/conversations sau /<IG_ID>/conversations și platform=instagram, folosind un token de acces Instagram User de la cineva care poate gestiona mesajele contului. Fiecare intrare din matricea data este o conversație, cu id-ul și updated_time.

Listing conversations
GET https://graph.instagram.com/me/conversations
  ?platform=instagram
  &access_token=<ACCESS_TOKEN>

{
  "data": [
    { "id": "<CONVERSATION_ID>", "updated_time": "<UPDATED_TIME>" }
  ]
}

Cum găsiți conversația cu o persoană?

Adăugați user_id cu ID-ul Instagram al persoanei, IGSID-ul care ajunge ca sender.id când vă scrie contului, iar răspunsul returnează id-ul acelei conversații. Transformă un eveniment webhook în firul său, fără a parcurge toată lista.

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

Cum citiți mesajele?

În doi pași. GET /<CONVERSATION_ID>?fields=messages listează mesajele conversației după id și created_time, câmpurile implicite. GET /<MESSAGE_ID> cu fields=id,created_time,from,to,message returnează apoi un singur mesaj: cine l-a trimis și cui, fiecare cu un username și un ID, precum și textul său.

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>

Cât de în urmă puteți citi?

Ghidul și prezentarea generală ale Meta stabilesc patru limite pentru ce se returnează:

  • Detaliile mesajelor: ultimele 20 de mesaje din fiecare conversație; cererea unui mesaj mai vechi returnează o eroare care spune că a fost șters.
  • Cereri: conversațiile din folderul Requests fără activitate timp de 30 de zile nu sunt returnate.
  • Partajări: o postare sau un Reel partajat revine doar ca URL-ul imaginii sau al videoclipului.
  • Rată: 2 apeluri pe secundă pentru fiecare cont profesional de Instagram.

Ce este necesar?

Cu Instagram Login, permisiunile instagram_business_basic și instagram_business_manage_messages și un token de la cineva care poate gestiona mesajele contului. Standard Access este suficient pentru conturile pe care le dețineți sau le administrați și le-ați adăugat în aplicație; pentru a deservi alte conturi este necesar Advanced Access. Contul trebuie să aibă și opțiunea „Allow access to messages” activată în setările aplicației Instagram.

De ce să păstrați o evidență din webhook-uri?

Deoarece API-ul returnează detalii doar pentru ultimele 20 de mesaje din fiecare conversație, istoricul complet trebuie stocat pe măsură ce se produce. Webhook-ul messages livrează DM-urile pe măsură ce sosesc, cu IGSID-ul persoanei ca sender.id, iar mesajele trimise de cont sosesc și ele, cu ID-urile inversate, astfel încât ambele părți ale unei conversații pot fi înregistrate.

Cum citiți istoricul DM-urilor prin easyCoexistence?

Transmite DM-urile mai departe, în loc să citească istoricul. DM-urile noi ajung la endpoint-ul dumneavoastră pe măsură ce sosesc, după ce îl setați cu set_social_webhook_destination, transmise mai departe fără o copie păstrată, iar send_social_dm trimite răspunsuri în fereastra de 24 de ore, din Claude, ChatGPT sau propriul cod. Niciun instrument nu apelează me/conversations, așa că mesajele anterioare se citesc în aplicația Instagram sau sunt păstrate de propriul sistem pe măsură ce sosesc.

Greșeli frecvente

  • Așteptarea întregului fir de la API. Detaliile se opresc la ultimele 20 de mesaje, așa că stocați DM-urile din webhook-ul messages pe măsură ce sosesc.
  • Interogarea conversațiilor pentru DM-uri noi. API-ul permite 2 apeluri pe secundă pentru fiecare cont, în timp ce webhook-ul messages livrează fiecare DM pe măsură ce sosește.
  • Căutarea unei cereri de mesaj vechi. Conversațiile din Requests cu 30 de zile de inactivitate nu mai sunt returnate.
  • Interpretarea erorii de mesaj șters drept ștergere de către persoană. Meta răspunde astfel pentru orice mesaj mai vechi decât ultimele 20.
Faceți acest lucru cu EasyCoexistence

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 perioadă de probă gratuită de 3 zile.

Întrebări frecvente

Pot exporta integral istoricul DM-urilor unui cont de Instagram?

Nu integral prin API: acesta listează conversațiile, dar returnează detaliile pentru ultimele 20 de mesaje din fiecare. O evidență completă provine din stocarea DM-urilor pe măsură ce le livrează webhook-ul.

Citirea mesajelor prin API le marchează ca citite?

Nu. Meta spune că mesajele livrate prin API nu sunt marcate ca citite în aplicația Instagram până când se trimite un răspuns.

Funcționează Conversations API cu Instagram Login?

Da. Ghidul Meta pentru acesta este scris pentru Instagram Login, cu apeluri către graph.instagram.com și permisiunile instagram_business_*.

Cum obțin numele de utilizator al unei persoane dintr-o conversație?

Solicitați from pentru un mesaj, care returnează numele de utilizator și ID-ul expeditorului. User Profile API returnează mai multe, precum numele, din IGSID-ul persoanei odată ce v-a scris contului.

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