Ler o histórico de DMs do Instagram: a Conversations API
A Conversations API do Instagram lê o histórico de DMs de uma conta profissional em graph.instagram.com. GET /me/conversations?platform=instagram lista as conversas com o respetivo updated_time, GET /<CONVERSATION_ID>?fields=messages lista as mensagens de uma conversa pelo ID e pela hora, e GET /<MESSAGE_ID>?fields=id,created_time,from,to,message devolve uma mensagem. Os detalhes estão disponíveis para as 20 mensagens mais recentes de cada conversa.
A easyCoexistence reencaminha os novos DMs do Instagram para o seu endpoint à medida que chegam e responde com send_social_dm dentro da janela de 24 horas, a partir do Claude, do ChatGPT ou do seu próprio código, pela API oficial da Meta; não tem ferramenta para o histórico da Conversations API.
As mensagens mais recentes de cada conversa cujos detalhes a API devolve; as mais antigas respondem com um erro a indicar que foram eliminadas.
Inatividade após a qual as conversas da pasta Pedidos deixam de ser devolvidas.
Chamadas à Conversations API que uma aplicação pode fazer por segundo para cada conta profissional do Instagram.
instagram_business_basic e instagram_business_manage_messages, com um token de alguém que pode gerir as mensagens da conta.
Como se listam as conversas de uma conta?
Com GET /me/conversations, ou /<IG_ID>/conversations, e platform=instagram, usando um token de acesso de utilizador do Instagram de alguém que possa gerir as mensagens da conta. Cada entrada do array data é uma conversa, com o seu id e updated_time.
GET https://graph.instagram.com/me/conversations
?platform=instagram
&access_token=<ACCESS_TOKEN>
{
"data": [
{ "id": "<CONVERSATION_ID>", "updated_time": "<UPDATED_TIME>" }
]
}Como se encontra a conversa com uma pessoa?
Acrescente user_id com o ID com âmbito Instagram da pessoa, o IGSID que chega como sender.id quando lhe envia uma mensagem à conta, e a resposta devolve o id dessa conversa. Transforma um evento de webhook na respetiva conversa sem percorrer toda a lista por páginas.
GET https://graph.instagram.com/me/conversations
?user_id=<IGSID>
&access_token=<ACCESS_TOKEN>Como se leem as mensagens?
Em dois passos. GET /<CONVERSATION_ID>?fields=messages lista as mensagens da conversa pelo id e pelo created_time, que são os campos por defeito. GET /<MESSAGE_ID> com fields=id,created_time,from,to,message devolve então uma mensagem: quem a enviou e a quem, cada um com um nome de utilizador e um ID, e o seu texto.
GET https://graph.instagram.com/<CONVERSATION_ID>
?fields=messages
&access_token=<ACCESS_TOKEN>
GET https://graph.instagram.com/<MESSAGE_ID>
?fields=id,created_time,from,to,message
&access_token=<ACCESS_TOKEN>Até onde se pode ler para trás?
As orientações e a visão geral da Meta definem quatro limites para o que é devolvido:
- Detalhes das mensagens: as 20 mensagens mais recentes de cada conversa; pedir uma mais antiga devolve um erro a indicar que foi eliminada.
- Pedidos: conversas da pasta Pedidos sem atividade durante 30 dias não são devolvidas.
- Partilhas: uma publicação ou Reel partilhado devolve apenas o URL da imagem ou do vídeo.
- Ritmo: 2 chamadas por segundo para cada conta profissional do Instagram.
O que é preciso?
Com o Instagram Login, as permissões instagram_business_basic e instagram_business_manage_messages e um token de alguém que possa gerir as mensagens da conta. O Standard Access basta para contas que possui ou gere e que adicionou à aplicação; servir outras contas exige o Advanced Access. A conta tem ainda de ter ativada a opção Permitir acesso às mensagens nas definições da aplicação do Instagram.
Porque guardar um registo a partir dos webhooks?
Porque a API devolve detalhes apenas das 20 últimas mensagens de cada conversa, pelo que o histórico completo tem de ser guardado à medida que acontece. O webhook de mensagens entrega os DMs à medida que chegam, com o IGSID da pessoa como sender.id, e as mensagens que a conta envia também chegam, com os IDs ao contrário, para que os dois lados de uma conversa possam ser registados.
Como se lê o histórico de DMs através da easyCoexistence?
Reencaminha os DMs em vez de ler o histórico. Os novos DMs chegam ao seu endpoint à medida que chegam, depois de o definir com set_social_webhook_destination, reencaminhados sem guardar cópia, e send_social_dm responde dentro da janela de 24 horas, a partir do Claude, do ChatGPT ou do seu próprio código. Nenhuma ferramenta chama me/conversations, pelo que as mensagens anteriores são lidas na aplicação do Instagram ou guardadas pelo seu próprio sistema à medida que chegam.
Erros comuns
- Esperar a conversa completa pela API. Os detalhes param nas 20 mensagens mais recentes, por isso guarde os DMs do webhook de mensagens à medida que chegam.
- Consultar as conversas à procura de DMs novos. A API permite 2 chamadas por segundo por conta, enquanto o webhook de mensagens entrega cada DM assim que chega.
- Procurar um pedido de mensagem antigo. As conversas na pasta Pedidos com 30 dias de inatividade deixam de ser devolvidas.
- Ler o erro de eliminada como eliminação pela pessoa. A Meta responde assim a qualquer mensagem mais antiga do que as 20 mais recentes.
De US$ 9 a US$ 0.75 por ligação por mês, a descer à medida que acrescenta ligações, com os primeiros 3 dias gratuitos.
Perguntas frequentes
Posso exportar o histórico completo de DMs de uma conta do Instagram?
Não na totalidade pela API: lista as conversas, mas devolve os detalhes das 20 mensagens mais recentes de cada uma. Um registo completo obtém-se guardando os DMs à medida que o webhook os entrega.
Ler mensagens pela API marca-as como lidas?
Não. A Meta indica que as mensagens entregues pela API não ficam marcadas como lidas na aplicação do Instagram até ser enviada uma resposta.
A Conversations API funciona com o Instagram Login?
Sim. O guia da Meta para a API foi escrito para o Instagram Login, com chamadas a graph.instagram.com e às permissões instagram_business_*.
Como obtenho o nome de utilizador de uma pessoa numa conversa?
Peça o campo from numa mensagem, que devolve o nome de utilizador e o ID do remetente. A User Profile API devolve mais, como o nome, a partir do IGSID da pessoa, depois de ela ter enviado uma mensagem à conta.
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