InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Messenger-gespreksgeschiedenis lezen via de API

De Messenger-geschiedenis van een Facebook-pagina lees je met GET /{page-id}/conversations?platform=messenger, dat gespreks-ID's met hun laatste updatetijd teruggeeft, en daarna met GET /{conversation-id}?fields=messages voor de bericht-ID's en GET /{message-id} voor de afzender, ontvanger, tekst en bijlagen van elk bericht. Meta geeft details terug voor de 20 meest recente berichten van een gesprek, en de aanroepen vereisen een Page-token met pages_messaging.

easyCoexistence stuurt de nieuwe Messenger-berichten van een Page naar je endpoint door zodra ze binnenkomen, en send_social_dm antwoordt binnen het venster van 24 uur, vanuit Claude, ChatGPT of je eigen code.

20 messages

Alleen de 20 meest recente berichten in een gesprek geven details terug; oudere berichten geven een fout dat het bericht is verwijderd.

2 per second

Conversations API-aanroepen die een app per Facebook-pagina mag doen.

30 days

Gesprekken in de map Verzoeken die zo lang niet actief zijn geweest, worden uit de API-resultaten weggelaten.

MESSAGING or MODERATE

De Page-taak die de persoon achter het token moet kunnen uitvoeren om gesprekken te lezen.

80006

Fout voor te veel Messenger-API-aanroepen naar een Page-account; Meta raadt aan even te wachten en het opnieuw te proberen.

Hoe haal je de gesprekken van een Page op?

Met GET /{page-id}/conversations, waarbij platform op messenger staat. Het resultaat bevat een data-array met gespreks-ID's, elk met updated_time, het moment waarop het laatste bericht is toegevoegd, en een paging-object. Meta's referentie vermeldt dat tijdgebaseerde paginering op dit endpoint niet beschikbaar is, dus volg het paging-object om door de lijst te bladeren.

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

Hoe vind je het gesprek van één persoon?

Voeg user_id toe aan hetzelfde verzoek, ingesteld op de Page-scoped ID van de persoon. Meta antwoordt met de ID van het gesprek tussen de Page en die persoon. Dat is de kortste weg van een messages-webhook, waarin de PSID binnenkomt als sender.id, naar de geschiedenis erachter:

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

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

Hoe lees je de berichten in een gesprek?

In twee stappen. GET /{conversation-id} met fields=messages geeft de bericht-ID's van het gesprek terug, elk met created_time, het nieuwste eerst. Daarna geeft GET /{message-id} met de velden die je nodig hebt, zoals id, created_time, from, to, message en reply_to, de inhoud van één bericht. De standaardvelden zijn id en created_time, en een veld zonder gegevens wordt uit het antwoord weggelaten.

Welke velden kun je lezen?

Een gesprek en een bericht tonen verschillende velden. Dit zijn de velden die Meta's referenties voor Page-berichten noemen:

  • Gesprek: id, updated_time, participants met hun ID, naam en e-mail, messages, en is_owner zodra Conversation Routing aan staat.
  • Bericht: id, created_time, from en to, elk met een ID, naam en e-mail, en message, de tekst, leeg als die ontbreekt.
  • attachments: bestanden, afbeeldingen en video's met hun CDN-URL's, en is_unsupported, alleen teruggegeven wanneer een bericht niet-ondersteunde inhoud bevat.
  • reactions, reply_to met de mid waarop het antwoordt en is_self_reply, en shares voor gedeelde posts en reels.
  • tags: de map en bron van het bericht, zoals inbox, read of source:chat.

Hoe ver terug kun je lezen?

Zo ver als het gesprek gaat voor ID's, maar niet voor inhoud. Meta's gids zegt dat het gespreksendpoint alle bericht-ID's in een gesprek teruggeeft, terwijl details alleen komen voor de 20 meest recente berichten; een oudere opvragen geeft een fout dat het bericht is verwijderd. Gesprekken in de map Verzoeken die 30 dagen niet actief zijn geweest, worden helemaal niet teruggegeven.

