Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Ler o histórico de conversas do Messenger através da API

O histórico 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 devolve os IDs das mensagens, e GET /{message-id} devolve o remetente, o destinatário, o texto e os anexos de cada mensagem. A Meta devolve os detalhes das 20 mensagens mais recentes de uma conversa, e as chamadas precisam de um token de Página com pages_messaging.

A easyCoexistence reencaminha as novas mensagens do Messenger de uma Página para o seu endpoint à medida que chegam, e send_social_dm responde dentro da janela 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 devolvem detalhes; as mais antigas devolvem um erro a indicar que a mensagem foi eliminada.

2 per second

Chamadas à Conversations API que uma aplicação pode fazer por Página do Facebook.

30 days

As conversas na pasta Pedidos que não estiveram ativas durante este período ficam de fora dos resultados da API.

MESSAGING or MODERATE

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

80006

Erro de excesso de chamadas da API do Messenger a uma conta de Página; a Meta indica que se espere um pouco e que se volte a tentar.

Como se listam as conversas de uma Página?

Com GET /{page-id}/conversations, definindo platform como messenger. O resultado contém um array data com os IDs das conversas, cada um com updated_time, a hora em que foi adicionada a última mensagem, e um objeto paging. A referência da Meta indica que a paginação baseada no tempo não está disponível neste endpoint, por isso 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 se encontra a conversa de uma pessoa?

Acrescente user_id, com o ID da pessoa com âmbito de Página, ao mesmo pedido. A Meta responde com o ID da conversa entre a Página e essa pessoa, que é o caminho mais curto desde um webhook de mensagens, onde o PSID chega como sender.id, até ao histórico correspondente:

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

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

Como se leem as mensagens de uma conversa?

Em dois passos. GET /{conversation-id} com fields=messages devolve 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 de que necessita, como id, created_time, from, to, message e reply_to, devolve o conteúdo de uma mensagem. Os campos predefinidos são id e created_time, e um campo sem dados fica de fora da resposta.

Que campos se podem ler?

Uma conversa e uma mensagem expõem campos diferentes. Estes são os que as referências da Meta listam para as mensagens da Página:

  • Conversa: id, updated_time, participants com o respetivo ID, nome e email, messages, e is_owner quando o Conversation Routing estiver ativo.
  • Mensagem: id, created_time, from e to, cada um com um ID, nome e email, e message, o texto, vazio quando não existe.
  • attachments: ficheiros, imagens e vídeos com os respetivos URLs da CDN, e is_unsupported, devolvido apenas quando uma mensagem contém conteúdo não suportado.
  • reactions, reply_to com o mid a que responde e is_self_reply, e shares para publicações partilhadas e reels.
  • tags: a pasta e a origem da mensagem, como inbox, read ou source:chat.

Até onde se pode ler?

Até ao início da conversa quanto aos IDs, mas não quanto ao conteúdo. O guia da Meta indica que o endpoint da conversa devolve todos os IDs das mensagens de uma conversa, enquanto os detalhes só chegam para as 20 mensagens mais recentes; pedir uma mais antiga devolve um erro de que a mensagem foi eliminada. As conversas na pasta Pedidos que estiveram inativas durante 30 dias não são devolvidas de todo.

Que permissões e tarefas são necessárias?

Um token de acesso à Página de alguém que possa 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 que não têm nenhum papel na aplicação, na Página ou no negócio exige o Advanced Access, que a Meta concede através da App Review.

Que limites se aplicam às chamadas?

Os limites de taxa da Meta dão à Conversations API 2 chamadas por segundo por Página, e as chamadas que ultrapassam um limite voltam com o código 613 ou 80006, There have been too many messenger api calls to this Page account. Uma Página que atinja o limite de alto volume da Meta, como enviar mais de 40 mensagens por segundo, não consegue listar as suas conversas até que o volume diminua, embora uma única conversa ainda possa ser lida para novas mensagens.

Quando se deve usar a API em vez de webhooks?

Para o passado. Os webhooks entregam as novas mensagens à medida que chegam, e a Meta refere que as notificações passadas não podem ser consultadas mais tarde; por isso, a Conversations API é a forma de uma integração ler o que chegou antes de começar a escutar, ou de recuperar após uma interrupção. Com o Conversation Routing ativo, o campo is_owner restringe a lista às conversas de que a aplicação é responsável por responder, o que a Meta sugere para recuperar após uma interrupção.

Como é que o easyCoexistence lê o histórico do Messenger?

Não lê o histórico. A Página liga-se com as permissões pages_messaging, pages_manage_metadata e pages_read_engagement, mas nenhuma ferramenta chama a Conversations API, e os tokens das Páginas não são entregues. As novas mensagens chegam ao seu endpoint através de set_social_webhook_destination à medida que chegam, reencaminhadas sem guardar uma cópia, para que o seu próprio sistema guarde o histórico de que precisa.

Erros comuns

  • Esperar conteúdo das mensagens na chamada à lista. O endpoint da conversa devolve IDs das mensagens; leia os campos de cada mensagem a partir de /{message-id}.
  • Contar com o histórico completo. Os detalhes param nas 20 mensagens mais recentes, por isso guarde o que precisa dos webhooks à medida que as mensagens chegam.
  • Fazer consultas repetidas por novas mensagens. Com 2 chamadas por segundo por Página, um ciclo de consultas depressa atinge o limite de taxa, enquanto o webhook de mensagens as entrega à medida que acontecem.
  • Paginar conversas por data com since e until. A paginação baseada no tempo não está disponível no endpoint de conversas; siga o objeto paging em vez disso.
Fazer isto com a EasyCoexistence

Não tem nenhuma ferramenta para a Conversations API, pelo que o histórico anterior se lê na caixa de entrada da Página. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias gratuitos.

Perguntas frequentes

A Conversations API inclui as mensagens da própria Página?

Sim. Os campos from e to indicam a pessoa ou a Página, por isso as mensagens de uma conversa incluem os dois lados.

Posso ler conversas do Messenger sem App Review?

Para pessoas com um papel na aplicação ou na Página, o Standard Access é suficiente. As conversas com qualquer outra pessoa exigem o Advanced Access, concedido através da App Review.

A Conversations API pode enviar respostas?

Não. A referência da Meta para conversas indica que o edge não pode publicar; as respostas passam pela Send API em /{page-id}/messages.

A easyCoexistence guarda as minhas conversas do Messenger?

Não por defeito. Os eventos reencaminhados são passados sem guardar cópia; com uma automatização ativa, o texto das mensagens é guardado durante 7 dias e os registos de execução da automatização durante 30 dias.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorizado 24/7

Verificado em