General_API
  1. APIドキュメント
General_API
  • APIドキュメント
    • API共通仕様
    • 一般API
      • エージェントリスト取得API
      • エージェント情報取得API
      • エージェントステータス変更API
      • スキルリスト取得API
      • 所属エージェントリスト取得API
      • 理由リスト取得API
      • 待呼取得API
      • 使用回線数取得API
    • 音声系API
      • 通話ステータス通知API
      • 音声認識結果一括取得API
      • 音声認識結果取得API
      • 音声認識結果一括送信API
      • 音声データ取得API
      • 通話履歴取得API
    • AutoCall
      • AutoCall要求API(順次発信方式)
      • AutoCall要求API(即時発信方式)
      • AutoCall結果取得API
      • AutoCall発信完了通知API
      • AutoCallキャンセルAPI
      • AutoCall架電止めAPI
      • AutoCallリクエスト履歴取得API
    • WebSocket(リアルタイム連携)
      • 音声データ連携
        • 音声データ連携ドキュメント
        • WebSocket切断方法
        • WebSocket 音声用API
        • WebSocket 制御用API
      • 音声認識結果連携
        • 音声認識結果連携ドキュメント
        • 音声認識メッセージ
        • 音声認識メッセージ形式
    • 変更履歴
  1. APIドキュメント

一般API

概要#

エージェントのステータス、エージェントの属性情報、待呼状況、使用回線数等、CTIの一般的な情報を取り扱うAPIです

エージェントステータス(AgentStatus)#

CT-e1のエージェントステータスは、「受付可」「後処理」「離席」「通話中」「ログアウト」の4種類に大別されます
「通話中」は、「架電中」「通話中」「保留中」に詳細化されてステータス管理されます
0:受付可
1:後処理
2:離席
3:通話中
20:架電中
10:通話中
30:保留中
4:ログアウト
「受付可」「後処理」「離席」は、サブステータス(理由ID)を持つことができますが、現状、連携対象外となっています
エージェントリスト取得APIは、ログインしているエージェントの情報のみ取得できます。このため、「ログアウト」しているエージェントの情報は連携されません
エージェントステータス変更APIは、エージェントステータスを変更することができます。ただし、「通話中」の場合、エージェントステータスを変更することはできません

待ち呼状態の判定方法#

待呼取得APIでは、現在通話開始待ちになっている着信スキルごとの待呼数が取得できます。
実際の待ち時間は。問い合わせ内容や通話可能なエージェントの数により変動します。
待呼の状態は、以下のマトリックスにより判定して下さい
待呼
queuing
ログイン済み
login
受付可
acceptable
状態
00-即座に通話開始できない状態
対応可能なエージェントがログインしていない
01以上0即座に通話開始できない状態
待ち呼状態ではないが、全エージェントが作業中
01以上1以上即座に通話開始できない状態
対応可能なエージェントがログインしていない
1以上0-対応可能なエージェントが存在しない状態
1以上1以上0即座に通話開始できない状態
エージェントが順次対応中
1以上1以上1以上即座に通話開始できない状態
エージェントが順次対応中
更新日時 2026-02-03 02:38:21
前へ
API共通仕様
次へ
エージェントリスト取得API
Built with