IG Harnessはじめに·

Meta アプリ作成〜Live公開 完全ガイド(IG Harness セットアップ編 #1)

Shudesuのプロフィール画像

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-harnessmy-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 設定編へ。

このシリーズの他の記事

#setup#meta#dashboard#permissions#live
この記事が役に立ったら投票してください

コメント (0)

コメントするにはログインしてください。

Meta アプリ作成〜Live公開 完全ガイド(IG Harness セットアップ編 #1) — Harness Wiki