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.
O campo de /me que contém o ID da conta profissional do Instagram, que é o id nas notificações de webhook dessa conta.
Em /me com o Instagram Login, o ID de âmbito da aplicação do utilizador.
Um IGSID é específico da pessoa e da conta do Instagram com que ela interage.
Onde a notificação de webhook de uma mensagem direta recebida traz o IGSID da pessoa; recipient.id contém o ID da conta.
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:
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.
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.
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