Skip to main content
ベース URL: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
終了日。fromto の範囲は 31 日を超えられず、from は最大 180 日前までです。いずれかを超えると 422 を返します。

通話の取得

GET /calls/{callId} 1 件の通話の詳細を返します。利用可能な場合は AI 由来のフィールドも含みます。
一覧/ログのレスポンスでは、PII ポリシーにより phone_number はマスクされます(先頭 3 桁 + 末尾 4 桁、例:090****5678)。