이 API 엔드포인트는 대기열당 계산된 예상 대기 시간 (EWT)을 반환합니다.
이 API 엔드포인트는 Contact Center AI Platform (CCAI Platform) SDK 외부의 웹페이지 또는 모바일 앱에서 맞춤 지원 채널 EWT를 표시하거나 맞춤 알림 또는 트리거에 사용할 수 있습니다.
요청 예시
URL: http://{subdomain}.{domain}/apps/api/v1/wait_times
매개변수
| ID | 필드 이름 | 유형 | 필수 | 설명 | 값 | 참고 |
|---|---|---|---|---|---|---|
| 1 | menu_id | id | 아니요 | 응답은 해당 메뉴를 포함하여 해당 메뉴의 하위 메뉴에 있는 모든 메뉴 (대기열)를 필터링합니다. | 루트 메뉴 (기본값) 특정 메뉴 | 전달된 항목이 없으면 전체 대기열 구조를 반환합니다. |
| 2 | channel_type | enum | 아니요 | 특정 채널의 메뉴를 반환합니다. | voice_call chat | 선택적 매개변수 |
| 3 | menu_type | enum | 아니요 | 특정 유형의 메뉴를 반환합니다. | ivr_menu mobile_menu web_menu 전체 (기본값) |
선택사항 |
| 4 | wait[from] | int | 아니요 | 대기 시간이 값보다 큰 레코드를 반환합니다. | 유효성 검사:양의 정수만 | |
| 5 | wait[to] | int | 아니요 | 대기 시간이 값보다 작은 레코드를 반환합니다. | 유효성 검사:양의 정수만 | |
| 6 | lang | enum | 예 | ewt를 가져올 대기열 구조 | 예: 'en' 'es' 'fr' 'de' 'it' 'ja' 'ko' 'pt' 'pt-BR' 'sv' |
응답
| ID | 필드 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|---|
| 1 | menu_id | id | 예 | /menus 관리자 API 엔드포인트의 외래 키 |
| 2 | wait | INT | 예 | 대기 시간(분) |
| 3 | 구체화된 경로 | 문자열 | 예 | /menus API에서 찾은 구체화된 경로 |
예
http://{subdomain}.{domain}/apps/api/v1/wait_times?lang=en&menu_id=10
[
{
"menu_id": 10,
"menu_type": "ivr_menu",
"voice_call": 120,
"materialized_path": "Subscription",
"logged_in_agents": 3,
"available_agents": 0,
"breakthrough_agents": 1
}
]
상태 코드: 200
메뉴 ID 10의 예상 대기 시간은 120초 (또는 2분)입니다.