Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

IDs de usuario de Instagram: IG_ID, IGSID y IDs con alcance de app

La API de Instagram usa tres tipos de ID de usuario. El IG_ID es el ID de una cuenta profesional: GET /me lo devuelve como user_id con Instagram Login, los webhooks lo envían como entry.id y rutas como /<IG_ID>/media lo reciben. Un IGSID, o ID con alcance de Instagram, identifica a una persona que escribe o comenta en esa cuenta. El ID con alcance de app es el campo id que devuelve /me.

easyCoexistence da a cada cuenta de Instagram conectada un account_id para sus herramientas, junto al IG_ID, y reenvía los eventos de Meta con los IGSID que traen, para que Claude, ChatGPT o tu propio código respondan a comentarios y DMs a través de la API oficial de Meta.

user_id

El campo de /me que contiene el ID de la cuenta profesional de Instagram, que es el id de las notificaciones webhook de esa cuenta.

id

En /me con Instagram Login, el ID con alcance de app del usuario de la app.

Per account

Un IGSID es específico de la persona y de la cuenta de Instagram con la que interactúa.

sender.id

Cuando el webhook de un DM recibido trae el IGSID de la persona; recipient.id contiene el ID de la cuenta.

Consent

Necesario para la User Profile API; Meta lo establece cuando la persona escribe a la cuenta o toca un rompehielos o un elemento del menú.

¿Qué es un IG_ID?

El ID de una cuenta profesional de Instagram, el objeto sobre el que se hace la mayoría de llamadas. Con Instagram Login, GET /me?fields=user_id,username lo devuelve como user_id, y la guía de Meta indica que es igual al id de las notificaciones webhook de la cuenta, entry.id. Con Facebook Login, una Página lo devuelve en su campo instagram_business_account. Rutas como /<IG_ID>/media, /<IG_ID>/conversations y /<IG_ID>/insights lo reciben.

¿Qué es un IGSID?

Un ID con alcance de Instagram, creado cuando alguien comenta en una publicación, Reel o Story de la cuenta, o le envía un mensaje. Meta lo limita a la persona y a la cuenta con la que interactúa, así que la misma persona tiene un IGSID distinto con cada cuenta profesional, aunque se mantiene igual entre apps: Meta dice que permite a una empresa vincular las interacciones de una persona en varias apps. Es el ID al que se responde, con el que se encuentra una conversación y con el que se busca a una persona.

¿Qué es el ID con alcance de app?

El campo id de GET /me con Instagram Login, que la guía de Meta describe como el ID con alcance de app del usuario de la app; sus llamadas de ejemplo usan user_id, no id, en las rutas siguientes. El intercambio de código durante el login también devuelve un user_id, que la guía de login llama el ID de Instagram con alcance de usuario de la app. Como la guía de inicio vincula el user_id de /me con las notificaciones webhook, ese es el valor que hay que guardar como IG_ID.

¿Dónde aparece cada ID?

Las referencias y ejemplos de webhook de Meta los sitúan como se indica abajo. Una persona aparece como IGSID tanto si comenta como si escribe un DM, y la cuenta como su IG_ID: el destinatario en los DM que recibe, el remitente en los DM que envía:

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

¿Cómo se busca a una persona a partir de un IGSID?

Con la User Profile API: GET /<IGSID> en graph.instagram.com, con instagram_business_basic e instagram_business_manage_messages. Requiere el consentimiento de la persona, que Meta solo establece cuando le escribe a la cuenta o toca un rompehielos o un elemento del menú persistente. Las URL de profile_pic caducan en pocos días, y no se puede buscar a una persona que haya bloqueado la cuenta.

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>

¿Se puede convertir un tipo de ID en otro?

Las rutas que documenta Meta son búsquedas. Desde un IGSID, la User Profile API devuelve el nombre de usuario de la persona. Desde un nombre de usuario, Business Discovery devuelve el id de otra cuenta de empresa o creador, con Facebook Login o Unified Login. Desde un token, GET /me devuelve el IG_ID. Un IGSID pertenece a una sola cuenta profesional, así que el IGSID de la misma persona visto por otra cuenta es distinto.

¿Qué IDs usa easyCoexistence?

Los de Meta, más uno propio. list_social_accounts devuelve account_id, el ID de easyCoexistence para la conexión que usan las demás herramientas, y external_id, el IG_ID; get_social_credentials devuelve el IG_ID como account_id_on_meta. Los eventos reenviados llegan con platform, account_id, external_id y el entry de Meta sin cambios, y send_social_dm recibe el IGSID de la persona como recipient_id.

Errores comunes

  • Guardar el user_id del intercambio de código como ID de la cuenta. Lee user_id de GET /me, que Meta vincula con el id de las notificaciones webhook.
  • Reutilizar un IGSID entre cuentas profesionales. Está limitado a una cuenta, así que la misma persona tiene otro IGSID en otra parte.
  • Buscar a alguien que nunca escribió. Meta establece el consentimiento solo cuando la persona escribe a la cuenta o toca un rompehielos o un elemento del menú.
  • Guardar las URL de profile_pic. Meta dice que caducan en pocos días, así que vuelve a pedirlas cuando las necesites.
Hacerlo con EasyCoexistence

De US$ 9 a US$ 0.75 por conexión al mes, con descenso a medida que agregas conexiones, y los primeros 3 días gratis.

Preguntas frecuentes

¿El IGSID es lo mismo que el ID de usuario de Instagram?

No. Un IGSID identifica a una persona frente a una cuenta profesional, mientras que el IG_ID identifica a la cuenta profesional en sí.

¿Por qué mi ID del webhook no coincide con el ID del login?

El intercambio de código devuelve un user_id que Meta llama con alcance de Instagram, mientras que las notificaciones webhook traen el user_id que devuelve GET /me. Guarda el de /me.

¿Puedo obtener el nombre de usuario de Instagram de alguien a partir de un IGSID?

Sí, con la User Profile API, una vez que la persona haya escrito a la cuenta o tocado un rompehielos o un elemento del menú persistente.

¿El IGSID cambia entre apps?

No. Meta dice que permite a las empresas vincular las interacciones de una misma persona en varias apps, aunque cambia de una cuenta profesional a otra.

Sigue leyendo

Conecta tu primer canal en dos minutos.

Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.

  • 3 días gratis
  • Cancela cuando quieras
  • Solo APIs oficiales
  • Monitorizado 24/7

Verificado el