ElevenLabs 위젯은 방문자가 웹사이트에서 말로 질문하게 합니다. 이 안내는 페이지와 에이전트를 모두 관리하는 사람을 위한 것입니다. 작은 공개 FAQ를 설정해 게시된 페이지에서 검사한 뒤 접근, 대화 기록, 사용량을 살펴봅니다. 2026년 10월 20일 확인한 문서를 따릅니다. BIG CHANGE는 에이전트를 만들거나 위젯을 삽입하거나 테스트 통화를 하지 않았습니다.

핵심 변화

  • 무엇을: ElevenLabs는 공개 ElevenAgents 에이전트용 웹 위젯을 문서화하며 기본 모드는 음성입니다.
  • 어떻게: 페이지는 공개되는 에이전트 ID로 사용자 정의 요소를 불러옵니다. 호스트명 허용 목록이 연결 가능한 사이트 출처를 제어합니다.
  • 중요한 이유: 운영자는 한 페이지에서 음성 도움 경로를 확인할 수 있지만 공개 전 정보, 방문자 고지, 예상 통화 비용을 승인해야 합니다. 호스트명 목록은 개인 방문자를 식별하지 않습니다.

공개 FAQ와 작은 테스트 준비하기

에이전트 하나를 관리하고 페이지 하나를 편집·게시할 권한이 필요합니다. HTTPS 페이지, 마이크가 되는 브라우저, FAQ를 승인하고 답변을 들을 사람을 준비합니다. 게시 도구가 문서의 요소와 스크립트를 허용해야 하며 현재의 사용자 정의 HTML 추가 방식을 사용합니다. 예시는 공급자의 일반 HTML 삽입이지 특정 플랫폼 설치법이 아닙니다.

몇 가지 승인된 공개 사실 과 범위 밖 요청의 사람 연락처를 적습니다. 사실에 답이 있는 질문과 거절하거나 사람에게 넘길 질문을 하나씩 고릅니다. 고객 기록, 비공개 정책, 계정 정보, API 비밀은 제외하세요. 목소리와 방문자 고지 승인자를 정합니다. 음성과 계정 약관이 용도를 허용하는지 확인하며, 모든 음성의 보편적 상업 권한을 이 안내가 보장하지는 않습니다.

음성 테스트 전 실제 요금제, 남은 크레딧, 종량제 설정, 선택 모델 비용을 확인합니다. ElevenLabs는 에이전트 생성은 무료지만 연결된 음성 통화는 사용량을 소모하고 LLM 비용이 별도일 수 있다고 설명합니다. 연결 시간이 말한 시간보다 길 수 있습니다. 대시보드와 게시 페이지 통화 모두 시작 전에 지출 승인을 받으세요. 통화당 시간 제한은 월 지출 한도가 아닙니다.

전용 에이전트 설정하기

  1. 별도의 공개 FAQ 에이전트를 만듭니다 . 승인된 빈 설정이나 템플릿으로 시작해 물려받은 지식과 도구를 검토합니다. 비공개 지식, 예약, CRM, webhook 등 불필요 작업을 제거합니다. 승인 사실로 목적과 답변 경계를 정하고 사람 연락처, 허용된 목소리와 언어를 선택합니다. 기존 비공개 에이전트의 인증을 꺼서 공개 위젯으로 바꾸지 마세요.
  2. 다음에서 설정합니다: Channels → Widget → Interface. 음성 인터페이스를 고르고 방문자 문구와 약관을 검토합니다. 문서는 일부 화면을 Widget 탭이라고도 하므로 저장된 제어를 확인하세요. 이 삽입 방식에는 인증을 끈 공개 에이전트가 필요하며 문서는 설정 위치를 Advanced로 안내합니다. ID는 페이지 소스에 보이므로 비밀이 아닙니다. API 키, 개인 정보, 방문자 전용 정보는 마크업이나 위젯 덮어쓰기 값에 넣지 마세요.
  3. 에이전트의 Security 탭에서 정확한 호스트명을 Allowlist에 추가하고 저장한 뒤 다시 읽습니다. ElevenLabs는 완전 일치, 최대 열 개, 하위 도메인별 별도 등록을 설명합니다. 로컬 시험 호스트는 실제 필요할 때만 추가하세요. 목록은 연결 출처를 제한할 뿐 말하는 사람을 인증하지 않습니다.
  4. 대화 텍스트 보관과 음성 저장을 검토하고 사이트에 적합한 고지·동의 절차를 승인합니다. 통화 전 약관을 보여줄 수 있지만 그 화면과 브라우저 마이크 허가가 법적 의무를 해결하지는 않습니다. 설정 위치는 Advanced → Call limits이며, 적절한 값을 설정하고 저장할 항목은 Max conversation duration입니다. 문서상 기본은 600초, 범위는 60~7,200초입니다. 유료 테스트 전에 개인정보, 시간, 접근 설정을 다시 읽습니다.

