開発者向け（音声）
組織とエージェントのIDを確認し、Webhookを管理し、APIキーと公開APIのエンドポイントを確認します。
場所
音声 › 音声の概要 › 開発者向け
この画面を開く
ステップ
- 音声 › 音声の概要 を開き、「開発者向け」の「ページを開く」を押します。
- 「エージェントID / API」で「組織 ID」「組織スラッグ」または「エージェントID」をコピーします。
- 「Webhook」で「エンドポイントを追加」を押し、自社のhttpsアドレスで通話と連絡先のイベントを受け取ります。
- 「APIキー」でキー、最終使用日時、状態（「有効」または「取り消し済み」）を確認します。
- 「公開エンドポイント」と「ドキュメント」でエンドポイントをコピーするか、「API リファレンスを開く」を押します。
この画面の設定
| 設定項目 | 内容 | 既定値 |
|---|---|---|
| エージェントID / API | 組織 ID、組織スラッグ、API モード（サンドボックスまたは稼働中）、選んだAIエージェントのエージェントID。 | — |
| Webhook | httpsのエンドポイント、イベント、最後の配信と失敗数。 | — |
| APIキー | CallDeskの運営者が発行したキー：名前、先頭の文字、スコープ、最終使用、リクエスト数、状態。 | — |
| 公開エンドポイント | /api/v1 のエンドポイント（それぞれ「コピー」ボタン付き）とエージェントのチャットのエンドポイント。 | — |
| ドキュメント | 「API リファレンスを開く」と OpenAPI (JSON)。 | — |
ヒント
- キーは "Authorization: Bearer <key>" として送ります。
知っておきたいこと
- このページはどなたでも閲覧でき、Webhookの追加・テスト・削除は管理者だけができます。
- エージェントの声で返答を読み上げるAPIはなく、その行は「まだ接続されていません」と表示されます。
関連するハウツー
- 組織とエージェントのIDをコピーする 公開APIを呼び出すのに必要なIDを取得します。
- Webhookを追加してテストする 通話と連絡先のイベントを自社のhttpsエンドポイントで受け取ります。署名付きなので、CallDeskからの送信か確認できます。
- APIキーを確認する 組織のAPIキーと、その使われ方を確認します。
- 公開APIのエンドポイントとドキュメント 通話とエージェント用のAPIエンドポイントを確認し、リファレンス全体を開きます。
- 開発者向け：Webhookの問題の解決 開発者向けのページに表示されるメッセージを解決します。
- 開発者向けAPIリファレンス ご自身のアプリをワークスペースにつなぐためのREST API、キーとスコープ、エラー、レート制限、Webhookの説明です。