EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Menções no Instagram pela API: encontrar e responder @menções

A API do Instagram informa @menções de uma conta profissional em comentários e legendas de mídias públicas, e permite que a conta responda no próprio lugar. Com o Instagram Login, as menções chegam no webhook de comentários, e a resposta vai para POST /<IG_ID>/mentions com o ID da mídia, mais o ID do comentário quando for um comentário, publicada como comentário ali.

O easyCoexistence encaminha comentários, menções e DMs da conta do Instagram para o seu endpoint assim que chegam, assinados com um segredo dessa conta, depois que você o define com set_social_webhook_destination.

comments

Notificação de webhook que inclui menções para apps que usam Instagram Login.

POST /mentions

Endpoint que responde a um comentário ou legenda em que outro usuário do Instagram mencionou a conta.

Private

Mídia de conta privada não dispara webhook para comentário ou @menção nela.

2

Permissões necessárias para menções com Instagram Login: instagram_business_basic e instagram_business_manage_comments.

Como as menções chegam?

Por webhook, conforme acontecem. Com Instagram Login, a Meta inclui as menções na notificação de comentários, em vez de enviar um campo separado de menções, então um handler as lê dos mesmos eventos dos novos comentários. A Meta não mantém histórico de notificações passadas, por isso armazene o que você precisa de cada uma assim que ela chegar.

Quais menções a API cobre?

A API de menções da Meta identifica legendas, comentários e mídias em que uma conta comercial ou de criador foi @mencionada ou marcada:

  • @menções em comentários.
  • @menções na legenda de uma publicação.
  • Mídias em que a conta está marcada, listadas por GET /<IG_ID>/tags; comentar em fotos em que a conta apenas está marcada não é suportado.
  • Não Stories: a API de menções não os suporta, e uma menção em Story chega à conta como DM cujo tipo de anexo é story_mention.
  • Não contas privadas: mídias delas não enviam webhooks de menção.

Como responder a uma menção?

Com POST /<IG_ID>/mentions. Para uma menção em comentário, envie media_id e comment_id com a mensagem, e a resposta aparece na thread desse comentário; para uma menção em legenda, envie media_id e a mensagem, e ela é publicada como comentário na mídia. Ambos os IDs vêm da notificação do webhook.

Replying to a mention in a comment
POST https://graph.instagram.com/<IG_ID>/mentions
  ?media_id=<MEDIA_ID>
  &comment_id=<COMMENT_ID>
  &message=<REPLY_TEXT>

O que as menções exigem?

Com Instagram Login, as permissões instagram_business_basic e instagram_business_manage_comments, o mesmo par usado pela moderação de comentários, com chamadas indo para graph.instagram.com. Para atender contas profissionais que o desenvolvedor não possui nem gerencia, o app também precisa de Advanced Access.

Erros comuns

  • Esperar um evento separado de menções no Instagram Login. A Meta entrega as menções dentro da notificação de comentários.
  • Responder a uma menção em publicação de outra conta como se fosse um comentário na sua. A rota da Meta para isso é POST /<IG_ID>/mentions, com o ID da mídia e, para um comentário, o ID do comentário.
  • Esperar menções de Stories pela API de menções. A Meta não as suporta ali; elas chegam como DMs.
  • Contar com o webhook para reenviar menções antigas. A Meta não mantém histórico de notificações, então armazene cada uma assim que chegar.
Fazendo isso com o EasyCoexistence

Suas ferramentas respondem a comentários nos seus próprios posts com reply_to_comment; responder a uma menção em um post de outra pessoa, que usa o endpoint de menções da Meta, não está entre elas. 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

Posso comentar em uma foto em que minha conta está marcada?

Não. GET /<IG_ID>/tags lista as mídias em que a conta está marcada, mas a Meta não suporta comentar em fotos em que a conta apenas está marcada.

Posso responder a uma menção na publicação de outra pessoa?

Sim. POST /<IG_ID>/mentions com o ID da mídia, e o ID do comentário quando a menção estiver em um comentário, publica a resposta ali como a conta.

Menções em Stories estão disponíveis pela API de menções?

Não. Uma menção em Story chega à conta como DM cujo tipo de anexo é story_mention, e pode receber resposta nessa conversa.

Por que uma menção nunca chegou?

A mídia pode pertencer a uma conta privada, que não envia notificações de menção, ou a menção pode estar em um Story, que a API de menções não cobre.

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