Instagram連携
Instagram APP_ID・APP_SECRETの取得ガイド(Unified Login)
プロアカウントへの切り替えから、新規連携用Unified Loginの設定、MetaアプリID・シークレットとConfiguration IDの確認まで順に案内します。
Meta開発者アプリのコンソールを開く1. Instagramをプロアカウントに切り替える
Unified Loginにはビジネスまたはクリエイターのプロアカウントが必要です。すでに該当する場合は次の項目に進みます。
- Instagramアプリで連携するアカウントにログインします。右下のプロフィールを開き、右上のメニューをタップします。
- 設定とアクティビティのプロフェッショナル向け項目から、アカウントの種類とツール(Account type and tools)を開きます。アプリのバージョンや言語で名称が異なる場合があります。
- プロアカウントに切り替える(Switch to professional account)を選び、アカウントに合うカテゴリを選択します。
- 種類を選びます。店舗・ブランド・サービス運営にはビジネス、コンテンツ制作者・アーティスト・インフルエンサーにはクリエイターが適しています。どちらもプロアカウントです。
- 連絡先とプロフィールの表示項目を確認して完了します。プロフィールにプロフェッショナルダッシュボードが表示され、設定にビジネスまたはクリエイターのツールがあるか確認します。
PCではinstagram.comにログインし、その他 > 設定 > アカウントの種類とツール > プロアカウントに切り替えるから進みます。カテゴリとビジネス・クリエイターの種類を選び、画面の案内を完了します。
公式ドキュメント: Instagramプロアカウントの設定
2. 用意する認証情報
APP_IDとAPP_SECRETにはMetaアプリの値を使用します。ログイン構成の識別子config_idも必要です。アカウントIDやアクセストークンは別の値です。
| 引き渡し項目 | コピーする値 | 確認場所 |
|---|---|---|
| APP_ID | MetaアプリのApp ID | App settings > Basic > App ID |
| APP_SECRET | 同じMetaアプリのApp Secret | App settings > Basic > App Secret |
| config_id | ログイン構成のConfiguration ID | API setup with Unified login > Configure your appで選択した構成 |
公式ドキュメント: Instagramプラットフォームとアクセスレベル · Unified Loginの認証情報
3. Metaアプリ作成前の準備
- サービス運営者が管理するMeta開発者アカウントと連絡用メールを用意します。初回は開発者登録と要求された認証を完了します。
- アプリを所有するビジネスポートフォリオとアプリ管理者権限が必要です。使用するInstagramプロアカウントも用意します。
- 開発者から正確なHTTPS Redirect URL、必要な機能・権限、サービス・プライバシーポリシー・データ削除案内のURLを受け取ります。URLを独自に決めないでください。
4. Unified Loginの設定とキーの確認
Meta開発者アプリを作成
上のコンソールでMy Apps > Create Appを選びます。サービスのアプリ名と連絡用メールを入力し、アプリを所有するビジネスポートフォリオを接続します。
Instagramのユースケースを開く
Manage messaging & content on Instagramのユースケースでアプリを作成します。Use cases > 該当ユースケース > Customize > API setup with Unified loginを開きます。
ログイン構成を作成
Configure your app > Create new configurationで構成を作成します。開発者と必要な権限を確認してEdit permissionsで調整し、Use this configurationを選択します。Configuration ID(config_id)をコピーします。
リダイレクトURLを保存してLogin URLをコピー
選択した構成のRedirect URLに開発者から受け取ったHTTPSのURLを入力し、Saveを選びます。生成されたLogin URLもコピーしてconfig_idとともに渡します。
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は初回審査から除外できます。
| 権限 | 必要か | 理由 |
|---|---|---|
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 | 除外可能 | 現在の機能では使わないため、審査項目を減らす目的で初回申請から除外します。ページを経由しないビジネスアセットの取得・管理が必要になった場合に別途検討します。 |
- API setup with Unified login > Configure your appで構成を開き、Edit permissionsで上記8つの必要な権限を追加します。business_managementは初回申請から除外し、Use this configurationを選んでconfig_idを開発者に渡します。
- アプリのロールを持たない外部顧客を連携するには、必要な各権限のAdvanced AccessをApp Reviewで承認してもらいます。コンソールが求める用途説明、再現手順、デモ資料、ビジネス認証を完了し、Liveモードの要件も確認します。
- 承認後はログイン構成の要求権限と、ユーザーの同意・トークンに実際に付与された権限を確認します。既存の接続に権限を追加した場合は、追加権限への同意を得るため再認可を行います。
公式ドキュメント: 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ヘルプにはログインが必要な場合があります。