우리 회사가 이미 만든 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/에이전트 → 에이전트 관리 → 에이전트 생성
1.
에이전트 유형 — 커스텀 에이전트 선택
2.
에이전트 명 — 알아볼 수 있는 이름 입력 (예: 나만의 에이전트)
3.
저장하기
에이전트 유형은 생성 후 변경할 수 없습니다.
저장하고 나면 유형 선택란이 잠깁니다. 잘못 골랐다면 새로 만들어야 합니다.
저장하기 전에는 배포하기 버튼이 눌리지 않습니다.
반드시 저장 → 배포 순서로 진행하세요.④ 배포하기
저장이 끝나면 우측 상단 배포하기 가 활성화됩니다. 눌러서 배포합니다.
배포하면 ARS/에이전트 목록의 배포된 에이전트에 나타납니다.
⑤ 자동응대에 적용
배포만으로는 아직 전화가 넘어오지 않습니다. 어떤 응대 타입에 쓸지 지정해야 합니다.
ARS/에이전트 → AI 에이전트
1.
배포된 에이전트 목록에서 방금 만든 에이전트를 찾습니다
2.
우측 사용 버튼 클릭
3.
확인 창(이 에이전트를 사용하시겠습니까?)에서 사용 클릭
적용되면 해당 에이전트에 ● 사용중 배지가 붙습니다.
변경은 즉시 반영됩니다. 이후 걸려오는 전화부터 새 에이전트가 응대합니다.⑥ 연결 확인
방법 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 인지 |
유형을 잘못 선택함 | ③ | 유형은 변경 불가. 새로 생성해야 함 |







