Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

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.

20

As mensagens mais recentes de cada conversa cujos detalhes a API devolve; as mais antigas respondem com um erro a indicar que foram eliminadas.

30 days

Inatividade após a qual as conversas da pasta Pedidos deixam de ser devolvidas.

2/sec

Chamadas à Conversations API que uma aplicação pode fazer por segundo para cada conta profissional do Instagram.

2 permissions

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.

Listing conversations
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.

One person's conversation
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.

A conversation's messages, then one message
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.
Fazer isto com a EasyCoexistence

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