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

# AIコール API

> 自社のシステムからAIエージェントで電話をかけ、通話の結果を受け取れます。

AIコール API を使うと、CRM や予約システムなど自社のシステムから、AIコールのAIエージェントで電話をかけられます。通話が終わると、結果と文字起こしを Webhook で受け取れます。

## できること

> [card] [電話をかける](https://docs.ai-call.co/calls/overview.md)
>
> AIエージェントと発信先を指定して電話をかけます。

> [card] [結果を受け取る](https://docs.ai-call.co/webhooks/overview.md)
>
> 通話が終わると、結果・料金・文字起こしを指定のURLへ送ります。

> [card] [通話を確認する](https://docs.ai-call.co/calls/list.md)
>
> 通話の状況・結果・文字起こしを取得します。

> [card] [エージェントを確認する](https://docs.ai-call.co/agents/list.md)
>
> 発信に使うAIエージェントと電話番号を取得します。

## ベースURL

```
https://api.ai-call.co
```

## はじめかた

**1. APIキーを作る**

管理画面の「設定 → API」でAPIキーを作成します。キーは作成したときに一度だけ表示されます。詳しくは[認証](https://docs.ai-call.co/authentication.md)を参照してください。

**2. AIエージェントのIDを確かめる**

発信に使うAIエージェントのIDを取得します。

```bash theme={null}
curl https://api.ai-call.co/agents \
  -H "Authorization: Bearer $AICALL_API_KEY"
```

**3. 電話をかける**

```bash theme={null}
curl https://api.ai-call.co/calls \
  -H "Authorization: Bearer $AICALL_API_KEY" \
  -H "Idempotency-Key: order-1024" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": "0123456789abcdef01234567", "to": "090-1234-5678"}'
```

**4. 結果を受け取る**

[Webhook](https://docs.ai-call.co/webhooks/overview.md)を設定すると、通話が終わったときに結果が届きます。

## 料金

API の利用料はかかりません。通話料・不在料金・SMS は管理画面からの利用と同じです（通電1秒0.6円、不在1件10円、SMS 1件15円。税抜）。

## 決まりごと

* 日時は ISO 8601（UTC）、IDは24桁の英数字、電話番号は E.164（`+81…`）で返します。
* 電話番号は日本国内の番号を受け付けます。フリーダイヤル・ナビダイヤル（0120・0800・0570・0180・0990）には発信できません。
* 発信できる時間帯は日本時間の9:00〜20:00です。


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