Se connecterCommencer l’essai gratuit
easyCoexistence API officielles

Lire l'historique des DM Instagram : l'API Conversations

L'API Conversations d'Instagram lit l'historique DM d'un compte professionnel sur graph.instagram.com. GET /me/conversations?platform=instagram liste les conversations avec leur updated_time, GET /<CONVERSATION_ID>?fields=messages liste les messages d'une conversation par ID et heure, et GET /<MESSAGE_ID>?fields=id,created_time,from,to,message renvoie un message. Les détails sont disponibles pour les 20 messages les plus récents de chaque conversation.

easyCoexistence transmet les nouveaux DM Instagram à votre endpoint dès leur arrivée et répond avec send_social_dm dans la fenêtre de 24 heures, depuis Claude, ChatGPT ou votre propre code, via l'API officielle de Meta ; il n'a pas d'outil pour l'historique de la Conversations API.

20

Les messages les plus récents par conversation dont l'API renvoie le détail ; les plus anciens répondent par une erreur indiquant qu'ils ont été supprimés.

30 days

Durée d'inactivité au-delà de laquelle les conversations du dossier Requests ne sont plus renvoyées.

2/sec

Appels à l'API Conversations qu'une application peut faire par seconde pour chaque compte professionnel Instagram.

2 permissions

instagram_business_basic et instagram_business_manage_messages, avec un token d'une personne pouvant gérer les messages du compte.

Comment lister les conversations d'un compte ?

Avec GET /me/conversations, ou /<IG_ID>/conversations, et platform=instagram, en utilisant un token d'accès Instagram User d'une personne pouvant gérer les messages du compte. Chaque entrée du tableau data correspond à une conversation, avec son id et son 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>" }
  ]
}

Comment trouver la conversation avec une personne ?

Ajoutez user_id avec l'ID scopé Instagram de la personne, l'IGSID reçu comme sender.id lorsqu'elle écrit au compte. La réponse renvoie l'id de cette conversation. Un événement webhook devient ainsi son fil, sans parcourir toute la liste.

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

Comment lire les messages ?

En deux étapes. GET /<CONVERSATION_ID>?fields=messages liste les messages de la conversation par id et created_time, qui sont les champs par défaut. GET /<MESSAGE_ID> avec fields=id,created_time,from,to,message renvoie ensuite un message : qui l'a envoyé et à qui, chacun avec un username et un ID, ainsi que son texte.

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>

Jusqu'où peut-on remonter ?

Le guide et la vue d'ensemble de Meta fixent quatre limites à ce qui est renvoyé :

  • Détails des messages : les 20 messages les plus récents de chaque conversation ; demander un message plus ancien renvoie une erreur indiquant qu'il a été supprimé.
  • Demandes : les conversations du dossier Requests sans activité depuis 30 jours ne sont pas renvoyées.
  • Partages : un post ou un Reel partagé ne revient que sous forme d'URL de son image ou de sa vidéo.
  • Débit : 2 appels par seconde pour chaque compte professionnel Instagram.

De quoi faut-il disposer ?

Avec Instagram Login, les permissions instagram_business_basic et instagram_business_manage_messages, et un token d'une personne pouvant gérer les messages du compte. L'accès Standard suffit pour les comptes que vous possédez ou gérez et que vous avez ajoutés à l'application ; servir d'autres comptes exige l'accès Advanced. Le compte doit aussi avoir activé « Allow access to messages » dans les paramètres de son application Instagram.

Pourquoi conserver un historique à partir des webhooks ?

Parce que l'API ne renvoie le détail que des 20 derniers messages de chaque conversation, un historique complet doit être enregistré au fil de l'eau. Le webhook messages transmet les DM dès leur arrivée, avec l'IGSID de la personne en sender.id. Les messages envoyés par le compte arrivent aussi, avec les identifiants inversés, si bien que les deux côtés d'une conversation peuvent être enregistrés.

Comment lire l'historique des DM avec easyCoexistence ?

Il transmet les DM plutôt que de lire l'historique. Les nouveaux DM atteignent votre endpoint dès leur arrivée une fois que vous en définissez un avec set_social_webhook_destination, transmis sans copie conservée. send_social_dm répond dans la fenêtre de 24 heures, depuis Claude, ChatGPT ou votre propre code. Aucun outil n'appelle me/conversations : les messages antérieurs se lisent donc dans l'application Instagram, ou sont conservés par votre propre système à mesure qu'ils arrivent.

Erreurs courantes

  • Attendre le fil complet depuis l'API. Le détail s'arrête aux 20 messages les plus récents ; enregistrez donc les DM du webhook messages dès leur arrivée.
  • Interroger les conversations pour trouver de nouveaux DM. L'API autorise 2 appels par seconde et par compte, alors que le webhook messages transmet chaque DM dès son arrivée.
  • Chercher une ancienne demande de message. Les conversations du dossier Requests sans activité depuis 30 jours ne sont plus renvoyées.
  • Lire l'erreur « deleted » comme une suppression par la personne. Meta répond ainsi pour tout message plus ancien que les 20 derniers.
Faire cela avec EasyCoexistence

De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.

Questions fréquemment posées

Peut-on exporter l'historique complet des DM d'un compte Instagram ?

Pas en totalité par l'API : elle liste les conversations mais ne renvoie le détail que des 20 messages les plus récents de chacune. Un historique complet vient de l'enregistrement des DM au fil de leur arrivée par le webhook.

La lecture des messages via l'API les marque-t-elle comme lus ?

Non. Meta indique que les messages transmis par l'API ne sont pas marqués comme lus dans l'application Instagram tant qu'une réponse n'a pas été envoyée.

L'API Conversations fonctionne-t-elle avec Instagram Login ?

Oui. Le guide de Meta qui s'y rapporte est écrit pour Instagram Login, avec des appels vers graph.instagram.com et les permissions instagram_business_*.

Comment obtenir le nom d'utilisateur d'une personne depuis une conversation ?

Demandez from sur un message, qui renvoie le username et l'ID de l'expéditeur. L'User Profile API en renvoie davantage, comme le nom, à partir de son IGSID une fois qu'elle a écrit au compte.

Poursuivre la lecture

Connectez votre premier canal en deux minutes.

Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.

  • 3 jours gratuits
  • Résiliable à tout moment
  • API officielles uniquement
  • Supervisé 24/7

Vérifié le