FAQ (よくある質問)
トラブル発生時の対処方法と、よく聞かれる質問への回答をまとめています。SNS 固有の設定方法は各 セットアップ手順 (このページ末尾のリンク) を参照してください。
投稿が失敗した時
まず確認すること
- 進捗管理 画面で該当プランの
ERROR 状態を確認
- ワークフロー詳細を開いて、どの Phase (1: 本文生成 / 2: メディア / 3: 投稿) で失敗したかを特定
- エラーメッセージに応じて対処 (下記参照)
よくあるエラー原因
- 認証エラー (SNS API token 期限切れ、401 / 403): SNS の access token が期限切れ。設定画面 → 組織 or プラン単位で credential を再登録
- NOTE の cookie 認証エラー: NOTE は cookie 認証 (2026-04-28〜) で運用しています。
cookies not configured (cookie 未投入) または cookie_session_invalid (期限切れ / 強制 logout) が出た場合は、運営サポートに cookie 再投入 を依頼してください。詳細は NOTE セットアップ §6 参照
- NOTE の Selenium timeout (note.com 側のレイアウト変更や network 遅延): 翌日自動再試行で多くは解消、数日続く場合は運営サポートに連絡
- quota 超過: OpenAI / Kling / 各 SNS API の日次/月次クオータに到達。全体設定の日次予算を確認
- picture/video not found: 流用元 SNS がまだ生成していない時刻で流用スロットが走った。投稿時刻の順序を見直す
ERROR が発生しても、翌日の実行サイクルで自動的にリトライされます。恒常的に失敗する場合のみ手動対応を。
承認期限切れの復帰
manual モードで承認待ちになってから デフォルト 24 時間 (プランごとに運営側で調整可能) 放置すると SKIPPED に変わります。期限切れした投稿を投稿し直したい場合:
- 進捗管理でプランの状態を確認
- 翌日の実行サイクルが走れば、自動的に新しい承認待ちが生成される
- 緊急でその日のうちに投稿したい場合は、プラン詳細から「今すぐ実行」で再実行
SKIPPED になった投稿のコンテンツ自体は復元できません (再実行で別のコンテンツが生成される)。期限切れが多発する場合は承認モードを auto か skip に変更検討。
KPI が取れない時
KPI 収集の仕組み
投稿後 2 時間おきに metrics collector が各 SNS API / GA4 から数値を取得し、 post_metrics と post_lp_metrics に保存します。GA4 sync は毎日 03:00 JST、週次分析は月曜 06:00 JST (5 件以上の投稿がある場合)。
取れない場合の原因
- credential 不足: SNS 別 API token (NOTE は cookie 認証) + GA4 credential の両方が必要。設定画面で登録済みか確認
- NOTE の cookie 失効による KPI 失敗: NOTE の KPI 取得も cookie 認証経由のため、
cookie_session_invalid が出ると KPI も取れません。運営サポートに cookie 再投入を依頼してください (NOTE セットアップ §6 参照)
- 投稿直後: SNS 側のインデックス反映に 30 分〜数時間かかる。最初の収集は投稿 2h 後
- GA4 プロパティ未設定: LP 流入を計測するには GA4 のプロパティ ID と LP URL パターンの登録が必要 (GA4 連携手順 (Service Account 登録 + 二段階確認)参照)
- 閲覧権限不足: ユーザー権限で GA4 API が見えない場合がある。admin で再確認
画像/動画生成失敗時
画像 (gpt-image-2 + 文字焼込み)
2026-04-25〜 gpt-image-2 + bake_text=True (画像内に直接テキストを焼き込む方式) で本番運用。
- ポリシー違反: OpenAI のコンテンツポリシーに触れる描写 (実在人物・暴力・性的内容) を避ける。プロンプトを穏当に書き直す
- 予算超過: 日次予算を全体設定で確認、必要なら増額 or 1 日の生成枚数を減らす
- API error (500 / timeout): OpenAI 側の一時障害。自動リトライで大半は解消、継続する場合は OpenAI status を確認
動画 (Kling AI 3 via fal.ai)
- 生成失敗: Kling のキューが詰まっているケースあり。時間を空けて再実行
- 予算超過: 動画は 1 本 $0.5〜 と高額。週間生成数の上限で投稿数を制御
- フォールバック動作: 生成失敗時はメディアプールの素材 → ライブラリ → 流用 の順で代替。全て失敗すると「メディアなし」投稿にフォールバック
週次自動生成でプールに素材を貯めておくと、当日生成失敗時のフォールバック素材として機能します。
SNS 固有のトラブル
各 SNS 特有の初期設定やトラブル対応は、それぞれのセットアップ手順を参照してください。