Skip to main content
ベース URL：https://xxxx.comdesk.com/api/v1
POST /calls/initiate（クリックして発信）は現在のリリースでは提供されていません。フェーズ 2 で提供予定です。

通話オブジェクト

integer
通話履歴 ID。同じ値を GET /calls/{callId} に指定でき、Webhook では call_id として含まれます。
string
outbound、inbound、outbound_no_answer、inbound_no_answer、internal、voicemail、transfer、sms_inbound、sms_outbound、ivr_outbound のいずれか。voicemail は、自社の留守番電話で録音された着信と、相手先の留守番電話につながった発信の両方を含みます。
string
テナントで設定されている通話結果名。例：connected。
string
相手先の番号。一覧レスポンスではマスクされます。
string
発信者番号（通知番号）。一覧レスポンスではマスクされます。
integer
string
integer
string
integer
通話が顧客に紐づいていない場合は null。
string
通話が顧客に紐づいていない場合は null。
string
オフセット付き ISO 8601。例：2026-03-10T10:00:00+09:00。
string
ISO 8601、または null。
integer
string
通話に対するスタッフのメモ。
string
再架電の予定日時（ISO 8601）、または null。
string
音声認識結果（AI 有効時）。それ以外は null。
string
AI 生成の要約（利用可能時）。それ以外は null。
object
null、または talk_ratio（オペレーターのトークレシオ、0〜1）、speech_speed（文字／秒）、filler_count、silence_ratio、overlap_count、question_count、rally_count（発話の切り替え回数）を持つオブジェクト。
string
録音リンク（録音有効時）。それ以外は null。
string
設定済みの相関 ID。未設定の場合は null。
GET /calls のレスポンスでは、phone_number と caller_number がマスクされます — 末尾 4 桁が **** に置き換えられます（例：0901234****）。GET /calls/{callId} ではマスクされずに返ります。

通話一覧

GET /calls 指定した期間の通話履歴をページネーション付きで返します。デフォルトでは新しい順です。

クエリパラメータ

string
required
開始日、YYYY-MM-DD（例：2026-03-01）。最大 180 日前まで指定できます。
string
required
終了日、YYYY-MM-DD。from 以降の日付。from→to の範囲は 31 日を超えられません。いずれかのルールに違反すると 422 を返します。
integer
プロジェクトで絞り込み。
integer
スタッフで絞り込み。
string
outbound または inbound。
string
カンマ区切りの通話結果名。例：connected,no_answer。
string
相手先の番号の部分一致、最大 20 文字。
integer
default:"1"
ページ番号。
integer
default:"50"
1 ページあたりの件数、最大 200。
string
default:"started_at"
started_at または duration。
string
default:"desc"
asc または desc。

通話の取得

GET /calls/{callId} マスクされていない完全な通話オブジェクト（上記「通話オブジェクト」を参照）を返します。利用可能な場合は AI 由来のフィールドも含みます。通話が自テナント内に存在しない場合は 404 resource_not_found を返します。
integer
required
通話 ID（数値）。