커스텀에이전트-연동가이드

우리 회사가 이미 만든 AI 에이전트에 콜브릿지 전화 회선을 연결합니다. 에이전트는 그대로 두고, 전화망만 붙이는 방식입니다.

전체 흐름

연동은 연동 정보 등록과 에이전트 배포, 두 부분으로 나뉩니다. 연동 정보만 등록하고 끝내면 전화가 에이전트로 넘어오지 않습니다.

[내 서버]    ①  에이전트 서버 실행           → wss 주소 · API Key 확보
                        ↓
[콜브릿지]   ②  서비스 연동 관리에 등록       → "이 주소로 접속해"
                        ↓
             ③  에이전트 생성 (커스텀 유형)
                        ↓
             ④  배포하기
                        ↓
             ⑤  자동응대에 적용 (사용하기)
                        ↓
[전화]       ⑥  대표번호로 걸어서 확인
Plain Text
복사

 ②까지만 하면 동작하지 않습니다.
②는 “접속할 주소를 알려주는” 단계일 뿐입니다. 실제로 전화를 태우려면 ③~⑤가 필요합니다.

① 에이전트 서버 준비

먼저 우리 에이전트가 인터넷에서 접근 가능한 주소로 떠 있어야 합니다. 콜브릿지가 이 주소로 접속해 오기 때문입니다.

준비물	설명
WebSocket 주소	wss:// 로 시작하는 공개 주소
API Key	우리 에이전트 서버가 발급한 인증 키

 API Key는 콜브릿지가 발급하는 게 아닙니다.우리 에이전트 서버가 정한 키를 콜브릿지에 알려주는 것입니다.
(콜브릿지가 발급하는 Open API Key는 용도가 반대입니다. → 개발자 문서 참고)

② 연동 정보 등록

설정 → 서비스 연동 관리 → 커스텀 에이전트 연동

항목	입력값
Agent 도메인	wss://agent.example.com
API Key	에이전트 서버에 설정한 값과 동일하게
Type	음성 (Voice)

 가장 흔한 실수 — https:// 를 그대로 붙여넣기
반드시 wss:// 로 바꿔서 입력하세요.

③ 에이전트 생성

ARS/에이전트 → 에이전트 관리 → 에이전트 생성

에이전트 유형 — 커스텀 에이전트 선택

에이전트 명 — 알아볼 수 있는 이름 입력 (예: 나만의 에이전트)

저장하기

 에이전트 유형은 생성 후 변경할 수 없습니다.
저장하고 나면 유형 선택란이 잠깁니다. 잘못 골랐다면 새로 만들어야 합니다.

 저장하기 전에는 배포하기 버튼이 눌리지 않습니다.
반드시 저장 → 배포 순서로 진행하세요.

④ 배포하기

저장이 끝나면 우측 상단 배포하기 가 활성화됩니다. 눌러서 배포합니다.

배포하면 ARS/에이전트 목록의 배포된 에이전트에 나타납니다.

⑤ 자동응대에 적용

배포만으로는 아직 전화가 넘어오지 않습니다. 어떤 응대 타입에 쓸지 지정해야 합니다.

ARS/에이전트 → AI 에이전트

배포된 에이전트 목록에서 방금 만든 에이전트를 찾습니다

우측 사용 버튼 클릭

확인 창(이 에이전트를 사용하시겠습니까?)에서 사용 클릭

적용되면 해당 에이전트에 ● 사용중 배지가 붙습니다.

 변경은 즉시 반영됩니다. 이후 걸려오는 전화부터 새 에이전트가 응대합니다.

⑥ 연결 확인

방법 1 — 실제 전화 (권장)

좌측 상단에 표시된 대표번호로 전화를 겁니다.

정상 연결됐다면

•

내 에이전트 서버 로그에 통화 정보가 찍힙니다

[call] 연결 · cdrId=cdr_2026... 01012345678 → 16684016
[stt:agent] 안녕하세요, 무엇을 도와드릴까요?
Plain Text
복사

•

전화기에서 에이전트의 응답 음성이 들립니다

방법 2 — AI Play Ground

에이전트 설정 화면 우측의 전화 테스트 로도 확인할 수 있습니다.

 Play Ground는 AI 응답만 확인합니다. 실제 상담사 연결은 이루어지지 않습니다.
커스텀 에이전트(음성)는 전화 테스트만 제공되며, 채팅 테스트는 없습니다.

연결이 안 될 때

증상별로 어느 단계에서 끊겼는지 를 먼저 찾습니다.

증상	끊긴 지점	확인할 것
배포된 에이전트 목록에 안 보임	④	저장 후 배포하기를 눌렀는지
전화하면 기존 ARS가 응답함	⑤	사용 을 눌러 자동응대에 적용했는지 (● 사용중 배지 확인)
내 서버 로그에 아무것도 안 찍힘	②	주소 오타. wss:// 인지, 외부에서 접근 가능한 주소인지
접속은 오는데 바로 끊김	②	API Key 불일치. 양쪽 값이 글자 하나까지 같은지
연결은 되는데 소리가 안 남	①	오디오 포맷. PCM / 8000Hz / 16bit / Mono 인지
유형을 잘못 선택함	③	유형은 변경 불가. 새로 생성해야 함