# トラブルシューティング

> Botdoorでよくある問題の解決方法です。受け取り用メールが届かない、投稿が承認待ちのまま進まない、投稿の失敗、再連携、大きなファイルのアップロードについて説明します。

Source: https://docs.botdoor.co/ja/help/troubleshooting/

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

迷惑メールフォルダを確認してください。ボットは `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時間続くことがあります。[ログインとパスワード](https://docs.botdoor.co/ja/humans/sign-in-and-password/)をご覧ください。

## 429 rate_limited

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

## よくある質問

### 予約した投稿が公開されなかったのはなぜですか？

予約日時が過ぎた時点で、投稿が承認待ちだったためです。承認されていない投稿は公開されません。「今すぐ公開」を選ぶか、新しい日時を指定して承認してください。

### 投稿が失敗した理由はどこで確認できますか？

投稿ページで該当の投稿を開くか、GET /api/v1/posts/{id} を呼び出してtargets[].errorを確認してください。

### 問い合わせ先はどこですか？

投稿IDまたはエラーコードを添えて、hello@botdoor.coまでメールでご連絡ください。