担当者のステータス
顧客担当者（内線）のリアルタイムの状態と、所属する列を一覧表示します。ウォールボード、CRMでの「誰が空いているか」の表示、シフトレポートに利用されます。APIキー（スコープ call; Authorization: Bearer bt_… ヘッダーで、参照： APIセキュリティ), GET.
レート制限：1分あたり2リクエスト。秒単位の更新のためにこのエンドポイントをループで呼び出さないでください。リアルタイム監視画面またはCRMブリッジのデータの方が適しています。
GET担当者一覧
GET https://api.buluthat.com/api/agent_statuses.php[
{ "agent": "1010", "status": "AVAILABLE", "queues": ["204", "205"] },
{ "agent": "1011", "status": "TALKING", "queues": ["202"] },
{ "agent": "1026", "status": "ON_BREAK", "queues": ["204"], "break_description": "Kahve" },
{ "agent": "1030", "status": "LOGGED_OUT", "queues": [] }
]| エリア | 説明 |
|---|---|
agent | 内線番号 |
status | AVAILABLE 空き · TALKING 通話中 · ON_BREAK 休憩中 · LOGGED_OUT 未登録 / オフライン |
queues | 所属している列の番号 |
break_description | 休憩中の場合は休憩名 |
フィルター
| パラメータ | 説明 |
|---|---|
agent | 単一の内線（1010) |
status | ステータスフィルター（AVAILABLE, TALKING, ON_BREAK, LOGGED_OUT) |
queue | 特定の列のメンバー（列番号または名前） |
GET https://api.buluthat.com/api/agent_statuses.php?queue=204&status=AVAILABLEメモ
- モバイルアプリを使用している内線は、画面が消えている間は交換機上で未登録に見えることがあります。これらは着信時にプッシュで起動されます。このエンドポイントでは
LOGGED_OUTと表示されても「不通」を意味しません。列の振り分けは、起動可能なメンバーを空きとみなします。 - 内線で「応答不可」（DND）が有効な場合
ON_BREAKの代わりにLOGGED_OUT表示されます。