moon
sun

커스텀 에이전트 연동하기

우리 회사가 이미 만든 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 인지
유형을 잘못 선택함
③
유형은 변경 불가. 새로 생성해야 함
📌
API 요청 방식 및 파라미터는 콜브릿지 Open API 가이드 문서를 참고합니다.

콜브릿지의 다양한 기능과 사용 방법을 확인해 보세요!