ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

ID пользователей Instagram: IG_ID, IGSID и ID в рамках приложения

Instagram API использует три вида ID пользователей. IG_ID является ID профессионального аккаунта: GET /me возвращает его как user_id при Instagram Login, вебхуки передают его как entry.id, а пути вроде /<IG_ID>/media принимают его в адресе. IGSID, или ID в рамках Instagram, относится к человеку, который пишет или комментирует сообщения на этом аккаунте. ID в рамках приложения представляет собой поле id, которое возвращает /me.

easyCoexistence выдаёт каждому подключённому аккаунту Instagram один account_id для своих инструментов, рядом с IG_ID, и пересылает события Meta с передаваемыми ими IGSID.

user_id

Поле /me с ID профессионального аккаунта Instagram, то есть id в уведомлениях вебхука этого аккаунта.

id

На /me при Instagram Login: ID в рамках приложения для пользователя приложения.

Per account

IGSID привязан к конкретному человеку и аккаунту Instagram, с которым он взаимодействует.

sender.id

Вебхук входящего DM передаёт IGSID человека, а recipient.id содержит ID аккаунта.

Consent

Нужен для User Profile API; Meta выставляет его, когда человек пишет аккаунту или нажимает ice breaker либо пункт меню.

Что такое IG_ID?

ID профессионального аккаунта Instagram, с которым чаще всего работают вызовы. При Instagram Login GET /me?fields=user_id,username возвращает его как user_id, и руководство Meta указывает, что он совпадает с id в уведомлениях вебхука аккаунта, entry.id. При Facebook Login страница возвращает его в поле instagram_business_account. Пути вроде /<IG_ID>/media, /<IG_ID>/conversations и /<IG_ID>/insights принимают его.

Что такое IGSID?

ID в рамках Instagram, который создаётся, когда человек комментирует публикацию, Reel или сторис аккаунта либо отправляет ему сообщение. Meta привязывает его к человеку и аккаунту, с которым тот взаимодействует, поэтому у одного человека разные IGSID для каждого профессионального аккаунта. При этом в разных приложениях он остаётся прежним: Meta пишет, что это позволяет бизнесу сопоставлять взаимодействия одного человека в нескольких приложениях. Это ID, по которому отвечают, находят переписку и ищут человека.

Что такое ID в рамках приложения?

Поле id в GET /me при Instagram Login, которое руководство Meta называет ID в рамках приложения для пользователя приложения. В примерах Meta далее в путях используется user_id, а не id. Код, полученный при входе, тоже возвращает user_id, который руководство по входу называет ID пользователя Instagram в рамках приложения. Поскольку руководство по началу работы связывает user_id из /me с уведомлениями вебхука, именно его нужно сохранять как IG_ID.

Где появляется каждый ID?

В справочниках и примерах вебхуков Meta они расположены так. Человек появляется как IGSID, будь то комментарий или DM, а аккаунт как IG_ID: получатель во входящих DM и отправитель в исходящих:

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

Как найти человека по IGSID?

С помощью User Profile API: GET /<IGSID> на graph.instagram.com с правами instagram_business_basic и instagram_business_manage_messages. Для этого нужно согласие человека, которое Meta выдаёт только тогда, когда он пишет аккаунту или нажимает ice breaker либо пункт постоянного меню. URL profile_pic истекают через несколько дней, а человека, заблокировавшего аккаунт, найти нельзя.

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>

Можно ли преобразовать один вид ID в другой?

Пути, которые документирует Meta, это поиски. По IGSID User Profile API возвращает имя пользователя человека. По имени пользователя Business Discovery возвращает id другого бизнес-аккаунта или аккаунта автора, при Facebook Login или Unified Login. По токену GET /me возвращает IG_ID. IGSID принадлежит одному профессиональному аккаунту, поэтому IGSID того же человека, увиденный другим аккаунтом, будет другим.

Какие ID использует easyCoexistence?

ID Meta и один собственный. list_social_accounts возвращает account_id, собственный ID easyCoexistence для подключения, который принимают остальные инструменты, и external_id, то есть IG_ID; get_social_credentials возвращает IG_ID как account_id_on_meta. Пересылаемые события приходят с полями platform, account_id, external_id и entry от Meta без изменений, а send_social_dm принимает IGSID человека как recipient_id.

Распространённые ошибки

  • Сохранять user_id из обмена кода при входе как ID аккаунта. Берите user_id из GET /me, который Meta связывает с id в уведомлениях вебхука.
  • Использовать один IGSID у разных профессиональных аккаунтов. Он привязан к одному аккаунту, поэтому у того же человека в другом месте другой IGSID.
  • Искать комментатора, который ничего не писал. Meta выдаёт согласие только тогда, когда человек пишет аккаунту или нажимает ice breaker либо пункт меню.
  • Сохранять URL profile_pic. Meta указывает, что они истекают через несколько дней, поэтому запрашивайте их заново при необходимости.
Настройка с EasyCoexistence

Так Claude, ChatGPT или ваш собственный код могут отвечать на комментарии и DM через официальный API Meta. От US$ 9 до US$ 0,75 за подключение в месяц, по мере добавления подключений стоимость снижается, с бесплатным пробным периодом на первые 3 дня.

Часто задаваемые вопросы

IGSID то же самое, что ID пользователя Instagram?

Нет. IGSID определяет человека для одного профессионального аккаунта, а IG_ID определяет сам профессиональный аккаунт.

Почему ID из вебхука не совпадает с ID при входе?

Обмен кода возвращает user_id, который Meta называет ID в рамках Instagram, а уведомления вебхука несут user_id, который возвращает GET /me. Сохраняйте тот, что из /me.

Можно ли получить имя пользователя Instagram по IGSID?

Да, через User Profile API, после того как человек написал аккаунту или нажал ice breaker либо пункт постоянного меню.

Меняется ли IGSID между приложениями?

Нет. Meta пишет, что это позволяет бизнесу сопоставлять взаимодействия одного человека в нескольких приложениях, хотя у разных профессиональных аккаунтов IGSID различается.

Читайте дальше

Чтение истории DM в Instagram: Conversations APIКак Conversations API читает историю DM в Instagram: список диалогов, поиск переписки с человеком, чтение сообщений, лимит 20 сообщений и права доступа.Вебхук сообщений Instagram: тело DM, эхо и поляЧто вебхук сообщений Instagram передаёт для DM: IGSID отправителя, текст, вложения, ответы на сторис и эхо, поле за полем, и окно 24 часа.Количество подписчиков и поля профиля Instagram через APIКакие поля профиля отдаёт API Instagram: followers_count, follows_count, media_count, username, фото, биографию и сайт, и что доступно при каждом входе.Instagram Business Discovery: чтение публикаций и подписчиков другого аккаунтаКак Business Discovery в Instagram читает подписчиков, профиль и публикации другого аккаунта по username и какой вход для этого нужен.Ошибка входа в Instagram «Invalid platform app»: что проверитьПочему окно входа Instagram показывает «Invalid platform app» и как исправить: ID приложения Instagram в client_id, точный redirect URI и настройки.Что такое Instagram Graph API? Instagram API в 2026 годуInstagram Graph API в 2026 году: API Meta для Instagram с Instagram Login, Facebook Login или Unified Login, его возможности и подходящие аккаунты.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на