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.
Notificação de webhook que inclui menções para apps que usam Instagram Login.
Endpoint que responde a um comentário ou legenda em que outro usuário do Instagram mencionou a conta.
Mídia de conta privada não dispara webhook para comentário ou @menção nela.
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.
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.
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