> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneinbox.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# はじめに

> OneInbox は、ライブ電話と Web 会話を処理する AI エージェントを構築するための音声オーケストレーションプラットフォームです。

## OneInbox とは

OneInbox は、電話とブラウザを通じてライブ音声会話を処理する AI エージェントを構築するための **音声オーケストレーションプラットフォーム**です。

REST API を通じてエージェント、ボイス、通話の動作を設定します。OneInbox はリアルタイム音声、音声認識、テレフォニールーティング、スケーリングを処理します。

***

## キー

OneInbox には 2 種類のキーがあります。どちらを使うかはコードが動作する場所によって異なります — その違いこそが両方が存在する理由です。

| キー          | 先頭文字     | 動作場所          | できること                       |
| ----------- | -------- | ------------- | --------------------------- |
| **API キー**  | `oi_sk_` | サーバー（バックエンド）  | すべて — エージェント作成、通話発信、データ読み取り |
| **公開可能なキー** | `oi_pk_` | ブラウザ（フロントエンド） | 通話を開始するのみ — それ以外は不可         |

このセクションのすべてには **API キー**を使用します。**公開可能なキー**については [Web SDK](/concepts/web-sdk) を参照してください — 作成方法が異なり、ウェブサイト訪問者がサイトから直接通話を開始できるようにするためのみに使用します。

<Info>
  **最初の API 呼び出しを行う前に**、API キーを取得してください：

  1. [無料アカウントを作成 →](https://oneinbox-dashboard.vercel.app/signup)
  2. **API Keys** に移動して **Create API key** をクリック
  3. キーをコピー — `oi_sk_` で始まります
  4. すべてのリクエストで `Authorization: Bearer <api_key>` として使用

  すでにアカウントをお持ちの場合は [ダッシュボードにログイン →](https://oneinbox-dashboard.vercel.app/login)

  ログイン後、API キーを使ってダッシュボードで通話ログ（トランスクリプト、結果、レイテンシの詳細）を直接閲覧できます。
</Info>

***

## 構築できるもの

| ユースケース             | 方法                                                                            |
| ------------------ | ----------------------------------------------------------------------------- |
| **アウトバウンド発信ボット**   | エージェントがリードに電話をかけ、資格確認し、デモを予約する                                                |
| **インバウンドサポートライン**  | 電話番号を割り当てる — 発信者が 24/7 エージェントに繋がる                                             |
| **ウェブサイト音声ウィジェット** | 公開可能なキーで [Web SDK](/concepts/web-sdk) をサイトに追加する — 訪問者が電話番号不要でブラウザ内でエージェントと話せる |

***

## 通話の仕組み

発信者が話す → テキストに変換 → LLM が応答を決定 → 発信者に音声で返す。OneInbox がこのループをリアルタイムで実行します。→ [仕組み](/concepts/how-it-works)

***

## はじめましょう

<CardGroup cols={2}>
  <Card title="クイックスタート" icon="rocket" href="/guides/quickstart">
    エージェント + 電話番号 + 最初の実際の通話
  </Card>

  <Card title="エンドツーエンドのウォークスルー" icon="list-check" href="/guides/build-first-agent">
    完全なアウトバウンド発信ボット — エージェント、ツール、電話番号、通話、結果
  </Card>

  <Card title="API リファレンス" icon="code" href="/api-reference/agents/create-agent">
    インタラクティブな「Try It」付きのすべてのエンドポイント
  </Card>

  <Card title="認証" icon="key" href="/concepts/authentication">
    API キーを取得してリクエストを開始する
  </Card>
</CardGroup>
