Lire l'historique des conversations Messenger via l'API
L'historique Messenger d'une Page Facebook se lit avec GET /{page-id}/conversations?platform=messenger, qui liste les identifiants de conversation avec l'heure de leur dernière mise à jour, puis GET /{conversation-id}?fields=messages pour les identifiants des messages, et GET /{message-id} pour l'expéditeur, le destinataire, le texte et les pièces jointes de chaque message. Meta renvoie le détail des 20 messages les plus récents d'une conversation, et les appels nécessitent un token de Page avec pages_messaging.
easyCoexistence transmet à votre endpoint les nouveaux messages Messenger d'une Page dès leur arrivée, et send_social_dm répond dans la fenêtre de 24 heures, depuis Claude, ChatGPT ou votre propre code.
Seuls les 20 messages les plus récents d'une conversation renvoient leur détail ; les plus anciens renvoient une erreur indiquant que le message a été supprimé.
Nombre d'appels à l'API Conversations qu'une application peut effectuer par Page Facebook.
Les conversations du dossier Requests qui n'ont pas été actives pendant cette durée sont exclues des résultats de l'API.
La tâche de Page que la personne derrière le token doit pouvoir effectuer pour lire les conversations.
Erreur signalant un trop grand nombre d'appels à l'API Messenger pour un compte de Page ; Meta recommande d'attendre un peu avant de réessayer.
Comment lister les conversations d'une Page ?
Avec GET /{page-id}/conversations, en indiquant platform à messenger. Le résultat contient un tableau data d'identifiants de conversation, chacun avec updated_time, l'heure à laquelle le dernier message a été ajouté, et un objet paging ; la référence de Meta précise que la pagination temporelle n'est pas disponible sur cet endpoint, il faut donc suivre l'objet paging pour parcourir la liste.
GET /{page-id}/conversations?platform=messenger
{
"data": [
{ "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" },
{ "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" }
],
"paging": { ... }
}Comment retrouver la conversation d'une personne ?
En ajoutant user_id, avec l'identifiant propre à la Page (PSID) de la personne, à la même requête. Meta renvoie l'identifiant de la conversation entre la Page et cette personne, ce qui constitue le chemin le plus court depuis un webhook de messages, où le PSID arrive dans sender.id, jusqu'à l'historique qui s'y rattache :
GET /{page-id}/conversations?platform=messenger&user_id=<PSID>
{ "data": [ { "id": "<CONVERSATION_ID>" } ] }Comment lire les messages d'une conversation ?
En deux étapes. GET /{conversation-id} avec fields=messages renvoie les identifiants des messages de la conversation, chacun avec created_time, du plus récent au plus ancien ; puis GET /{message-id} avec les champs dont vous avez besoin, comme id, created_time, from, to, message et reply_to, renvoie le contenu d'un message. Les champs par défaut sont id et created_time, et un champ sans donnée est absent de la réponse.
Quels champs peut-on lire ?
Une conversation et un message n'exposent pas les mêmes champs. Voici ceux que les références de Meta listent pour la messagerie des Pages :
- Conversation : id,
updated_time, participants avec leur identifiant, leur nom et leur adresse e-mail, messages, etis_ownerune fois Conversation Routing activé. - Message : id,
created_time, from et to, chacun avec un identifiant, un nom et une adresse e-mail, et message, le texte, vide lorsqu'il n'y en a pas. - attachments : fichiers, images et vidéos avec leurs URL CDN, et
is_unsupported, renvoyé uniquement lorsqu'un message contient un contenu non pris en charge. - reactions,
reply_toavec le mid auquel il répond etis_self_reply, et shares pour les publications et reels partagés. - tags : le dossier et la source du message, comme inbox, read ou source:chat.
Jusqu'où peut-on remonter ?
Aussi loin que la conversation pour les identifiants, mais pas pour le contenu. Le guide de Meta indique que l'endpoint de conversation renvoie tous les identifiants de messages d'une conversation, tandis que le détail n'est renvoyé que pour les 20 messages les plus récents ; demander un message plus ancien renvoie une erreur indiquant que le message a été supprimé. Les conversations du dossier Requests inactives depuis 30 jours ne sont pas renvoyées du tout.
Quelles permissions et tâches sont nécessaires ?
Un token d'accès de Page émis par une personne pouvant effectuer la tâche MESSAGING ou MODERATE sur la Page, avec les permissions pages_manage_metadata, pages_read_engagement et pages_messaging. Lire les conversations avec des personnes qui n'ont aucun rôle sur l'application, sur la Page ou sur l'entreprise exige l'Advanced Access, que Meta accorde via App Review.
Quelles limites s'appliquent aux appels ?
Les limites de débit de Meta accordent à l'API Conversations 2 appels par seconde et par Page ; les appels au-delà de la limite renvoient le code d'erreur 613 ou 80006, avec le message « There have been too many messenger api calls to this Page account ». Une Page qui atteint la limite de volume élevé de Meta, comme l'envoi de plus de 40 messages par seconde, ne peut plus lister ses conversations tant que le volume ne baisse pas, bien qu'une conversation unique puisse encore être lue pour détecter de nouveaux messages.
Quand utiliser l'API plutôt que les webhooks ?
Pour le passé. Les webhooks livrent les nouveaux messages au moment où ils arrivent, et Meta indique que les notifications passées ne peuvent pas être interrogées plus tard ; l'API Conversations sert donc à lire ce qui est arrivé avant que l'intégration ne commence à écouter, ou à rattraper une interruption de service. Avec Conversation Routing activé, le champ is_owner restreint la liste aux conversations dont l'application doit assurer la réponse, ce que Meta recommande pour une reprise après interruption.
Comment easyCoexistence lit l'historique Messenger ?
Elle ne lit pas l'historique. La Page se connecte avec les permissions pages_messaging, pages_manage_metadata et pages_read_engagement, mais aucun outil n'appelle l'API Conversations, et les tokens de Page ne sont pas communiqués. Les nouveaux messages atteignent votre endpoint via set_social_webhook_destination dès leur arrivée, transmis sans copie, afin que votre propre système conserve l'historique dont il a besoin.
Erreurs courantes
- Attendre le contenu des messages dans l'appel de liste. L'endpoint de conversation renvoie les identifiants des messages ; lisez les champs de chaque message depuis /{message-id}.
- Compter sur l'historique complet. Le détail s'arrête aux 20 messages les plus récents ; enregistrez donc ce dont vous avez besoin à partir des webhooks, au fil de l'arrivée des messages.
- Interroger en boucle pour détecter les nouveaux messages. À 2 appels par seconde et par Page, une boucle d'interrogation atteint vite la limite de débit, alors que le webhook de messages les livre au moment où ils arrivent.
- Paginer les conversations par date avec since et until. La pagination temporelle n'est pas disponible sur l'endpoint des conversations ; suivez plutôt l'objet paging.
Il n'a pas d'outil pour l'API Conversations ; l'historique antérieur se lit donc dans la boîte de réception de la Page. De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec 3 jours d'essai gratuit.
Questions fréquemment posées
L'API Conversations inclut-elle les messages propres à la Page ?
Oui. Les champs from et to d'un message désignent la personne ou la Page, si bien que les messages d'une conversation incluent les deux côtés.
Puis-je lire les conversations Messenger sans App Review ?
Pour les personnes ayant un rôle sur l'application ou sur la Page, le Standard Access suffit. Les conversations avec toute autre personne exigent l'Advanced Access, accordé via App Review.
L'API Conversations peut-elle envoyer des réponses ?
Non. La référence de Meta sur les conversations indique que cet edge ne peut pas publier ; les réponses passent par la Send API, à /{page-id}/messages.
easyCoexistence conserve-t-il mes conversations Messenger ?
Non, par défaut. Les événements transmis le sont sans copie conservée ; lorsqu'une automatisation est activée, le texte des messages est conservé 7 jours et les journaux d'exécution des automatisations 30 jours.
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