X (旧 Twitter) 連携セットアップ

ViralForge では X 連携用のアプリ登録（X Developer Portal 側の作業）は弊社で完了済みです。お客様は OAuth 認証ボタンを押すだけで X アカウントとの連携が完了します。

1. 事前にご準備いただくもの

• 投稿に使う X アカウント（@ハンドル）
• そのアカウントが 電話番号認証済み であること（X 側の要件）

2. 連携手順

1. 左メニューから 組織設定 を開きます。
2. X の行にある 「+ X アカウントを追加」 ボタンを押します。
3. X のログイン／認可画面に遷移するので、投稿に使う X アカウントでログインし、許可を選択します。
4. 自動で ViralForge に戻り、連携完了です。プラン編集画面の X タブを ON にすれば投稿対象になります。

追加で X アカウントを連携したい場合は、ログアウト後に再度「+ X アカウントを追加」を押してください。複数アカウントを 1 つの組織で運用できます。

3. 仕様

• OAuth 2.0 (PKCE) で接続。tweet.write / media.write / offline.access など必要 scope を ViralForge が自動要求します。
• 長文は 280 字を基準に自動分割し、2 本目以降を reply で連結（スレッド投稿）。
• 画像最大 4 枚（jpg/png/gif、各 5 MB まで）、動画 1 本（mp4、最大 512 MB、3 分以内）まで添付可能。
• access_token / refresh_token は Fernet 暗号化で保存。組織間で分離されています。

4. うまくいかないとき

• 「許可」を押しても戻ってこない：ブラウザのポップアップブロックや拡張機能を一時 OFF にして再試行してください。
• 401 / 403 が出る：組織設定から該当 X アカウントを 再認証 してください。
• 429 (レート超過)：X 側の Free tier の月次投稿上限に達した可能性があります。投稿頻度を下げるか、X 側で有料 tier への切替をご検討ください。
• 解決しない場合はサポート（特商法表記ページ記載の問い合わせ先）までご連絡ください。