콜브릿지는 외부 AI Agent 시스템과 WebSocket 기반으로 연동할 수 있습니다.
커스텀 에이전트를 연결하면 콜브릿지 통화 시스템과 Agent 간에 실시간 데이터 통신이 가능합니다.
5-1. 커스텀 에이전트 연동 설정
콜브릿지 설정 > 서비스 연동 관리 화면에서 커스텀 에이전트 연동 메뉴를 통해 아래 정보를 입력합니다.
항목 | 설명 |
Agent 도메인 | WebSocket 통신이 가능한 Agent 서버 주소 |
API Key | Agent 연동 인증을 위한 API Key |
Type | 에이전트 유형 (예: 음성 Voice) |
5-2. Agent 도메인 입력
Agent 도메인에는 외부 Agent 시스템에서 제공하는
WebSocket 접속 주소를 입력합니다.
예시
wss://agent.example.com
Plain Text
복사
설명
•
WebSocket 기반 통신 주소
•
Agent 시스템에서 제공해야 함
•
콜브릿지 통화 시스템이 해당 주소로 연결 요청을 수행
5-3. API Key 입력
API Key는 콜브릿지와 Agent 시스템 간 인증을 위한 키입니다.
•
Agent 서버에서 발급된 API Key 입력
•
인증 실패 시 Agent 연결이 정상 동작하지 않을 수 있음
5-4. 커스텀 Agent 연결 동작 방식
위 정보를 입력하여 연동을 완료하면 다음과 같은 방식으로 동작합니다.
1.
고객이 콜브릿지로 전화 연결
2.
콜브릿지 통화 시스템이 Agent WebSocket 서버로 연결 요청
3.
WebSocket 연결이 수립되면
4.
Public API 가이드 문서에 정의된 데이터 구조로 이벤트 및 데이터를 송수신
예시 데이터
•
통화 시작 이벤트
•
고객 정보
•
음성 데이터
•
상담 상태 정보
5-5. Agent에서 콜브릿지 기능 호출하기
Agent 시스템에서 아래 기능을 사용하려면
콜브릿지 Open API를 이용해야 합니다.
•
콜브릿지 통화시스템 →agent 통신 (연결)
•
agent →콜브릿지 통화시스템 (Barge-in 기능)
•
agent → 콜브릿지 통화시스템 (STT 결과 전송)
•
agent → 콜브릿지 통화시스템 (Tool 호출 로그 전송)
5-6. Open API Key 발급 방법
콜브릿지 관리자 페이지에서 API Key를 발급할 수 있습니다.
경로
콜브릿지 설정→ 개발자 설정→ OPEN API 관리→ API Key 발급
Plain Text
복사
발급된 API Key를 사용하여 콜브릿지 Open API를 호출할 수 있습니다.
5-7. Open API 문서
API 요청 방식 및 파라미터는
콜브릿지 Open API 가이드 문서를 참고합니다.
