Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

IDs de utilizador do Instagram: IG_ID, IGSID e IDs de âmbito da aplicação

A API do Instagram usa três tipos de ID de utilizador. O IG_ID é o ID de uma conta profissional: GET /me devolve-o como user_id com o Instagram Login, os webhooks transportam-no em entry.id, e caminhos como /<IG_ID>/media usam-no. Um IGSID, ou ID de âmbito do Instagram, identifica uma pessoa que envia mensagens ou comenta nessa conta. O ID de âmbito da aplicação é o campo id que GET /me devolve.

O easyCoexistence atribui a cada conta do Instagram ligada um account_id para as suas ferramentas, a par do IG_ID, e reencaminha os eventos da Meta com os IGSID que trazem, para que o Claude, o ChatGPT ou o seu próprio código possam responder a comentários e DM através da API oficial da Meta.

user_id

O campo de /me que contém o ID da conta profissional do Instagram, que é o id nas notificações de webhook dessa conta.

id

Em /me com o Instagram Login, o ID de âmbito da aplicação do utilizador.

Per account

Um IGSID é específico da pessoa e da conta do Instagram com que ela interage.

sender.id

Onde a notificação de webhook de uma mensagem direta recebida traz o IGSID da pessoa; recipient.id contém o ID da conta.

Consent

Necessário para a User Profile API; a Meta concede o consentimento quando a pessoa envia uma mensagem à conta ou toca num ice breaker ou menu.

O que é um IG_ID?

O ID de uma conta profissional do Instagram, o objeto sobre o qual a maioria das chamadas é feita. Com o Instagram Login, GET /me?fields=user_id,username devolve-o como user_id, e o guia da Meta diz que é igual ao id nas notificações de webhook da conta, entry.id. Com o Facebook Login, uma Página devolve-o no campo instagram_business_account. Caminhos como /<IG_ID>/media, /<IG_ID>/conversations e /<IG_ID>/insights usam-no.

O que é um IGSID?

Um ID de âmbito do Instagram, criado quando alguém comenta na publicação, Reel ou Story da conta, ou lhe envia uma mensagem. A Meta limita-o à pessoa e à conta com que ela interage, pelo que a mesma pessoa tem um IGSID diferente em cada conta profissional, mas mantém o mesmo entre aplicações: a Meta diz que permite a uma empresa associar as interações de uma pessoa em várias aplicações. É o ID para responder, para encontrar uma conversa e para procurar uma pessoa.

Qual é o ID de âmbito da aplicação?

O campo id de GET /me com o Instagram Login, que o guia da Meta descreve como o ID de âmbito da aplicação do utilizador; os seus exemplos de chamadas usam user_id, e não id, nos caminhos seguintes. O código de troca no login também devolve um user_id, que o guia de login chama o ID de utilizador com âmbito do Instagram do utilizador da aplicação. Como o guia de primeiros passos associa o user_id de /me às notificações de webhook, esse é o valor a guardar como IG_ID.

Onde aparece cada ID?

As referências e os exemplos de webhook da Meta colocam-nos como se segue. Uma pessoa aparece como IGSID, quer comente quer envie uma DM, e a conta aparece com o seu IG_ID: como destinatário nas DM que recebe e como remetente nas DM que envia:

GET /me user_idIG_ID, the professional account
GET /me idApp-scoped ID of the app user
Webhook entry.idIG_ID of the account the event belongs to
comments value.from.idIGSID of the person who commented
messages sender.idIGSID on a received DM; the IG_ID on one the account sent
Conversations user_idIGSID that finds that person's conversation
Message from and toAn id with a username for each side
Page instagram_business_accountIG_ID, with Facebook Login

Como se procura uma pessoa a partir de um IGSID?

Com a User Profile API: GET /<IGSID> em graph.instagram.com, com instagram_business_basic e instagram_business_manage_messages. É necessário o consentimento da pessoa, que a Meta só concede quando ela envia uma mensagem à conta ou toca num item de ice breaker ou de menu persistente. Os URL de profile_pic expiram em poucos dias, e não é possível procurar uma pessoa que tenha bloqueado a conta.

A person's profile from their IGSID
GET https://graph.instagram.com/<IGSID>
  ?fields=name,username,profile_pic,follower_count,is_user_follow_business,is_business_follow_user
  &access_token=<ACCESS_TOKEN>

Pode um tipo de ID ser convertido noutro?

As vias documentadas pela Meta são consultas. A partir de um IGSID, a User Profile API devolve o nome de utilizador da pessoa. A partir de um nome de utilizador, a Business Discovery devolve o id de outra conta de empresa ou de criador, com o Facebook Login ou o Unified Login. A partir de um token, GET /me devolve o IG_ID. Um IGSID pertence a uma só conta profissional, pelo que o IGSID da mesma pessoa visto por outra conta é diferente.

Que IDs usa o easyCoexistence?

Os da Meta, mais um próprio. list_social_accounts devolve account_id, o ID do easyCoexistence para a ligação, que as outras ferramentas usam, e external_id, o IG_ID; get_social_credentials devolve o IG_ID como account_id_on_meta. Os eventos reencaminhados chegam com platform, account_id, external_id e o entry da Meta sem alterações, e send_social_dm recebe o IGSID da pessoa como recipient_id.

Erros comuns

  • Guardar o user_id da troca de código como ID da conta. Leia o user_id a partir de GET /me, que a Meta associa ao id das notificações de webhook.
  • Reutilizar um IGSID entre contas profissionais. Está limitado a uma conta, pelo que a mesma pessoa tem outro IGSID noutra conta.
  • Procurar alguém que só comentou e nunca escreveu. A Meta só concede consentimento quando a pessoa envia uma mensagem à conta ou toca num item de ice breaker ou de menu.
  • Guardar os URL de profile_pic. A Meta diz que expiram em poucos dias, por isso peça-os de novo quando forem precisos.
Fazer isto com a EasyCoexistence

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

O IGSID é o mesmo que o ID de utilizador do Instagram?

Não. Um IGSID identifica uma pessoa perante uma conta profissional, enquanto o IG_ID identifica a própria conta profissional.

Porque é que o meu ID do webhook não coincide com o ID do login?

A troca de código devolve um user_id que a Meta chama de âmbito do Instagram, enquanto as notificações de webhook trazem o user_id que GET /me devolve. Guarde o que vem de /me.

Posso obter o nome de utilizador do Instagram de alguém a partir de um IGSID?

Sim, através da User Profile API, depois de a pessoa ter enviado uma mensagem à conta ou tocado num item de ice breaker ou de menu persistente.

O IGSID muda entre aplicações?

Não. A Meta diz que permite às empresas associar as interações da mesma pessoa em várias aplicações, embora seja diferente de uma conta profissional para outra.

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