Skip to main content

1. 発信前に確かめる(任意)

発信前の確認は、電話をかけずに、発信を止める理由がないかを返します。

2. 電話をかける

  • 202 は「発信キューに入った」という意味です。同時通話枠(5件込み)が空き次第かけます。
  • contact と variables は、この通話だけAIエージェントに渡す相手の情報です。保存済みの連絡先より優先されます。
  • metadata は自由な値で、通話の取得結果と Webhook にそのまま返ります。自社のIDを入れておくと、結果を突き合わせやすくなります。

二重に電話をかけないために

Idempotency-Key ヘッダーは必須です。通信エラーなどで同じリクエストを送り直しても、24時間以内に同じキー・同じ内容なら最初の結果を返し、電話は一度しかかけません。
  • 1件の発信ごとに一意の値(自社の注文IDなど)を使ってください。
  • 同じキーで内容が違うと 422 idempotency_key_reused になります。
  • 架電禁止・時間外・残高不足などで断られたリクエストのキーは、原因を直してから使い直せます。

発信を止める確認

次のどれかに当たると、電話はかけずにエラーを返します。API から外すことはできません。
  • 電話番号の形式(日本国内の番号のみ。フリーダイヤル等は不可)
  • AIエージェント(このアカウントのもので、会話が設定済み)と発信元の電話番号
  • 架電しない設定・一時停止中の連絡先
  • 発信できる時間帯(日本時間9:00〜20:00)
  • 契約・残高
  • 発信の上限(1分60件・24時間2000件)

3. 結果を受け取る

通話が終わったら、Webhook の call.ended で結果が届きます。または通話を取得するで確かめられます。
主な result: