EntrarComeçar teste grátis
easyCoexistence APIs oficiais

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.

20 messages

Só as 20 mensagens mais recentes de uma conversa retornam detalhes; as mais antigas devolvem um erro informando que a mensagem foi excluída.

2 per second

Chamadas à Conversations API que um app pode fazer por Página do Facebook.

30 days

Conversas na pasta Solicitações que ficaram inativas por esse período ficam de fora dos resultados da API.

MESSAGING or MODERATE

A tarefa de Página que a pessoa por trás do token precisa poder executar para ler conversas.

80006

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.

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

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:

One person's conversation
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 e is_owner quando 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_to com o mid que ela responde e is_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.
Fazendo isso com o EasyCoexistence

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