CallBridge Agent 음성 세션 연결 (WebSocket)

CallBridge 통화 시스템과 Agent 서버 간 **실시간 음성 세션(WebSocket)**을 연결하는 인터페이스입니다.
이 연결을 통해 음성 스트림과 통화 제어 이벤트가 전달됩니다.

1. 개요

CallBridge 통화 시스템은 Agent 서버와 WebSocket 연결을 수립하여 음성 세션을 생성합니다.

연결이 수립되면 다음 정보가 전달됩니다.
•
통화 정보 (caller / callee / cdrId)
•
PBX 채널 정보
•
Agent 정보
•
오디오 포맷 정보
음성 데이터 및 tool 호출은 OPEN API 서버를 통해 별도로 처리됩니다.

2. 사전 조건 / 권한

•
콜브릿지(CallBridge) 계정 생성
•
상담콜 시스템에서 Agent WebSocket 주소 등록

3. 연결 정보

Protocol

wss {wss 또는 ws}://{상담콜내 연동정보 입력한 주소}

4. Connection Request

WebSocket 연결이 수립되면 CallBridge 시스템이 초기 세션 정보를 전송합니다.

Message Format

{ "call_config": { "siteId": string, "caller": string, "callee": string, "cdrId": string, "callActionId": string, "ivrIp": string, "agentId": string, "agentType": string }, "audio_format": { "phone_output_audio_format": string, "phone_input_audio_format": string } }
JavaScript
복사

Request Body

이름
타입
필수
기본값
설명
call_config
Object
O
-
콜브릿지 통화시스템 설정 정보
audio_format
Object
O
-
오디오 포맷 정보

call_config

이름
타입
필수
기본값
설명
siteId
String
O
-
사이트 ID
cdrId
String
O
-
통화 CDR ID
caller
String
O
-
발신자 전화번호
callee
String
O
-
수신자 전화번호
ivrIp
String
O
-
콜브릿지 통화시스템 서버 주소 IP:Port
callActionId
String
O
-
콜브릿지 통화시스템 액션 ID (전화 연결시 채널아이디)
agentId
String
O
-
Agent ID
agentType
String
O
-
Agent 타입

audio_format

이름
타입
필수
기본값
설명
phone_output_audio_format
String
O
PCM_8000
전화 출력 오디오 포맷
phone_input_audio_format
String
O
PCM_8000
전화 입력 오디오 포맷

5. Response

Response Body Example

{ "type": "started", "call_config": { "siteId": string, "caller": string, "callee": string, "cdrId": string, "callActionId": string, "ivrIp": string, "agentId": string, "agentType": string }, "audio_format": { "phone_output_audio_format": string, "phone_input_audio_format": string } }
JavaScript
복사

Resonse Field

이름
타입
필수
기본값
설명
type
String
O
-
이벤트 타입 (예: "started")
call_config
Object
O
-
콜브릿지 통화시스템 설정 정보
audio_format
Object
O
-
오디오 포맷 정보

call_config

이름
타입
필수
기본값
설명
siteId
String
O
-
사이트 ID
cdrId
String
O
-
통화 CDR ID
caller
String
O
-
발신자 전화번호
callee
String
O
-
수신자 전화번호
callActionId
String
O
-
콜브릿지 통화시스템 액션 ID (전화 연결시 채널아이디)
ivrIp
String
O
-
콜브릿지 통화시스템 서버 주소 IP:Port
agentId
String
O
-
Agent ID
agentType
String
O
-
Agent 타입

audio_format

이름
타입
필수
기본값
설명
phone_output_audio_format
String
O
PCM_8000
전화 출력 오디오 포맷
phone_input_audio_format
String
O
PCM_8000
전화 입력 오디오 포맷