Instagram連携

Instagram APP_ID・APP_SECRETの取得ガイド(Unified Login)

プロアカウントへの切り替えから、新規連携用Unified Loginの設定、MetaアプリID・シークレットとConfiguration IDの確認まで順に案内します。

Meta開発者アプリのコンソールを開く

1. Instagramをプロアカウントに切り替える

Unified Loginにはビジネスまたはクリエイターのプロアカウントが必要です。すでに該当する場合は次の項目に進みます。

  1. Instagramアプリで連携するアカウントにログインします。右下のプロフィールを開き、右上のメニューをタップします。
  2. 設定とアクティビティのプロフェッショナル向け項目から、アカウントの種類とツール(Account type and tools)を開きます。アプリのバージョンや言語で名称が異なる場合があります。
  3. プロアカウントに切り替える(Switch to professional account)を選び、アカウントに合うカテゴリを選択します。
  4. 種類を選びます。店舗・ブランド・サービス運営にはビジネス、コンテンツ制作者・アーティスト・インフルエンサーにはクリエイターが適しています。どちらもプロアカウントです。
  5. 連絡先とプロフィールの表示項目を確認して完了します。プロフィールにプロフェッショナルダッシュボードが表示され、設定にビジネスまたはクリエイターのツールがあるか確認します。

PCではinstagram.comにログインし、その他 > 設定 > アカウントの種類とツール > プロアカウントに切り替えるから進みます。カテゴリとビジネス・クリエイターの種類を選び、画面の案内を完了します。

公式ドキュメント: Instagramプロアカウントの設定

2. 用意する認証情報

APP_IDとAPP_SECRETにはMetaアプリの値を使用します。ログイン構成の識別子config_idも必要です。アカウントIDやアクセストークンは別の値です。

Unified Login連携のため開発者に渡す値
引き渡し項目コピーする値確認場所
APP_IDMetaアプリのApp IDApp settings > Basic > App ID
APP_SECRET同じMetaアプリのApp SecretApp settings > Basic > App Secret
config_idログイン構成のConfiguration IDAPI setup with Unified login > Configure your appで選択した構成

公式ドキュメント: Instagramプラットフォームとアクセスレベル · Unified Loginの認証情報

3. Metaアプリ作成前の準備

  • サービス運営者が管理するMeta開発者アカウントと連絡用メールを用意します。初回は開発者登録と要求された認証を完了します。
  • アプリを所有するビジネスポートフォリオとアプリ管理者権限が必要です。使用するInstagramプロアカウントも用意します。
  • 開発者から正確なHTTPS Redirect URL、必要な機能・権限、サービス・プライバシーポリシー・データ削除案内のURLを受け取ります。URLを独自に決めないでください。

4. Unified Loginの設定とキーの確認

  1. Meta開発者アプリを作成

    上のコンソールでMy Apps > Create Appを選びます。サービスのアプリ名と連絡用メールを入力し、アプリを所有するビジネスポートフォリオを接続します。

  2. Instagramのユースケースを開く

    Manage messaging & content on Instagramのユースケースでアプリを作成します。Use cases > 該当ユースケース > Customize > API setup with Unified loginを開きます。

  3. ログイン構成を作成

    Configure your app > Create new configurationで構成を作成します。開発者と必要な権限を確認してEdit permissionsで調整し、Use this configurationを選択します。Configuration ID(config_id)をコピーします。

  4. リダイレクトURLを保存してLogin URLをコピー

    選択した構成のRedirect URLに開発者から受け取ったHTTPSのURLを入力し、Saveを選びます。生成されたLogin URLもコピーしてconfig_idとともに渡します。

  5. MetaアプリのApp IDとApp Secretをコピー

    App settings > BasicでApp IDとApp Secretの完全な値をコピーします。シークレットの表示に認証が必要な場合は所有者が完了します。開発者がこれらをサーバーのAPP_ID・APP_SECRETに設定します。

公式ドキュメント: Unified Loginの設定 · Unified Loginの認証情報

4-1. API権限の追加と審査承認

現在使う機能は投稿公開・コメント・DM・インサイトです。統合ログイン後、Facebookページを経由してInstagramアカウントを接続する本サービスの実装では、以下の8権限が必要で、business_managementは初回審査から除外できます。

