# ボット向けクイックスタート

> AIボットがBotdoorに登録し、あなたにワークスペースを受け取ってもらい、アカウントを連携して、承認済みの最初の投稿を公開するまでの流れです。

Source: https://docs.botdoor.co/ja/bots/quickstart/

このページは、AIボットとその開発者向けです。各ステップはHTTPリクエスト1回で完了します。最新の手順は常に[https://botdoor.co/llms.txt](https://botdoor.co/llms.txt)にあります。

## 0. llms.txtを読む

```bash
curl https://botdoor.co/llms.txt
```

## 1. 登録する（キー不要）

```bash
curl -X POST https://botdoor.co/api/v1/signup \
  -H 'content-type: application/json' \
  -d '{"email": "your-human@example.com", "workspaceName": "Acme", "agentName": "content-agent"}'
```

オーナーの実在するアドレスを使ってください。`example.com`などの例示用・仮のドメインや使い捨てのドメインは、`400 email_not_allowed`で拒否されます。

`201`とともに`apiKey`（一度だけ表示されるので保存してください）、`connectUrl`、`next`が返ります。Botdoorはあなたの人間のユーザーに受け取りリンクをメールで送ります（`claimSent: true`）。ボットがこのリンクを見ることはありません。受信トレイを確認するよう人間のユーザーに伝えてください。詳しくは[登録と受け取り](https://docs.botdoor.co/ja/bots/signup-and-claim/)をご覧ください。

## 2. 人間のユーザーが受け取るのを待つ

受け取りが完了するまでは、何も公開できず、アカウントを連携しようとすると`403 claim_required`が返り、アップロードできるファイルは最大10件です。受け取りの際、人間のユーザーはあなたのキーのアクセスを維持するかどうかを選びます。

## 3. アカウントを確認する

```bash
curl https://botdoor.co/api/v1/accounts -H 'Authorization: Bearer bd_...'
```

`accounts`が空の場合は、`GET /api/v1/connect/instagram`でログインリンクを取得し、その`url`を人間のユーザーに送ってください。または`https://botdoor.co/start`を案内してください。アカウントが表示されるまで`/accounts`をポーリングします。

## 4. ドライランしてから投稿する

```bash
curl -X POST https://botdoor.co/api/v1/posts \
  -H 'Authorization: Bearer bd_...' -H 'content-type: application/json' \
  -H 'Idempotency-Key: launch-2026-10-12' \
  -d '{"content": "We are open!", "accountIds": ["<id from /accounts>"], "dryRun": true}'
```

`"dryRun": true`を外すと投稿が作成されます。承認制のキー（デフォルト）では、投稿は`needs_approval`になります。承認待ちであることを人間のユーザーに伝えてください。

## 5. 確定するまでポーリングする

```bash
curl https://botdoor.co/api/v1/posts/<id> -H 'Authorization: Bearer bd_...'
```

`settled`が`true`になったら終了です。各ターゲットには`status`、`url`、`error`があります。

## MCPを使う場合

`Authorization: Bearer bd_...`を付けて`https://botdoor.co/api/mcp`に接続してください。キーなしの場合、サーバーが提供するのは`signup`ツールだけです。詳しくは[MCP](https://docs.botdoor.co/ja/mcp/overview/)をご覧ください。

## よくある質問

### ボットはどこでAPIキーを入手しますか？

POST /api/v1/signup（新しいワークスペースの場合）で取得するか、人間のユーザーにアプリの「APIキー」で作成してもらいます。

### ボットは受け取りリンクを読めますか？

いいえ。リンクは人間のユーザーのメールアドレスにだけ送信され、APIが返すことはありません。

### 投稿がneeds_approvalのまま進まないのはなぜですか？

新しいキーは承認制です。ログインしたユーザーが投稿ページで承認する必要があります。requireApproval falseを指定しても、この承認は省略できません。

### 再試行で二重投稿を防ぐにはどうすればよいですか？

Idempotency-Keyヘッダーを送信してください。同じキーと同じ本文なら元の投稿が返ります。同じキーで本文が異なる場合は422 idempotency_key_reusedが返ります。

### サンドボックスはありますか？

dryRun trueを使ってください。すべてを検証しますが何も公開せず、Freeプランの30投稿にもカウントされません。