メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.oneinbox.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
コール結果とは？

コール結果とは、完了した通話に割り当てられるラベルで、その結果を要約したものです。通話終了後に自動的に設定され、通話レコードの analysis オブジェクト内に格納されます。手動で設定または上書きすることも可能で、ワークスペース独自のカスタム結果ラベルを作成することもできます。 確認方法： 
curl https://api.oneinbox.ai/v1/calls/<call_id> \
  -H "Authorization: Bearer <api_key>"

{
  "id": "call_abc123",
  "status": "completed",
  "duration_seconds": 94,
  "analysis": {
    "outcome": "Appointment Booked",
    "summary": "発信者は木曜日の午後2時に製品デモを承諾しました。"
  },
  "messages": [...]
}

​
組み込みの結果ラベル

OneInboxにはすべてのアカウントで利用可能なプラットフォームレベルの結果が用意されています：
結果（保存形式）意味典型的なトリガー
Appointment Booked会議やデモが予定された発信者が特定の時間に同意した
Not Interested発信者が明示的に断った「興味ない」「リストから外して」
Not Connected会話が成立しなかった未応答、話中、即切断
Voicemail留守番電話が検出された留守番検出が有効で起動した
Interested発信者は関心を示したが確約しなかったポジティブな会話、予約なし
null結果が分類されなかった通話が短すぎるか曖昧

​
自動分類の仕組み

すべての通話終了後、OneInboxは文字起こしを読み取り、自動的に結果を割り当てます。設定は不要です。 いくつかの注意点：
  • 分類は通話後に行われます。 アクティブな通話中は analysis.outcome は null です。通話終了後にレコードを取得してください。
  • analysis.summary が判断理由を説明します。 結果が正しくないと思われる場合は、サマリーを読んでモデルが会話の何を見たかを確認してください。
  • カスタム結果も使用されます。 カスタム結果ラベルを作成している場合、エージェントは通話分類時に組み込みセットに加えてそれらも使用します。

​
結果を確実に読み取る方法

1

通話を停止する

セッションを終了するために停止リクエストを送信します。エージェントがすでに end_call ツールで通話を終了している場合、これは無効な操作となります。
curl -X POST https://api.oneinbox.ai/v1/calls/<call_id>/stop \
  -H "Authorization: Bearer <api_key>"
2

2〜3秒待つ

文字起こしと分析は通話セッション終了後に非同期で書き込まれます。少し待つことでデータが準備完了になります。
3

通話レコードを取得する

結果、サマリー、文字起こし、録音URLを含む完全な通話レコードを取得します。
curl https://api.oneinbox.ai/v1/calls/<call_id> \
  -H "Authorization: Bearer <api_key>"
これで analysis.outcome、analysis.summary、messages[]、duration_seconds、recording_url（録音が有効な場合）が取得できます。

​
カスタム結果ラベル

ワークスペース独自のカスタム結果ラベルを作成できます。エージェントは通話分類時に組み込みラベルと合わせてこれらを使用します。例えば「ホットリード」をカスタム結果として追加すると、AIはその説明に合致する通話に自動的に割り当て始めます。

​
コール結果の一覧取得

プラットフォームレベルの組み込みラベル（常に利用可能）と、ワークスペースで作成したカスタムラベルの両方を返します。 
curl https://api.oneinbox.ai/v1/workspace/call-outcomes \
  -H "Authorization: Bearer <api_key>"

{
  "builtin": ["interested", "not_interested", "appointment_booked", "voicemail", "no_answer"],
  "items": [
    {
      "id": "co_abc123",
      "label": "ホットリード",
      "description": "予算確定済みの見込み顧客",
      "is_active": true
    }
  ],
  "total": 1
}

​
カスタム結果の作成

ワークスペースに新しい結果ラベルを追加します。大文字・小文字は任意です（例："ホットリード" や "demo_scheduled"）。作成後、エージェントは今後の通話分類時に自動的にそれを使用します。 
curl -X POST https://api.oneinbox.ai/v1/workspace/call-outcomes \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "ホットリード",
    "description": "予算と意思決定スケジュールが確定している見込み顧客"
  }'

{
  "id": "co_abc123",
  "label": "ホットリード",
  "description": "予算と意思決定スケジュールが確定している見込み顧客",
  "is_active": true
}
フィールド役割
label結果名。大文字・小文字はそのまま保存・表示されます
description任意。AIにこの結果が適用されるタイミングを説明します。詳しいほど分類精度が上がります

​
カスタム結果の更新

ラベルの名前変更や無効化ができます。無効化（is_active: false）すると、今後の自動分類からは除外されますが、過去の通話レコードには保持されます。データは失われません。 
curl -X PATCH https://api.oneinbox.ai/v1/workspace/call-outcomes/<outcome_id> \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "クオリファイドリード",
    "is_active": true
  }'
フィールド役割
label新しいラベル名 — 今後の通話レコードに表示される名前が更新されます
is_activefalse = 過去データを保持したまま、新しい分類からこの結果を除外します

​
Webhookで自動通知を受け取る

ポーリングの代わりに、通話終了直後に完全な通話レコードを受け取るWebhookを設定します： 
curl -X POST https://api.oneinbox.ai/v1/webhooks \
  -H "Authorization: Bearer <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "通話完了",
    "url": "https://your-server.com/webhooks/oneinbox",
    "events": ["call.ended"]
  }'
→ Webhookガイド

​
APIリファレンス

通話を取得 · 通話を更新 · 通話一覧 · コール結果一覧 · コール結果を作成 · コール結果を更新