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.
Só as 20 mensagens mais recentes de uma conversa devolvem detalhes; as mais antigas devolvem um erro a indicar que a mensagem foi eliminada.
Chamadas à Conversations API que uma aplicação pode fazer por Página do Facebook.
As conversas na pasta Pedidos que não estiveram ativas durante este período ficam de fora dos resultados da API.
A tarefa da Página que a pessoa por trás do token tem de poder executar para ler conversas.
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.
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:
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, eis_ownerquando 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_tocom o mid a que responde eis_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.
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