Welke rechten en taken zijn nodig?

Een Page-toegangstoken van iemand die de taak MESSAGING of MODERATE op de Page kan uitvoeren, met de rechten pages_manage_metadata, pages_read_engagement en pages_messaging. Gesprekken lezen met mensen zonder rol in de app, op de Page of in het bedrijf vereist Advanced Access, dat Meta verleent via App Review.

Welke limieten gelden voor de aanroepen?

Meta's rate limits geven de Conversations API 2 aanroepen per seconde per Page. Aanroepen boven een limiet komen terug als 613 of als 80006, There have been too many messenger api calls to this Page account. Een Page die Meta's limiet voor hoog volume bereikt, zoals meer dan 40 berichten per seconde verzenden, kan zijn gesprekken niet opvragen totdat het volume daalt, al kan één gesprek nog wel op nieuwe berichten worden gelezen.

Wanneer gebruik je de API in plaats van webhooks?

Voor het verleden. Webhooks leveren nieuwe berichten zodra ze binnenkomen, en Meta meldt dat eerdere meldingen later niet meer opgevraagd kunnen worden. De Conversations API is dus de manier waarop een integratie leest wat er was voordat ze begon te luisteren, of de achterstand inhaalt na een storing. Met Conversation Routing aan beperkt het veld is_owner de lijst tot de gesprekken die de app moet beantwoorden, wat Meta aanraadt voor herstel na een storing.

Hoe leest easyCoexistence de Messenger-geschiedenis?

Het leest geen geschiedenis. De Page wordt verbonden met de rechten pages_messaging, pages_manage_metadata en pages_read_engagement, maar geen enkele tool roept de Conversations API aan, en tokens van de Page worden niet verstrekt. Nieuwe berichten bereiken je endpoint via set_social_webhook_destination zodra ze binnenkomen, doorgestuurd zonder kopie, zodat je eigen systeem de geschiedenis bewaart die het nodig heeft.

Veelgemaakte fouten

  • Message-inhoud verwachten in de lijstaanroep. Het gespreksendpoint geeft bericht-ID's terug; lees de velden van elk bericht via /{message-id}.
  • Op de volledige geschiedenis rekenen. Details stoppen bij de 20 meest recente berichten, dus sla op wat je nodig hebt uit webhooks terwijl berichten binnenkomen.
  • Pollen naar nieuwe berichten. Bij 2 aanroepen per seconde per Page loop je snel tegen de rate limit aan, terwijl de messages-webhook ze levert zodra ze binnenkomen.
  • Gesprekken op datum pagineren met since en until. Tijdgebaseerde paginering is niet beschikbaar op het gespreksendpoint; volg het paging-object.
Dit doen met EasyCoexistence

Het heeft geen tool voor de Conversations API, dus eerdere geschiedenis lees je in de Page-inbox. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met de eerste 3 dagen gratis.

Veelgestelde vragen

Bevat de Conversations API ook de eigen berichten van de Page?

Ja. De velden from en to noemen de persoon of de Page, dus de berichten van een gesprek bevatten beide kanten.

Kan ik Messenger-gesprekken lezen zonder App Review?

Voor mensen met een rol in de app of op de Page is Standard Access voldoende. Gesprekken met anderen vereisen Advanced Access, verleend via App Review.

Kan de Conversations API antwoorden versturen?

Nee. Meta's referentie voor gesprekken zegt dat het endpoint niet kan publiceren; antwoorden gaan via de Send API op /{page-id}/messages.

Slaat easyCoexistence mijn Messenger-gesprekken op?

Niet standaard. Doorgestuurde events worden doorgegeven zonder een kopie te bewaren; met een automatisering aan wordt de berichttekst 7 dagen bewaard en de logs van automatiseringsuitvoeringen 30 dagen.

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