# AIコール API

- [AIコール API](https://docs.ai-call.co/index.md): 自社のシステムからAIエージェントで電話をかけ、通話の結果を受け取れます。
- [認証](https://docs.ai-call.co/authentication.md): APIキーを Authorization ヘッダーで送ります。
- [エラー](https://docs.ai-call.co/errors.md): エラーは HTTP ステータスと、code・message を持つ JSON で返します。
- [概要](https://docs.ai-call.co/calls/overview.md): 発信前の確認、二重発信の防止、結果の受け取りまでの流れです。
- [電話をかける](https://docs.ai-call.co/calls/create.md): 指定したAIエージェントで電話をかけます。発信キューに入った時点で `202` を返し、同時通話枠が空き次第かけます。 結果は「通話を取得する」か、Webhook の `call.ended` で受け取ります。 通話料は管理画面からの発信と同じです（1秒0.6円、不在10円、税抜）。
- [発信前の確認](https://docs.ai-call.co/calls/preflight.md): 電話はかけずに、発信を止める理由（番号の形式、架電禁止、発信できる時間帯、残高、発信の上限など）がないかを確認します。本文は「電話をかける」と同じです。
- [通話の一覧](https://docs.ai-call.co/calls/list.md): 通話を新しい順に返します。次のページは `next_cursor` を `cursor` に渡して取得します。
- [通話を取得する](https://docs.ai-call.co/calls/get.md): 1件の通話の状況・結果・料金・文字起こしを返します。
- [AIエージェントの一覧](https://docs.ai-call.co/agents/list.md)
- [AIエージェントを取得する](https://docs.ai-call.co/agents/get.md)
- [電話番号の一覧](https://docs.ai-call.co/phone-numbers/list.md): このアカウントの電話番号と、着信・発信に使うAIエージェントを返します。
- [概要](https://docs.ai-call.co/webhooks/overview.md): 通話が終わったときに、結果を指定のURLへ受け取ります。
- [送信先を追加する](https://docs.ai-call.co/webhooks/create.md): 通話の結果を受け取るURLを追加します。署名用のシークレット（`secret`）はこの応答でだけ返ります。1アカウント5件まで。
- [送信先の一覧](https://docs.ai-call.co/webhooks/list.md)
- [送信先を削除する](https://docs.ai-call.co/webhooks/delete.md)
- [テスト送信](https://docs.ai-call.co/webhooks/test.md): この送信先に `webhook.test` イベントをすぐ送ります。
- [送信記録](https://docs.ai-call.co/webhooks/deliveries.md): 直近50件の送信と結果を返します（30日間保存）。

## OpenAPI Specs

- [openapi](/openapi.yaml)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.