ログイン無料トライアルを開始
easyCoexistence 公式 API

Instagram ユーザーID:IG_ID、IGSID、アプリスコープID

Instagram API は 3 種類のユーザー ID を使います。IG_ID はプロフェッショナルアカウントの ID です。Instagram Login の GET /me は user_id として返し、Webhook は entry.id として送り、/<IG_ID>/media などのパスでも使われます。IGSID(Instagram スコープ ID)は、そのアカウントにメッセージを送ったりコメントしたりした人を表します。アプリスコープ ID は、/me が返す id フィールドです。

easyCoexistence は、接続された Instagram アカウントごとに、ツール用の account_id を IG_ID と並べて割り当て、Meta のイベントを含まれる IGSID とともに転送します。

user_id

プロフェッショナルアカウントの ID を保持する /me のフィールドで、そのアカウントの Webhook 通知にある id と同じ値です。

id

Instagram Login を使う /me では、アプリユーザーのアプリスコープ ID が返されます。

Per account

IGSID は、人と、その人がやり取りした Instagram アカウントの組み合わせごとに固有の ID です。

sender.id

受信 DM の Webhook には相手の IGSID が含まれ、recipient.id にはアカウントの ID が入ります。

Consent

User Profile API に必要です。Meta が同意を設定するのは、相手がアカウントにメッセージを送ったとき、またはアイスブレイカーや永続メニューをタップしたときです。

IG_ID とは何ですか?

Instagram プロフェッショナルアカウントの ID で、ほとんどの API 呼び出しの対象になるオブジェクトです。Instagram Login では GET /me?fields=user_id,username で user_id として返されます。Meta のガイドによると、これはアカウントの Webhook 通知にある entry.id と同じ値です。Facebook Login の場合は、Page の instagram_business_account フィールドで返されます。/<IG_ID>/media、/<IG_ID>/conversations、/<IG_ID>/insights などのパスでも使われます。

IGSID とは何ですか?

Instagram スコープ ID のことで、誰かがアカウントの投稿、リール、ストーリーズにコメントしたとき、またはアカウントにメッセージを送ったときに作成されます。Meta はこの ID を、その人とやり取りしたアカウントに紐づけているため、同じ人でもプロフェッショナルアカウントごとに異なる IGSID を持ちます。一方で、アプリをまたいでも同じ値のままです。Meta によると、これにより企業は複数のアプリをまたいで一人の人のやり取りを対応づけられます。返信や会話の検索、人の照合に使う ID です。

アプリスコープ ID とは何ですか?

Instagram Login で GET /me を呼び出したときの id フィールドです。Meta のガイドでは、これはアプリユーザーのアプリスコープ ID と説明されています。Meta のサンプルでは、後続のパスで id ではなく user_id が使われています。ログイン時のコード交換でも user_id が返され、ログインガイドではこれをアプリユーザーの Instagram スコープユーザー ID と呼んでいます。/me の user_id を Webhook 通知と結びつけるのは get-started ガイドなので、IG_ID として保存すべき値はこちらです。

各 ID はどこに現れますか?

Meta のリファレンスと Webhook の例では、次のように配置されています。相手はコメントでも DM でも IGSID として現れ、アカウント側は IG_ID で表されます。アカウントが受け取る DM では受信者、送信する 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 を使います。graph.instagram.com に対して GET /<IGSID> を instagram_business_basic と instagram_business_manage_messages の権限付きで呼び出します。相手の同意が必要で、Meta が同意を設定するのは、相手がアカウントにメッセージを送ったとき、またはアイスブレイカーや永続メニュー項目をタップしたときだけです。profile_pic の URL は数日で期限切れになり、アカウントをブロックしている人は調べられません。

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 でその人のユーザー名を取得できます。ユーザー名からは、Facebook Login または Unified Login を使うと Business Discovery で別の企業またはクリエイターアカウントの id を取得できます。トークンからは GET /me で IG_ID を取得できます。IGSID は一つのプロフェッショナルアカウントに属するため、同じ人でも別のアカウントから見た IGSID は異なります。

easyCoexistence はどの ID を使いますか?

Meta の ID に加えて、easyCoexistence 独自の ID も使います。list_social_accounts は、他のツールが使う接続用の ID である account_id と、IG_ID である external_id を返します。get_social_credentials は IG_ID を account_id_on_meta として返します。転送されるイベントは platform、account_id、external_id、Meta の entry を変更せずに含めて届き、send_social_dm は相手の IGSID を recipient_id として受け取ります。

よくある間違い

  • コード交換で得た user_id を、アカウントの ID として保存すること。Webhook 通知の id と結びついているのは GET /me の user_id なので、そちらから読み取ってください。
  • IGSID を複数のプロフェッショナルアカウントで使い回すこと。IGSID は一つのアカウントに紐づくため、同じ人でも別の場所では別の IGSID になります。
  • 一度もメッセージを送っていないコメント投稿者を調べること。Meta が同意を設定するのは、相手がアカウントにメッセージを送ったとき、またはアイスブレイカーやメニュー項目をタップしたときだけです。
  • profile_pic の URL を保存すること。Meta によると数日で期限切れになるため、必要になったときに改めて取得してください。
EasyCoexistence で実現する

これにより、Claude、ChatGPT、または独自のコードから、Meta の公式 API を通じてコメントや DM に返信できます。料金は接続ごとに月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。

よくある質問

IGSID は Instagram ユーザー ID と同じですか?

いいえ。IGSID は、一つのプロフェッショナルアカウントに対して人を識別する ID で、IG_ID はプロフェッショナルアカウントそのものを識別します。

Webhook の ID がログイン時の ID と一致しないのはなぜですか?

コード交換が返す user_id は Meta が Instagram スコープと呼ぶもので、Webhook 通知は GET /me が返す user_id を含みます。/me から取得した値を保存してください。

IGSID から Instagram のユーザー名を取得できますか?

はい。User Profile API を使えば取得できます。ただし、相手がアカウントにメッセージを送ったか、アイスブレイカーや永続メニュー項目をタップしている必要があります。

IGSID はアプリをまたいで変わりますか?

変わりません。Meta によると、企業は複数のアプリをまたいで同じ人のやり取りを対応づけられます。ただし、IGSID はプロフェッショナルアカウントごとに異なります。

続きを読む

最初のチャンネルを 2 分で接続しましょう。

プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。

  • 3 日間無料
  • いつでも解約可能
  • 公式 API のみ使用
  • 24/7 監視

確認日