Menções no Instagram através da API: encontrar e responder a @menções
A API do Instagram comunica as @menções de uma conta profissional em comentários e legendas de publicações públicas, e permite à conta responder no próprio local. Com o Instagram Login, as menções chegam pelo webhook de comentários, e a resposta é enviada por POST /<IG_ID>/mentions com o ID do media e, para um comentário, o ID do comentário, sendo publicada como comentário nesse ponto.
A easyCoexistence reencaminha os comentários, menções e DM da conta do Instagram para o seu endpoint à medida que chegam, assinados com um segredo próprio dessa conta, depois de o definir com set_social_webhook_destination.
Notificação de webhook que inclui menções para aplicações que usam o Instagram Login.
Endpoint que responde a um comentário ou legenda em que outro utilizador do Instagram @mencionou a conta.
Publicações de uma conta privada não disparam webhook para um comentário ou @menção nelas.
Permissões necessárias às menções com o Instagram Login: instagram_business_basic e instagram_business_manage_comments.
Como chegam as menções?
Por webhook, à medida que acontecem. Com o Instagram Login, a Meta inclui as menções na notificação de comentários em vez de enviar um campo de menções separado, pelo que o código que as recebe as lê dos mesmos eventos dos novos comentários. A Meta não guarda histórico das notificações anteriores, por isso guarde o que precisa de cada uma quando chegar.
Que menções cobre a API?
A API de menções da Meta identifica legendas, comentários e conteúdos em que uma conta empresarial ou de criador foi @mencionada ou marcada:
- @menções em comentários.
- @menções na legenda de uma publicação.
- Conteúdos em que a conta está marcada, listados por GET /<
IG_ID>/tags; não é suportado comentar em fotografias onde a conta está apenas marcada. - Não Stories: a API de menções não as suporta, e uma menção numa Story chega à conta como DM cujo tipo de anexo é
story_mention. - Não contas privadas: os conteúdos que possuem não enviam webhooks de menções.
Como se responde a uma menção?
Com POST /<IG_ID>/mentions. Para uma menção num comentário, envie media_id e comment_id com a mensagem, e a resposta aparece na conversa desse comentário; para uma menção numa legenda, envie media_id e a mensagem, e é publicada como comentário no conteúdo. 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 o Instagram Login, as permissões instagram_business_basic e instagram_business_manage_comments, o mesmo par que a moderação de comentários usa, com os pedidos enviados para graph.instagram.com. Para servir contas profissionais que o programador não possui nem gere, a aplicação também precisa de Advanced Access.
Erros comuns
- Esperar um evento de menções separado com o Instagram Login. A Meta entrega as menções dentro da notificação de comentários.
- Responder a uma menção numa 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 do media 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 aí; chegam à conta como DM.
- Contar com o webhook para reproduzir menções antigas. A Meta não guarda histórico de notificações, por isso guarde cada uma assim que chegar.
As suas ferramentas respondem a comentários nas suas próprias publicações com reply_to_comment; responder a uma menção numa publicação de outra pessoa, que usa o endpoint de menções da Meta, não é uma delas. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias grátis.
Perguntas frequentes
Posso comentar numa fotografia em que a conta está marcada?
Não. GET /<IG_ID>/tags lista os conteúdos em que a conta está marcada, mas a Meta não suporta comentar em fotografias em que a conta está apenas marcada.
Posso responder a uma menção na publicação de outra pessoa?
Sim. POST /<IG_ID>/mentions com o ID do media, e o ID do comentário quando a menção está num comentário, publica a resposta aí em nome da conta.
As menções de Stories estão disponíveis através da API de menções?
Não. Uma menção numa Story chega à conta como DM cujo tipo de anexo é story_mention, e pode receber resposta nessa conversa.
Porque é que nunca chegou uma menção?
O conteúdo pode pertencer a uma conta privada, que não envia notificações de menções, ou a menção pode estar numa Story, que a API de menções não abrange.
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