Lendo o histórico de conversas do Messenger pela API
O histórico de mensagens do Messenger de uma Página do Facebook é lido com GET /{page-id}/conversations?platform=messenger, que lista os IDs das conversas com a hora da última atualização. Depois, GET /{conversation-id}?fields=messages retorna os IDs das mensagens, e GET /{message-id} traz o remetente, o destinatário, o texto e os anexos de cada uma. A Meta devolve os detalhes das 20 mensagens mais recentes de uma conversa, e as chamadas exigem um token de Página com pages_messaging.
O easyCoexistence encaminha as novas mensagens do Messenger de uma Página ao seu endpoint assim que chegam, e o send_social_dm responde dentro da janela de atendimento de 24 horas, a partir do Claude, do ChatGPT ou do seu próprio código.
Só as 20 mensagens mais recentes de uma conversa retornam detalhes; as mais antigas devolvem um erro informando que a mensagem foi excluída.
Chamadas à Conversations API que um app pode fazer por Página do Facebook.
Conversas na pasta Solicitações que ficaram inativas por esse período ficam de fora dos resultados da API.
A tarefa de Página que a pessoa por trás do token precisa poder executar para ler conversas.
Erro de excesso de chamadas da API do Messenger para uma conta de Página; a Meta recomenda esperar um pouco e repetir.
Como listar as conversas de uma Página?
Com GET /{page-id}/conversations, definindo platform como messenger. O resultado traz um array data com os IDs das conversas, cada um com updated_time, a hora em que a última mensagem foi adicionada, e um objeto paging. A referência da Meta observa que a paginação por tempo não está disponível neste endpoint, então siga o objeto paging para percorrer a lista.
GET /{page-id}/conversations?platform=messenger
{
"data": [
{ "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" },
{ "id": "<CONVERSATION_ID>", "updated_time": "<TIME>" }
],
"paging": { ... }
}Como encontrar a conversa de uma pessoa?
Adicione user_id, com o ID da pessoa no escopo da Página, à mesma requisição. A Meta responde com o ID da conversa entre a Página e essa pessoa, que é o caminho mais curto a partir de um webhook de mensagens, onde o PSID chega como sender.id, até o histórico por trás dele:
GET /{page-id}/conversations?platform=messenger&user_id=<PSID>
{ "data": [ { "id": "<CONVERSATION_ID>" } ] }Como ler as mensagens de uma conversa?
Em duas etapas. GET /{conversation-id} com fields=messages retorna os IDs das mensagens da conversa, cada um com created_time, da mais recente para a mais antiga; depois, GET /{message-id} com os campos que você precisa, como id, created_time, from, to, message e reply_to, retorna o conteúdo de uma mensagem. Os campos padrão são id e created_time, e um campo sem dados fica de fora da resposta.
Quais campos podem ser lidos?
Uma conversa e uma mensagem expõem campos diferentes. Estes são os que as referências da Meta listam para mensagens de Página:
- Conversa: id,
updated_time, participants com o ID, nome e e-mail, messages eis_ownerquando o Conversation Routing está ativo. - Mensagem: id,
created_time, from e to, cada um com ID, nome e e-mail, e message, o texto, vazio quando não há. - attachments: arquivos, imagens e vídeos com suas URLs de CDN, e
is_unsupported, retornado somente quando a mensagem contém conteúdo não suportado. - reactions,
reply_tocom o mid que ela responde eis_self_reply, e shares para publicações e reels compartilhados. - tags: a pasta e a origem da mensagem, como inbox, read ou source:chat.
Até onde é possível ler?
Até o começo da conversa para os IDs, mas não para o conteúdo. O guia da Meta diz que o endpoint de conversas retorna todos os IDs de mensagens de uma conversa, enquanto os detalhes voltam só para as 20 mensagens mais recentes; pedir uma mais antiga retorna um erro informando que a mensagem foi excluída. Conversas na pasta Solicitações inativas há 30 dias não são retornadas de forma alguma.
Quais permissões e tarefas são necessárias?
Um token de acesso de Página de alguém que pode executar a tarefa MESSAGING ou MODERATE na Página, com as permissões pages_manage_metadata, pages_read_engagement e pages_messaging. Ler conversas com pessoas sem nenhum papel no app, na Página ou no negócio exige o Advanced Access, que a Meta concede pela App Review.
Quais limites se aplicam às chamadas?
Os limites de taxa da Meta dão à Conversations API 2 chamadas por segundo por Página, e chamadas acima do limite voltam com 613 ou 80006, There have been too many messenger api calls to this Page account. Uma Página que atinge o limite de alto volume da Meta, como enviar mais de 40 mensagens por segundo, não consegue listar suas conversas até o volume cair, embora uma conversa isolada ainda possa ser lida para novas mensagens.
Quando usar a API em vez de webhooks?
Para o passado. Webhooks entregam novas mensagens conforme acontecem, e a Meta observa que notificações passadas não podem ser consultadas depois; por isso a Conversations API é como uma integração lê o que chegou antes de começar a escutar, ou recupera o que foi perdido após uma indisponibilidade. Com o Conversation Routing ativo, o campo is_owner restringe a lista às conversas que o app é responsável por responder, o que a Meta sugere para recuperação após indisponibilidade.
Como o easyCoexistence lê o histórico do Messenger?
Ele não lê o histórico. A Página é conectada com as permissões pages_messaging, pages_manage_metadata e pages_read_engagement, mas nenhuma ferramenta chama a Conversations API, e os tokens da Página não são entregues. Novas mensagens chegam ao seu endpoint pelo set_social_webhook_destination conforme chegam, repassadas sem cópia, para que o seu próprio sistema guarde o histórico de que precisa.
Erros comuns
- Esperar conteúdo de mensagens na chamada da lista. O endpoint de conversas retorna IDs de mensagens; leia os campos de cada uma em /{message-id}.
- Contar com todo o histórico. Os detalhes param nas 20 mensagens mais recentes, então armazene o que você precisa dos webhooks conforme as mensagens chegam.
- Fazer polling por novas mensagens. Com 2 chamadas por segundo por Página, um loop de polling logo atinge o limite de taxa, enquanto o webhook de mensagens as entrega assim que acontecem.
- Paginar conversas por data com since e until. A paginação por tempo não está disponível no endpoint de conversas; siga o objeto paging.
Não há ferramenta para a Conversations API, então o histórico anterior é lido na caixa de entrada da Página. De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
A Conversations API inclui as mensagens da própria Página?
Sim. Os campos from e to de uma mensagem indicam a pessoa ou a Página, então as mensagens de uma conversa incluem os dois lados.
Dá para ler conversas do Messenger sem App Review?
Para pessoas com um papel no app ou na Página, o Standard Access basta. Conversas com qualquer outra pessoa exigem o Advanced Access, concedido pela App Review.
A Conversations API consegue enviar respostas?
Não. A referência de conversas da Meta diz que o edge não pode publicar; as respostas passam pela Send API em /{page-id}/messages.
O easyCoexistence armazena minhas conversas do Messenger?
Não por padrão. Os eventos encaminhados são repassados sem manter uma cópia; com uma automação ativada, o texto das mensagens fica guardado por 7 dias e os registros de execução das automações por 30 dias.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em