Skip to main content
POST
電話をかける

Authorizations

Authorization
string
header
required

管理画面「設定 → API」で作成したAPIキー(aic_sk_…)。

Headers

Idempotency-Key
string
required

同じ発信の再送で二重に電話をかけないためのキー(英数字と _ . : -、200文字まで)。24時間、同じキーと同じ内容の再送には最初の結果を返します。

Maximum string length: 200
Example:

"order-1024"

Body

application/json
agent_id
string
required

使うAIエージェントのID

Example:

"0123456789abcdef01234567"

to
string
required

発信先の日本の電話番号(フリーダイヤル等は不可)

Example:

"090-1234-5678"

phone_number_id
string

発信元の電話番号のID。省略時はこのエージェントの発信番号、既定の発信番号、使える番号の順

purpose
string

今回の電話の目的(通話記録に残ります)

Maximum string length: 500
Example:

"資料請求のお礼と面談のご案内"

contact
object

この通話だけの相手の情報

variables
object

会話で使う項目(英数字の名前40文字・値500文字、50個まで)

Example:
metadata
object

通話とWebhookにそのまま返す自由な値(英数字の名前40文字・値500文字、20個まで)

Example:

Response

発信キューに入りました。

id
string

通話のID

status
string
Allowed value: "queued"
to
string
Example:

"+819012345678"

from
string
Example:

"+815012345678"

agent
object | null
metadata
object