Threads連携

Threads APP_ID・APP_SECRETの取得ガイド

Threadsアカウントの準備からMetaアプリの作成、Threads専用ID・シークレットの確認、テスター招待と連携テストまで順に説明します。

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

1. 連携するThreadsアカウントを準備

連携するThreadsプロフィールと、アプリを管理するMeta開発者アカウントを準備します。

  1. Threadsアプリまたはthreads.comにログインし、連携するプロフィールとユーザーネームを確認します。プロフィールがなければ先に作成します。
  2. 上記のMeta開発者コンソールにログインします。初回は開発者登録と画面で求められる認証を完了します。
  3. サービス運営者が管理するアカウントと連絡先メールアドレスを用意し、アプリの管理者権限を確認します。

公式ドキュメント: Threads APIの利用開始

2. 取得する値の一覧

APP_ID・APP_SECRETには以下のThreads専用の値を渡します。ユーザーアクセストークンは認可後に発行される別の値です。

Threads連携のために開発者へ渡す値
受け渡す項目コピーする値確認する場所
APP_IDThreads app IDUse cases > Access the Threads API > Customize > Settings
APP_SECRET同じアプリのThreads app secret同じThreads設定画面のThreads app secret
Redirect URI開発者が指定した正確なHTTPS復帰先Client OAuth Settings > Valid OAuth redirect URIs

公式ドキュメント: Threadsユースケースの設定

3. 作成前に開発者から受け取るもの

  • 開発・本番環境のHTTPS Redirect URI、サービスURL、プライバシーポリシーとデータ削除処理のURLを受け取ります。URLを推測して入力しないでください。
  • 投稿公開、返信の取得・管理、インサイトなど必要な機能とアクセス許可を決めます。使う機能に必要な許可だけを追加します。
  • 連携解除用のDeauthorize callback URLとデータ削除用のData Deletion Requests URLを開発者に確認します。

4. Threadsアプリの作成とキーの確認

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

    My Apps > Create Appでアプリ名と連絡先メールアドレスを入力し、Access the Threads APIユースケースを選んで作成します。所有者情報など、コンソールが求める項目も入力します。

  2. Threadsユースケースの設定を開く

    Use cases > Access the Threads API > Customizeを開きます。threads_basicを確認し、投稿公開ならthreads_content_publishなど、開発者と決めた許可を追加します。

  3. Threads専用ID・シークレットをコピー

    対象ユースケースのSettingsでThreads app IDとThreads app secretの値全体をコピーします。秘密値を表示するための再認証はアカウント所有者が行います。

  4. OAuth復帰先を保存

    Client OAuth Settings > Valid OAuth redirect URIsに開発者指定のHTTPSアドレスを入力します。Deauthorize callback URLとData Deletion Requests URLも確認して保存します。

  5. Threadsテスターを招待

    Add or Remove Threads Test Users、またはApp roles > Roles > Add Peopleで、テストするThreadsユーザーネームをThreads Testerとして追加します。

公式ドキュメント: Threadsユースケースの設定

5. 復帰先とアクセス許可を確認

  • 登録済みRedirect URIとログイン要求のredirect_uriは、プロトコル、ドメイン、パス、末尾のスラッシュまで一致させます。開発・本番のURLを区別します。
  • 基本アクセスにはthreads_basic、投稿公開にはthreads_content_publishが必要です。返信取得はthreads_read_replies、返信管理はthreads_manage_replies、インサイトはthreads_manage_insightsを検討します。
  • 開発者がThreads認可画面での同意とサーバーでのトークン交換を実装します。APP_SECRETをブラウザーに入れず、期限切れ・更新・再認証の処理も確認します。

公式ドキュメント: アクセストークンとアクセス許可 · 長期トークンと更新

5-1. 機能別API権限と承認要件

外部ユーザーが接続する前に、利用する以下の各権限をMeta App Reviewで承認してもらいます。threads_basicは必須で、その他は提供する機能に応じて追加・申請します。

外部ユーザーへの提供前に承認が必要なThreads API権限
権限機能承認要件
threads_basicプロフィール・投稿などの基本アクセス外部ユーザー向けにはApp Review承認が必須
threads_content_publishコンテンツの公開投稿公開機能の提供にはApp Review承認が必須
threads_read_replies返信の取得返信取得機能の提供にはApp Review承認が必須
threads_manage_replies返信の作成・管理返信管理機能の提供にはApp Review承認が必須
threads_manage_insightsインサイトの取得統計機能の提供にはApp Review承認が必須
  1. Use cases > Access the Threads API > Customizeで必要な権限を追加します。権限を追加するだけではMetaの承認は得られません。
  2. コンソールのApp ReviewまたはPublishの審査項目から利用する各権限を申請します。要求される用途説明、再現手順、デモ資料を提出し、権限ごとの承認状況を確認します。
  3. 必要な権限がすべて承認されたらアプリの公開要件を完了します。認可時にユーザーの同意を得て、付与されたトークンで機能が動作するか確認します。

公式ドキュメント: Threads APIの利用開始 · Threadsユースケースの設定

6. 招待の承認・連携テスト・公開

  • 招待したThreadsアカウントにログインし、Settings > Account > Website permissionsでテスター招待を承認します。
  • サービスのThreads連携ボタンからログインしてアクセスを許可します。プロフィール取得と、必要な投稿・返信・インサイト機能を開発者と確認します。
  • アプリのロールを持たない外部ユーザー向けには、必要な許可のApp Review承認とアプリ公開が必要です。Publish画面で求められるアプリ情報、ポリシーURL、審査・認証を完了します。

公式ドキュメント: Threads APIの利用開始 · Threadsユースケースの設定

7. 開発者へ渡す項目

  • アプリ名、Threads app ID(APP_ID)とThreads app secret(APP_SECRET)の値全体。
  • 保存したRedirect URI、連携解除・データ削除処理のURL、開発・本番環境の区別、必要なアクセス許可。
  • Threadsユーザーネーム、テスター招待の承認状況、アプリ公開と許可の審査状況。確認用画像は秘密値を隠して共有します。

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

  • キーが見つからない:Access the Threads APIユースケースのSettingsを開いているか、管理者権限があるか確認します。
  • テスターの連携失敗:招待したThreadsユーザーネーム、招待承認、ログイン中のアカウントが一致するか確認します。
  • 認証・API呼び出しの失敗:同じアプリのThreads専用ID・シークレットか、Redirect URIと許可が正しいか、トークンが期限切れか確認します。

ドキュメント確認日:2026年11月22日。メニュー名や利用できる機能はコンソールのバージョン・言語により異なる場合があります。