General_API
  1. 汎用APIドキュメント
General_API
  • コムデザインAPIドキュメント
    • 汎用API
      • サービス
      • 汎用API共通仕様
      • 汎用APIを利用開始までの流れ
      • 汎用APIドキュメント
        • 通話ステータス通知API
          POST
        • 通話履歴取得API
          POST
        • 待呼取得API
          POST
        • 音声認識結果一括取得API
          POST
        • 音声認識結果取得API
          POST
        • 音声認識結果一括送信API
          POST
        • 音声データ取得API
          POST
        • 使用回線数取得API
          POST
    • AutoCall
      • AutoCallAPIドキュメント
      • AutoCall要求API(順次発信方式)
      • AutoCall要求API(即時発信方式)
      • AutoCall結果取得API
      • AutoCall発信完了通知API
      • AutoCallキャンセルAPI
      • AutoCall架電止めAPI
    • WebSocket(リアルタイム連携)
      • 音声データ連携
        • 音声データ連携ドキュメント
        • WebSocket切断方法
        • WebSocket 音声用API
        • WebSocket 制御用API
      • 音声認識結果連携
        • 音声認識結果連携ドキュメント
        • 音声認識メッセージ
        • 音声認識メッセージ形式
    • 変更履歴
  1. 汎用APIドキュメント

通話履歴取得API

開発中
POST
/general/{apiVersion}/{sourceUuid}/call/history

機能#

リクエストされた日時に開始した通話履歴(セッションID)のリストを返却します
日付のみ指定された場合、指定日の0:00:00~23:59:59に開始した通話リストを返却します
日付及び時間が指定された場合、指定日の指定時間の00:00~59:59に開始した通話リストを返却します
なお、リクエストした期間内で開始した通話であっても、終了していない通話は通話リストに含まれません
日付変更直後・時間変更直後に本APIをリクエストした場合、終了していない通話がレスポンスに含まれません。 日付変更、時間変更から、ある程度の間隔を開けて本APIをリクエストして下さい
一定期間に多数のリクエストを実施された場合、エラーを返却する可能性があります(概ねリクエスト間隔は、10分以上としてください)

エラー#

存在しないリクエストパラメータ
リクエストパラメータ不足
許可されていないテナントの情報要求
31日以上前の日付を指定
未来日を指定
存在しない日付を指定
時刻指定エラー: 0~23以外の数字を指定
現在及び未来時刻を指定(例:現在時刻が10:15の場合、10時は指定不可とする)

Requestパラメータ

Pathパラメータ

Headerパラメータ

Request Bodyパラメータapplication/json

例
{
  "tenantId": "05053698341",
  "date": "20240915",
  "hour": "10"
}

リクエストコードサンプル

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/general/v1/d70c9bba-b71f-4021-b68c-0dccb2d99999/call/history' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "tenantId": "05053698341",
  "date": "20240915",
  "hour": "10"
}'

Response

🟢200成功
application/json
Body

例
{
	"conversationList": {
		"status": "complete",
		"tenantId": "05053698333",
		"sessionList": [
			{
				"sessionId": 942125,
				"connectTime": "2024-06-21T08:27:34.084Z",
				"disconnectTime": "2024-06-21T08:28:36.930Z",
				"recordList": [
					{
						"recordId": 1,
						"recognitionResultsFlag": "1"
											}
				]
			},
			{
				"sessionId": 942126,
				"connectTime": "2024-06-21T08:28:34.084Z",
				"disconnectTime": "2024-06-21T08:30:36.930Z",
				"recordList": [
					{
						"recordId": 1
						"recognitionResultsFlag": "1"
					},
					{
						"recordId": 2
						"recognitionResultsFlag": "0"
					}
				]
			}
		]
	}
}
🟢200失敗
更新日時 2025-08-05 11:38:16
前へ
通話ステータス通知API
次へ
待呼取得API
Built with