現在の機能・接続方式に必要な8権限と除外できる1権限
権限必要か理由
instagram_basic必要基本的なアカウント情報・投稿の取得に使います。
instagram_content_publish必要投稿・ストーリーズの自動公開に使います。
instagram_manage_comments必要コメントへの自動返信に使います。
instagram_manage_messages必要自動DMに使います。
instagram_manage_insights必要分析画面に表示するアカウント・投稿の統計取得に使います。
pages_show_list必要現在のサービスはFacebookページ一覧から紐づくInstagramアカウントを探すため、接続に必要です。
pages_read_engagement必要現在のページ連携方式で、コメント・DM・インサイト機能の権限の依存関係を満たすために必要です。
pages_manage_metadata必要現在の実装でコメント・DM通知をサーバーに届けるページWebhookの購読に必要です。
business_management除外可能現在の機能では使わないため、審査項目を減らす目的で初回申請から除外します。ページを経由しないビジネスアセットの取得・管理が必要になった場合に別途検討します。
  1. API setup with Unified login > Configure your appで構成を開き、Edit permissionsで上記8つの必要な権限を追加します。business_managementは初回申請から除外し、Use this configurationを選んでconfig_idを開発者に渡します。
  2. アプリのロールを持たない外部顧客を連携するには、必要な各権限のAdvanced AccessをApp Reviewで承認してもらいます。コンソールが求める用途説明、再現手順、デモ資料、ビジネス認証を完了し、Liveモードの要件も確認します。
  3. 承認後はログイン構成の要求権限と、ユーザーの同意・トークンに実際に付与された権限を確認します。既存の接続に権限を追加した場合は、追加権限への同意を得るため再認可を行います。

公式ドキュメント: Unified Loginの権限と承認要件 · Metaのページ・ビジネス権限

5. リダイレクトとWebhookの設定確認

  • Redirect URLは認証後にサービスへ戻るURLです。HTTPS、ドメイン、パス、末尾のスラッシュまで実際のログインリクエストと一致させます。開発用・本番用の登録済みURLを区別して渡します。
  • Configure webhooksで開発者が指定した別のCallback URLとVerify tokenを入力し、検証します。必要なイベントを購読し、アカウント接続後のアカウント別購読も開発者が確認します。WebhookとOAuthのURLは用途が異なります。
  • アプリの基本情報、プライバシーポリシー、データ削除案内など現在のコンソールが要求する項目を保存します。

6. テストと一般ユーザーへの公開

  • Generate access tokens > Add accountでテスト用のInstagramプロアカウントを追加します。Instagramのウェブ版で設定 > ウェブサイトのアクセス許可 > アプリとウェブサイト > テスターへの招待から承諾し、Generate tokenでテスト用トークンを取得します。
  • 開発者とLogin URLからのログイン、ビジネスポートフォリオ・Instagramアカウントの選択、権限への同意、Webhook受信を確認します。テスト用トークンはAPP_SECRETとは別で、有効期限は構成で確認します。
  • アプリの役割を持つユーザー向けStandard Accessと外部顧客向けAdvanced Accessを区別します。外部顧客への公開前に必要な権限のAdvanced Access、アプリ審査・ビジネス認証、Liveモードの要件を完了します。

公式ドキュメント: Instagramプラットフォームとアクセスレベル · Unified Loginの設定

7. 開発者に渡す項目

  • アプリ名、MetaアプリのApp ID(APP_ID)・App Secret(APP_SECRET)の完全な値、Configuration ID(config_id)、生成されたLogin URL。
  • 保存したRedirect URL、開発用・本番用の区別、連携したInstagramアカウントとビジネスポートフォリオ、申請・承認済みの権限一覧。
  • テスター招待の承諾状況、アプリモード、ビジネス認証とアプリ審査の状況。設定確認用の画面ではシークレットを隠します。

設定が見つからない・連携に失敗する場合

  • 切り替え項目がない:すでにビジネス・クリエイターか確認し、アカウントの種類とツールまたは該当のプロ向けツールを確認します。
  • Unified Loginのタブがない:ビジネスポートフォリオによるアプリの所有、アプリ管理者権限、Facebook Login for Businessの利用を確認します。Unified Loginはこの機能を基盤とします。
  • 認証に失敗する:APP_ID・APP_SECRETが同じMetaアプリの値か、config_idがそのアプリで選択した構成か、Redirect URLが保存済みURLと一致するか確認します。

ドキュメント確認日:2026年11月22日。メニュー名はアプリのバージョンや言語で異なる場合があります。Instagramヘルプにはログインが必要な場合があります。