InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Instagram DM-geschiedenis lezen: de Conversations API

De Conversations API van Instagram leest de DM-geschiedenis van een professioneel account op graph.instagram.com. GET /me/conversations?platform=instagram geeft een overzicht van de gesprekken met hun updated_time, GET /<CONVERSATION_ID>?fields=messages geeft de berichten van een gesprek op ID en tijd, en GET /<MESSAGE_ID>?fields=id,created_time,from,to,message geeft één bericht terug. Details zijn beschikbaar voor de 20 meest recente berichten in elk gesprek.

easyCoexistence stuurt nieuwe Instagram-DM's zodra ze binnenkomen door naar je endpoint en antwoordt met send_social_dm binnen het venster van 24 uur, vanuit Claude, ChatGPT of je eigen code, via de officiële API van Meta; het heeft geen tool voor de geschiedenis van de Conversations API.

20

De meest recente berichten per gesprek waarvan de API de details teruggeeft; oudere berichten geven een fout dat ze verwijderd zijn.

30 days

Inactiviteit waarna gesprekken in de map Verzoeken niet meer worden teruggegeven.

2/sec

Conversations API-aanroepen die een app per seconde mag doen voor elk Instagram-professioneel account.

2 permissions

instagram_business_basic en instagram_business_manage_messages, op een token van iemand die de berichten van het account kan beheren.

Hoe haal je de gesprekken van een account op?

Met GET /me/conversations, of /<IG_ID>/conversations, en platform=instagram, met een Instagram User access token van iemand die de berichten van het account kan beheren. Elk item in de data-array is één gesprek, met zijn id en 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>" }
  ]
}

Hoe vind je het gesprek met één persoon?

Voeg user_id toe met de Instagram-gebonden ID van de persoon, de IGSID die binnenkomt als sender.id wanneer hij het account een bericht stuurt. Het antwoord geeft dan de id van dat gesprek terug. Zo wordt een webhook-event omgezet in zijn thread, zonder de hele lijst door te bladeren.

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

Hoe lees je de berichten?

In twee stappen. GET /<CONVERSATION_ID>?fields=messages geeft de berichten van het gesprek op id en created_time, de standaardvelden. GET /<MESSAGE_ID> met fields=id,created_time,from,to,message geeft daarna één bericht terug: wie het heeft gestuurd en aan wie, elk met een username en een ID, en de tekst.

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>

Hoe ver terug kun je lezen?

De handleiding en het overzicht van Meta stellen vier limieten aan wat wordt teruggegeven:

  • Berichtdetails: de 20 meest recente berichten per gesprek; een ouder bericht opvragen geeft een fout dat het is verwijderd.
  • Verzoeken: gesprekken in de map Verzoeken zonder activiteit van 30 dagen worden niet teruggegeven.
  • Gedeelde posts: een gedeelde post of Reel komt alleen terug als zijn afbeeldings- of video-URL.
  • Snelheid: 2 aanroepen per seconde voor elk Instagram-professioneel account.

Wat is er nodig?

Met Instagram Login de rechten instagram_business_basic en instagram_business_manage_messages, en een token van iemand die de berichten van het account kan beheren. Standard Access is genoeg voor accounts die je bezit of beheert en aan de app hebt toegevoegd; het bedienen van andere accounts vraagt Advanced Access. Het account moet ook in de Instagram-appinstellingen de optie Toegang tot berichten toestaan hebben ingeschakeld.

Waarom een eigen archief bijhouden met webhooks?

Omdat de API details teruggeeft voor alleen de laatste 20 berichten per gesprek, moet een volledige geschiedenis worden opgeslagen terwijl het gebeurt. De messages-webhook levert DM's zodra ze binnenkomen, met de IGSID van de persoon als sender.id. Berichten die het account zelf stuurt, komen ook binnen, met de ID's omgekeerd, zodat beide kanten van een gesprek kunnen worden vastgelegd.

Hoe lees je DM-geschiedenis via easyCoexistence?

Het stuurt DM's door in plaats van geschiedenis te lezen. Nieuwe DM's bereiken je endpoint zodra ze binnenkomen, nadat je dat instelt met set_social_webhook_destination; wij sturen ze door zonder kopie te bewaren. send_social_dm antwoordt binnen het venster van 24 uur, vanuit Claude, ChatGPT of je eigen code. Geen enkele tool roept me/conversations aan, dus eerdere berichten lees je in de Instagram-app, of ze worden door je eigen systeem bewaard zodra ze binnenkomen.

Veelgemaakte fouten

  • De hele thread van de API verwachten. Details stoppen bij de 20 meest recente berichten, dus sla DM's op uit de messages-webhook zodra ze binnenkomen.
  • Nieuwe DM's opvragen door gesprekken te pollen. De API staat 2 aanroepen per seconde per account toe, terwijl de messages-webhook elke DM levert zodra die binnenkomt.
  • Een oud berichtverzoek zoeken. Gesprekken in Verzoeken met 30 dagen inactiviteit worden niet meer teruggegeven.
  • De fout 'deleted' opvatten als verwijdering door de persoon. Meta antwoordt zo bij elk bericht dat ouder is dan de laatste 20.
Dit doen met EasyCoexistence

Vanaf US$ 9 per verbinding per maand, dalend tot US$ 0.75 naarmate je meer verbindingen toevoegt, met een gratis proefperiode van 3 dagen.

Veelgestelde vragen

Kan ik de volledige DM-geschiedenis van een Instagram-account exporteren?

Niet volledig via de API: die geeft een overzicht van de gesprekken, maar details alleen voor de 20 meest recente berichten per gesprek. Een volledig archief komt van het opslaan van DM's zoals de webhook ze levert.

Markeert het lezen van berichten via de API ze als gelezen?

Nee. Meta zegt dat berichten die via de API worden geleverd in de Instagram-app niet als gelezen worden gemarkeerd, tot er een antwoord is verstuurd.

Werkt de Conversations API met Instagram Login?

Ja. De handleiding van Meta hiervoor is geschreven voor Instagram Login, met aanroepen naar graph.instagram.com en de instagram_business_*-rechten.

Hoe krijg ik de gebruikersnaam van een persoon uit een gesprek?

Vraag from op een bericht op, dat de gebruikersnaam en ID van de afzender teruggeeft. De User Profile API geeft meer terug, zoals de naam, op basis van hun IGSID zodra ze het account een bericht hebben gestuurd.

Lees verder

Koppel je eerste kanaal in twee minuten.

Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.

  • 3 dagen gratis
  • Op elk moment opzegbaar
  • Alleen officiële API's
  • 24/7 bewaakt

Geverifieerd op