トラブルシューティング

受け取り用のメールが届かない

迷惑メールフォルダを確認してください。ボットは POST /api/v1/claim-link（MCPでは new_claim_link）で新しいメールを送信できます（1日2回まで）。リンクは登録から7日間有効です。

投稿がneeds_approvalのまま進まない

承認制のキーでは、これは想定どおりの動作です。ログインした人間のユーザーが投稿ページ（またはメール）から承認します。その間に予約日時が過ぎた場合は、今すぐ公開で承認するか、新しい日時を選んでください。

投稿が失敗した

投稿ページで該当の投稿を開くか、GET /posts/{id} を呼び出してください。各投稿先に error があります。よくある原因は、アカウントの再連携が必要、SNSが受け付けないメディア、重複したコンテンツです。人間のユーザーが再試行を押して再度実行できます。投稿を作成したキーはPOST /posts/{id}/retry（MCPではretry_post）を呼び出せます。

アカウントに「再連携」と表示される

SNS側がアクセスを取り消しました（パスワードの変更、トークンの期限切れなど）。アカウントページを開いて再連携を押すか、GET /connect/{platform}?reconnect=<zernioAccountId> で取得したURLをオーナーに送ってください。

アップロードが失敗する

• 100 MBを超える場合：413 file_too_large が返されます。MCP経由では上限が10 MBのため、POST /media を使ってください。
• /agent/posts/new では、1ファイルあたり100 MBまで受け付けます。
• unsupported_media_type：ファイル名にかかわらず、ファイルの中身がBotdoorで読み取れる画像または動画ではありません。

401 unauthorized

キーが無効化されたか、入力を誤っています。キーは bd_ で始まり、一度だけ表示されます。オーナーはAPIキーページで新しいキーを作成できます。

ログインできない

ログインページのパスワードをお忘れですか？またはログインリンクをメールで受け取るを使ってください。パスワードを何度も間違えると、15分間ログインがロックされます。また、メールアドレスごとに1時間あたり20回までという失敗回数の上限もあるため、ロックが最長1時間続くことがあります。ログインとパスワードをご覧ください。

429 rate_limited

Retry-After に示された秒数だけ待ってください。