EntrarComeçar teste grátis
easyCoexistence APIs oficiais

IDs de usuário do Instagram: IG_ID, IGSID e IDs com escopo de app

A API do Instagram usa três tipos de ID de usuário. O IG_ID é o ID de uma conta profissional: GET /me o devolve como user_id com o Instagram Login, os webhooks o trazem em entry.id, e caminhos como /<IG_ID>/media o recebem. Um IGSID, ou ID com escopo do Instagram, representa uma pessoa que envia mensagem ou comenta nessa conta. O ID com escopo de app é o campo id que GET /me devolve.

O easyCoexistence dá a cada conta do Instagram conectada um account_id para as suas ferramentas, junto com o IG_ID, e encaminha os eventos da Meta com os IGSIDs que trazem, para que Claude, ChatGPT ou seu próprio código respondam a comentários e DMs pela API oficial da Meta.

user_id

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

id

Em /me com Instagram Login, o ID com escopo de app do usuário do app.

Per account

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

sender.id

Onde o webhook de uma DM recebida traz o IGSID da pessoa; recipient.id guarda o ID da conta.

Consent

Necessário para a User Profile API; a Meta o define quando a pessoa envia mensagem para a conta ou toca em um 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 o devolve como user_id, e o guia da Meta diz que ele é igual ao id nas notificações de webhook da conta, entry.id. Com o Facebook Login, uma Página o devolve no campo instagram_business_account. Caminhos como /<IG_ID>/media, /<IG_ID>/conversations e /<IG_ID>/insights o recebem.

O que é um IGSID?

Um ID com escopo do Instagram, criado quando alguém comenta na publicação, Reel ou Story da conta, ou envia uma mensagem a ela. A Meta o vincula à pessoa e à conta com que ela interage, então a mesma pessoa tem um IGSID diferente em cada conta profissional, mas ele continua o mesmo entre apps: a Meta diz que ele permite a uma empresa mapear as interações de uma pessoa em vários apps. É o ID para responder, encontrar uma conversa e consultar uma pessoa.

O que é o ID com escopo de app?

O campo id de GET /me sob o Instagram Login, que o guia da Meta descreve como o ID com escopo de app do usuário do app; seus exemplos de chamada usam user_id, e não id, nos caminhos seguintes. A troca de código no login também devolve um user_id, que o guia de login chama de ID de usuário do Instagram com escopo do usuário do app. Como o guia de primeiros passos vincula o user_id de /me às notificações de webhook, esse é o valor a guardar como IG_ID.

Onde cada ID aparece?

As referências e os exemplos de webhook da Meta os posicionam como abaixo. Uma pessoa aparece como IGSID, seja ela quem comenta ou quem escreve uma DM, e a conta como seu IG_ID: o destinatário nas DMs que ela recebe, o remetente nas DMs que ela 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 encontrar 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. Exige o consentimento da pessoa, que a Meta só define quando ela envia mensagem para a conta ou toca em um ice breaker ou item de menu persistente. As URLs de profile_pic expiram em poucos dias, e uma pessoa que bloqueou a conta não pode ser consultada.

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>

Um tipo de ID pode ser convertido em outro?

As rotas que a Meta documenta são consultas. A partir de um IGSID, a User Profile API devolve o nome de usuário da pessoa. A partir de um nome de usuário, o Business Discovery devolve o id de outra conta de empresa ou 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 única conta profissional, então o IGSID da mesma pessoa visto por outra conta é diferente.

Quais IDs o easyCoexistence usa?

A easyCoexistence usa o ID da Meta, mais um próprio. list_social_accounts devolve account_id, o ID do easyCoexistence para a conexão, que as outras ferramentas recebem, e external_id, o IG_ID; get_social_credentials devolve o IG_ID como account_id_on_meta. Os eventos encaminhados chegam como 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 de GET /me, que a Meta vincula ao id nas notificações de webhook.
  • Reutilizar um IGSID entre contas profissionais. Ele tem escopo de uma conta, então a mesma pessoa tem outro IGSID em outra conta.
  • Consultar um comentarista que nunca escreveu. A Meta só define o consentimento quando a pessoa envia mensagem para a conta ou toca em um ice breaker ou item de menu.
  • Salvar URLs de profile_pic. A Meta diz que expiram em poucos dias, então busque-as de novo quando precisar.
Fazendo isso com o EasyCoexistence

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

O IGSID é o mesmo que o ID de usuário do Instagram?

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

Por que o ID do meu webhook não bate com o ID do login?

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

Posso obter o nome de usuário do Instagram de alguém a partir de um IGSID?

Sim, pela User Profile API, depois que a pessoa tiver enviado mensagem para a conta ou tocado em um ice breaker ou item de menu persistente.

O IGSID muda entre apps?

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

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