Skip to main content
실행 대기음은 에이전트가 도구를 실행하거나 정보를 추출하는 동안 통화에 재생하는 소리예요. 고객은 무음 대신 타이핑 소리나 대기 음악을 들으며 기다려요. 도구 편집 화면의 실행 중 안내에 있는 실행 전 말하기 메시지, 실행 대기음 선택 상자, 미리듣기 버튼

언제 사용하나요

  • 짧게 찾아보는 도구를 부를 때: 주문 조회나 주소 검색에는 타이핑이 어울려요.
  • 몇 초 이상 걸리는 작업을 할 때: 예약 처리나 외부 시스템 연동에는 대기 음악 1~4 가운데 하나를 고르세요.
  • 플로우의 단계를 소리로 나눌 때: 첫 조회 노드는 타이핑, 처리가 긴 노드는 대기 음악으로 두면 단계가 소리로도 구분돼요.
기본값은 소리 없음이에요. 1초 안에 끝나는 작업이나 실행 전 말하기로 충분한 작업은 그대로 두세요. 모든 도구에 켤 필요는 없으니, 테스트 통화에서 무음이 길게 느껴지는 도구부터 설정하세요.

대기음 설정하기

대기음은 도구, 노드, 메뉴얼마다 따로 정해요. 에이전트 전체에 한 번에 적용하는 설정은 없어요. 선택 상자 옆 재생 버튼으로 미리 들어 보고 고르세요. 타이핑은 실제 통화에서 비슷한 소리 네 가지 중 하나를 재생해서 미리듣기와 조금 다를 수 있어요. 플로우 편집기 노드 설정 패널의 실행 중 대기음에서 타이핑을 고른 모습

통화에서 일어나는 일

대기음은 도구 실행과 함께 시작하고, 에이전트가 결과를 바탕으로 답하기 시작하면 멈춰요. 재생 시점은 따로 설정하지 않고 통화 상황에 따라 정해져요.
  • 실행 전 말하기가 먼저 나가요. 안내가 끝난 뒤 남은 대기 구간을 대기음이 채워요.
  • 에이전트가 말하는 동안에는 멈춰요. 말이 끝난 뒤에도 결과가 없으면 처음부터가 아니라 멈춘 곳부터 다시 재생해요.
  • 고객이 말을 시작하면 바로 멈춰요. 그 도구 실행이 끝날 때까지 다시 재생하지 않아요.
  • 여러 도구가 함께 실행되면 대기음은 하나만 들려요. 먼저 시작한 도구의 대기음을 재생해요.
  • 대기음이 없는 빌트인 도구가 실행되면 멈춰요. 통화 전환, 에이전트 전환, DTMF 전송, 통화 종료 도구가 여기에 해당해요.
대기음은 통화 녹음에도 남아요. 통화 기록에서 실제로 어떻게 들렸는지 확인하세요.
실행 대기음은 음성 통화에서만 재생해요. 채팅에서는 나오지 않아요.

API로 설정하기

v3 API에서는 아래 필드에 none, typing, elevator_1~elevator_4 중 하나를 보내요. 소리를 끄려면 none을 보내세요.
tool 노드에서 필드를 비워 두면 연결한 도구에 설정한 대기음을 따라요. vox CLI로 관리하는 도구, 플로우, 메뉴얼 파일에도 같은 값을 써요.

문제가 생겼을 때

음성 테스트 통화로 다시 확인하세요. 채팅에서는 대기음이 나오지 않고, 도구가 바로 끝나거나 실행 전 말하기가 실행 시간을 모두 차지해도 대기음이 나오지 않아요.
구축 > 도구에서 노드에 연결한 도구의 실행 대기음을 확인하세요. 노드에서 대기음을 직접 고르지 않으면 도구에 설정한 대기음을 재생해요.
바로 답해야 하는 도구는 타이핑이나 소리 없음으로 바꾸세요. 대기 음악은 중간에 끊기지 않도록 최소 1.5초를 재생한 뒤 답변을 내보내서, 그만큼 답변이 늦게 시작될 수 있어요.
실행 전 말하기로 걸리는 시간을 먼저 안내하세요. 대기음은 들리기 시작한 뒤 최대 20초까지 재생해요.

관련 문서

  • 도구 개요: 에이전트가 쓰는 도구의 종류와 공통 실행 설정
  • API 도구: 외부 API를 호출하는 도구 만들기
  • 도구 노드: 플로우에서 도구 실행하기
  • 메뉴얼 작성: 메뉴얼을 불러온 직후 재생할 소리 고르기