https://app.comdesk.com/api/v1
発信する
POST /calls/initiate
指定したスタッフから顧客の番号へ発信します(クリックして発信)。
ボディ
string
required
発信先番号。7〜20 文字(数字、ハイフン、
+)。形式が不正な場合は 422 を返します。integer
required
発信するスタッフの ID。自テナント内に存在する必要があります。
integer
required
通話が属するプロジェクトの ID。自テナント内に存在する必要があります。
string
自社システムのレコード ID(最大 255 文字)。相関のため Webhook で返されます。テナント内で一意である必要があり、重複時は
409 を返します。object
任意の自由形式オブジェクト。例:
{ "crm_url": "https://..." }。レスポンス
通話一覧
GET /calls
指定した期間の通話履歴をページネーション付きで返します。
クエリパラメータ
string
required
開始日(ISO 8601、例:
2026-03-01)。string
required
終了日。
from→to の範囲は 31 日を超えられず、from は最大 180 日前までです。いずれかを超えると 422 を返します。通話の取得
GET /calls/{callId}
1 件の通話の詳細を返します。利用可能な場合は AI 由来のフィールドも含みます。
一覧/ログのレスポンスでは、PII ポリシーにより
phone_number はマスクされます(先頭 3 桁 + 末尾 4 桁、例:090****5678)。