초안 페이지 하나에 삽입하기

지원되는 사용자 정의 HTML·스크립트 기능으로 다음을 본문에 넣습니다. 다음 식별자 YOUR_PUBLIC_AGENT_ID 를 전용 에이전트 ID로 바꾸세요. 최초 배치는 승인된 한 페이지로 제한합니다.

HTML
<elevenlabs-convai agent-id="YOUR_PUBLIC_AGENT_ID"></elevenlabs-convai>
<script src="https://unpkg.com/@elevenlabs/convai-widget-embed" async type="text/javascript"></script>

이는 현재의 공식 위젯 삽입 코드입니다. 스크립트 URL은 버전이 고정되어 있지 않습니다. 설치 내용을 기록하고 유지보수 때 문서를 재확인하세요. 초안에서 한 번만 나타나고 필수 제어를 가리지 않는지 봅니다. Content Security Policy가 있다면 담당자가 실제 차단 요청을 살펴 범위를 좁혀 승인된 수정을 합니다. 정책 비활성화나 광범위 와일드카드는 설치 단계가 아닙니다.

에이전트와 실제 방문 경로 확인하기

비용과 개인정보 검토 후 대시보드 음성 시험에서 두 질문을 합니다. 답변을 승인 사실과 사람에게 넘기는 경계에 맞춰 비교하세요. 위험하거나 근거 없으면 수정 후 재시험합니다. 대시보드 통화는 그 경로만 확인하며 웹 삽입을 입증하지 않습니다.

게시 전 소유자가 내용, 고지, 위치, 결과를 검토합니다. 다음 위치인 허용 호스트명의 게시된 페이지에서 위젯을 열고 의도적으로 마이크를 허용해 두 질문을 듣고 통화를 끝냅니다. 마이크 표시가 꺼지고 휴대전화 크기에서도 사용 가능한지 확인하세요. 유창함은 사실의 증거가 아니므로 승인 답변과 비교합니다. 사용량 추적용 시간과 에이전트를 적습니다. 이는 독자용 검사이며 BIG CHANGE 관찰 결과가 아닙니다.

다음을 엽니다: Call history . 보관 설정이 기록을 남긴 경우 두 질문과 대화를 대조합니다. 이어 Analytics에서 해당 에이전트와 짧은 시간을 골라 횟수, 시간, 비용을 봅니다. 합계만으로 어느 통화가 요금을 발생시켰는지 입증할 수 없습니다. 승인 정책이 대화를 삭제한다면 허용된 최소 답변 관찰만 남기고 가능한 합계를 봅니다. 검사를 위해 보관을 늘리지 마세요. 기록이 없다고 무료인 것은 아닙니다.

검사에 실패한 경우

위젯이 없으면 실제 게시 마크업을 문서의 삽입 코드와 비교하고 중복 요소·스크립트 및 구체적인 브라우저·CSP 오류를 찾습니다. 보이지만 연결이 안 되면 공개 인증, 정확한 호스트명, 마이크 허가, 크레딧, 대시보드 오류를 다시 확인합니다. 음성 실패는 마이크 선택, 권한, 안전한 페이지 환경과 기록을 봅니다. 불확실한 세션을 끝내고 사용량을 확인한 뒤 유료 재시도합니다.

답을 지어내거나 FAQ를 벗어나면 사실과 지시를 고치는 동안 삽입을 제거합니다. 복구 전 대시보드와 사이트에서 두 질문을 반복하세요. 승인보다 사용량이 크면 제거하고 통계와 청구를 검토해 시간과 배치를 재고합니다. 제거는 이 페이지의 새 통화를 막을 뿐 진행 중 통화 종료나 다른 허용 호스트 접근 철회를 입증하지 않습니다.

로컬로 개발한 브라우저 음성 앱은 OpenAI Realtime 안내 에서 다른 작업으로 다룹니다. 여기서는 ElevenLabs의 호스팅 공개 위젯을 사용합니다. 문서는 다른 곳에 다음 속성 signed-url 을 나열하지만 기본 삽입은 공개 에이전트를 명시적으로 요구합니다. 그 속성만으로 검증된 비공개 위젯 절차가 되지 않습니다.

출처 및 추가 자료