Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

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.

comments

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

POST /mentions

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

Private

Publicações de uma conta privada não disparam webhook para um comentário ou @menção nelas.

2

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.

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 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.
Fazer isto com a EasyCoexistence

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