Meta アプリ作成〜Live公開 完全ガイド(IG Harness セットアップ編 #1)
Shudesu
Author
Meta アプリ作成〜 Live 公開 完全ガイド(IG Harness セットアップ編 #1)
Instagram Harness を動かすには Meta for Developers で新規アプリを作成し、Live モードで公開する必要がある。作業自体はウィザードに従うだけなのだが、ユースケース選択・ビジネスマネージャ紐付け・プライバシーポリシー URL・permission 取得・Live 切り替えと段階が多く、実際にやると1〜2時間は溶ける。このガイドでは実セットアップで踏んだ罠を含めて、最短パスを示す。
全体像
1. developers.facebook.com にログイン
2. アプリ作成(ユースケース: Instagramでメッセージとコンテンツを管理)
3. アプリ名・ビジネスマネージャ選択
4. カテゴリを「ビジネスアプリ」に変更
5. プライバシーポリシー URL と利用規約 URL を設定
6. Instagram 製品を追加
7. 必要な permission の Standard Access を取得
8. Development → Live に切り替え
9. (任意)App Review — 自分用なら不要
本記事ではステップ1〜4と8〜9をカバーする。プライバシーポリシー URL の罠は別記事、Instagram API 設定とトークン取得はさらに別記事で扱う。
ステップ1: Meta for Developers にログイン
https://developers.facebook.com にアクセス。個人 Facebook アカウントでログインできる(ビジネスアカウント不要)。ただしメール認証 + 電話番号認証が済んでいないと「アプリを作成」ボタンが出ないので、プロフィール設定から先に済ませる。
ステップ2: アプリを作成
右上「マイアプリ」→「アプリを作成」をクリック。
次の画面でユースケースを選ぶ。ここが最初の分岐:
| 選択肢 | 推奨 | 理由 |
|---|---|---|
| Instagramでメッセージとコンテンツを管理 | ⭕️ | Instagram API が自動配置され、必要 permission のテンプレートも揃う |
| ビジネスでコラボレーション | ❌ | WhatsApp / FB 寄り、IG は二次対象 |
| 広告を管理 | ❌ | Marketing API 向け |
| カスタマイズ(その他) | ❌ | 最初から permission を手動追加する必要あり |
「Instagramでメッセージとコンテンツを管理」一択。「カスタマイズ」を選ぶと instagram_business_manage_messages が permission 一覧に出てこないことがあって、後からやり直しになる。
ステップ3: アプリ名とビジネスマネージャ
- アプリ名: 任意(例:
i-harness、my-ig-bot等) - 連絡先メール: ログインアカウントのメールがデフォルト
- ビジネス: ビジネスマネージャを選択
ビジネスマネージャが未作成の場合、画面から「新規作成」できる。ビジネスマネージャの名前は自分の名前でも法人名でも OK(後から変更可能)。
実例では「野田修一」という個人名ビジネスマネージャで作成、問題なし。
ステップ4: カテゴリを「ビジネスアプリ」に変更
アプリ作成直後はカテゴリが 「アプリ」 になっている。そのままだと一部 permission が Standard Access として取得できない。
- 左メニュー「設定」→「ベーシック」
- カテゴリの項目を編集し「ビジネスアプリ」に変更
これを忘れると後のステップ7で instagram_business_manage_messages の Standard Access リクエスト時に「このアプリカテゴリでは利用できません」と弾かれる。
ステップ5: プライバシーポリシーと利用規約 URL
両方とも HTTPS の有効な URL が必須。詳細と罠は別記事参照(プライバシーポリシー・利用規約 URL セットアップ編)。とりあえず Cloudflare Workers 上に /privacy と /terms のハンドラを用意して URL をここに入力する、という流れ。
ステップ6: Instagram 製品を追加
アプリダッシュボードのトップページ「製品」セクション → 「Instagram」の 「設定」ボタンをクリック。左メニューに「Instagram」が表示され、「API setup with Instagram business login」画面に遷移できるようになる。
合わせて「ビジネス向け Facebook ログイン」も追加しておく。Instagram Business Login フローで使う。
ステップ7: permission の Standard Access 取得
ここで個別 permission を取る。左メニュー「アプリレビュー」→「権限と機能」。
取得すべきリスト:
| permission | 必須度 | 用途 |
|---|---|---|
instagram_business_basic | ⭕️ | IG アカウント基本情報 |
instagram_business_manage_messages | ⭕️ | DM 送受信(これが無いと自動返信不可) |
instagram_business_manage_comments | ⭕️ | コメント読み取り・リプライ |
instagram_manage_comments | ⭕️ | 上の古い別名、両方取ると安全 |
instagram_business_manage_insights | 🔶 | 投稿インサイト(分析する場合) |
instagram_business_content_publish | 🔶 | 投稿の作成・公開(使わなくても取得可能) |
Human Agent | ⭕️ | 24時間の messaging window 外でも返信する機能 |
openid | ⭕️ | OAuth ログイン(Instagram Business Login 用) |
各 permission の「Standard Access をリクエスト」ボタンを押す。質問が出る:
- ビジネスの種類 → 正直に回答(個人事業主なら「Solo entrepreneur」等)
- データの使用目的 → 「自社 IG アカウントの DM 自動化」などでよい
- エンドユーザーのデータ保存の有無 → IGSID は保存するなら Yes
回答後、自動承認で数秒〜数分で Standard Access が付与される。Advanced Access とは違い App Review 不要。
ステップ8: Development → Live に切り替え
右上のトグルが「Development Mode」になっている。これを 「Live」にクリックで切り替える。
Live にできない時のエラー対処
| エラー | 原因 | 対処 |
|---|---|---|
| プライバシーポリシー URL が無効 | URL が 200 を返していない、または HTTPS ではない | Worker で /privacy ハンドラを実装・デプロイ |
| 利用規約 URL が無効 | 同上 | /terms or /privacy-policy を実装 |
| カテゴリが設定されていない | カテゴリが「アプリ」のまま | 「ビジネスアプリ」に変更 |
| アプリアイコンが未設定 | アイコン画像 1024x1024 以上が必要 | アップロード(一時的なロゴで OK) |
Live にしないと webhook が一般ユーザーから飛んでこない。テスターロールを持った IG アカウントからはテストできるが、本番運用には Live 必須。
実体験: Live にした瞬間、テスター以外からも webhook 飛んできた
初期は「App Review してないから一般ユーザーは無理でしょ」と思い込んで、テスターロールを追加した IG アカウントからしかテストしてなかった。実際にやってみると、Live モード + Standard Access 取得済みの状態なら、テスターではない第三者の IG アカウントからコメントされても webhook がちゃんと飛んできて、DM も普通に送れた。
つまり:
- テスターロール登録は初期の動作確認用であって、本番運用の必須条件ではない
- Standard Access + Live さえ揃えば、App Review なしで一般ユーザーから届く DM・コメントを全部処理できる
- Advanced Access が必要な特殊 permission(買い物タグ付け等)を使う場合のみ App Review が要る
これを知らないと「App Review の申請書面書かなきゃ…」と1日潰すので注意。
ステップ9: App Review は大半のケースで不要
Live 化後、「アプリレビュー」にアイコンが出るが、自分 / 自社の IG アカウントに対してのみ使うなら App Review は不要。Standard Access + Live で一般ユーザーからも webhook が飛ぶ。
App Review が必要になるのは:
- 第三者のクライアント IG アカウントを連携させる SaaS を提供する
- Advanced Access が必要な permission を使う(
instagram_shopping_tag_products等)
ManyChat や i ステップ代替の自己運用ツールであれば、Standard Access で十分。
チェックリスト
このガイド完了時、Meta Dashboard で以下が揃っているはず:
- アプリが作成済みで、カテゴリが「ビジネスアプリ」
- ビジネスマネージャが紐付いている
- プライバシーポリシー・利用規約 URL が設定済み
- Instagram 製品が追加されている
- 必須 permission(instagram_business_basic / manage_messages / manage_comments / Human Agent / openid)の Standard Access 取得済み
- アプリのモードが「Live」
これでようやく前準備が完了。次はプライバシーポリシー URL の罠編、Instagram アカウント紐付け編、Webhook 設定編へ。
このシリーズの他の記事
コメント (0)
コメントするにはログインしてください。