웹·모바일 앱을 위한 음성 에이전트 API
앱에 음성 에이전트를 넣으려면 보통 필요도 없는 전화번호를 사거나, API 키가 기기에 남지 않도록 관리하면서 음성 인식, 모델, 음성을 직접 조합해야 합니다. 전화 회선이 아니라 자사 앱 안에 음성 에이전트를 두고 싶은 제품 팀을 위한 것입니다. 전화를 받는 것과 같은 에이전트, 엔진, 지식 베이스, 예약 기능을 브라우저 탭이나 모바일 앱에서 wss://api.voice.wixzel.com/v1/realtime으로 사용할 수 있습니다. 연결할 것도, 구매할 번호도 없습니다. 서버가 일회용 세션을 발급하므로 API 키는 클라이언트에 전달되지 않고, 세션은 같은 엔진의 통화와 똑같이 선불 잔액을 초 단위로 사용합니다.
최종 업데이트:
Wixzel Voice로 웹·모바일 앱용 음성 에이전트를 어떻게 만드나요?
- 01POST /v1/agents
에이전트를 만듭니다. 프롬프트, 첫 인사, 지식 베이스, 음성 엔진을 지정합니다. 전화 통화가 연결되는 에이전트와 같은 에이전트입니다.
- 02POST /v1/realtime/sessions
서버에서 API 키로 호출합니다. 에이전트를 지정하고, 필요하면 허용할 브라우저 origin과 자체 메타데이터도 지정하면, 그 에이전트에 대해 1분 동안 한 번만 쓸 수 있는 client_secret을 돌려받습니다.
- 03wss://api.voice.wixzel.com/v1/realtime
클라이언트가 이 secret으로 소켓을 열고 오디오를 스트리밍합니다. 브라우저에서는 wixzel-voice/realtime의 RealtimeSession이 마이크, 재생, 끼어들기를 처리합니다. Flutter에서는 wixzel_voice 패키지의 RealtimeConnection이 프로토콜을 처리하고, 마이크와 스피커는 앱이 제공합니다.
- 04GET /v1/calls/{id}
모든 세션은 channel이 web인 통화 기록이 됩니다. 대화 기록, 길이, 비용, 지정한 메타데이터가 담기며, 세션이 끝나면 같은 callCompleted 웹훅이 전송됩니다.
- 05wixzel-voice/mascot, wixzel_voice_flutter
선택 사항입니다. 에이전트가 말하는 동안 에이전트의 마스코트, 즉 움직이는 얼굴을 보여 줄 수 있습니다. 웹 페이지에서는 wixzel-voice/mascot의 mountMascot이 마스코트를 그리고, face.connect(session)이 입 모양을 맞춘 채 통화를 실행합니다. Flutter에서는 wixzel_voice_flutter 패키지의 AgentMascotView가 마스코트를 그리고, MascotRealtimeLink가 RealtimeConnection과 동작을 맞춥니다.
웹·모바일 앱 속 음성 에이전트에는 어떤 음성 엔진이 맞나요?
Wixzel Voice의 gemini-live 엔진을 쓰세요. 연결된 1분당 $0.0491입니다. 하나의 실시간 모델이 듣기, 생각하기, 말하기를 모두 처리하므로 왕복 지연은 Gemini 자체의 성능 그대로이며, 분당 가장 저렴한 엔진입니다. 인도 언어용 sarvam 파이프라인도 소켓으로 실행되고, 특정 ElevenLabs 음성이 필요할 때 쓰는 classic도 마찬가지입니다.
Wixzel Voice에서 웹·모바일 앱 속 음성 에이전트의 비용은 얼마인가요?
gemini-live 엔진에서 4분 세션에 드는 Wixzel Voice 엔진 시간 비용으로, 일반적인 발화 속도를 기준으로 하며 실제 사용량만큼 초 단위로 과금됩니다. 전화 회선이 없으므로 전화 통신 비용도 없으며, 세션이 짧으면 그만큼 비용이 줄어듭니다.
| 월간 세션 수 | 연결된 시간(분) | 월간 엔진 비용 |
|---|---|---|
| 500 | 2,000 | $98.20 |
| 2,500 | 10,000 | $491 |
| 10,000 | 40,000 | $1,964 |
선불입니다. $5부터 크레딧을 충전하면 세션이 그 크레딧을 씁니다. 내 사용량으로 견적 내기.
Wixzel Voice에서 웹·모바일 앱용 음성 에이전트를 만드는 방법은 어떤 가이드에 나와 있나요?
Flutter 앱 안에서 사용자가 음성 에이전트와 대화하게 합니다. 서버가 세션을 발급하고 `wixzel_voice` Dart SDK가 WebSocket으로 오디오를 스트리밍하며, SIP 트렁크나 전화번호는 필요 없습니다.
웹사이트로 에이전트를 만들고, 마스코트의 웹사이트 위젯을 켜고, script 태그 하나를 붙여 넣습니다. 방문자는 직접 정한 한도와 발신자 규칙 안에서 브라우저로 통화합니다.
`wixzel_voice_flutter` 패키지로 Flutter 앱에 음성 에이전트의 애니메이션 마스코트를 그리고, 실시간 통화에 맞춰 듣고, 생각하고, 말하게 합니다.
에이전트의 모습을 바꾸고, 링크나 웹사이트 위젯으로 공유하고, 누가 전화할 수 있는지와 일일 한도를 정합니다.
서버에서 세션을 발급하고 WebSocket으로 오디오를 스트리밍합니다. 트렁크도 번호도 필요 없습니다.
자주 묻는 질문
Wixzel Voice로 만든 음성 에이전트를 웹사이트나 모바일 앱에 넣을 수 있나요?
브라우저나 앱에 API 키가 필요한가요?
실시간 API를 지원하는 SDK는 무엇인가요?
웹·앱 세션의 음질은 어떤가요?
웹·앱 세션은 어떻게 과금되나요?
세션은 얼마나 오래 유지될 수 있나요?
Flutter에서도 작동하나요?
에이전트가 말하는 동안 앱에 얼굴을 보여 줄 수 있나요?
코드가 전혀 필요 없는 방법도 있나요?
에이전시와 개발자는 Wixzel Voice로 또 무엇을 만드나요?
전화를 받아 예약 가능한 시간을 확인하고 예약을 잡는 에이전트를 자체 SIP 트렁크 위에 만들 수 있습니다. 예약 내용은 API로 기록됩니다.
리드를 업로드하고 캠페인을 시작하면, 에이전트가 자체 SIP 트렁크로 리드마다 전화를 걸어 선별 질문을 합니다. 모든 통화는 상태와 대화 기록이 담긴 기록으로 남고 해당 리드와 연결됩니다.
업로드한 지식 베이스를 참고해 자주 묻는 질문에 답하고 모든 통화의 대화 기록을 남기는 에이전트로 고객지원 번호를 응대합니다.
인도 언어를 위해 만들어진 모델로 인도 언어 전화 에이전트를 운영합니다. sarvam 엔진이 음성 인식, 언어 모델, 음성 합성을 처음부터 끝까지 담당합니다.
script 태그 하나로 웹사이트에 말하는 AI 비서를 넣을 수 있습니다. 사이트 내용으로 만든 에이전트, 방문자가 브라우저에서 전화를 거는 움직이는 마스코트, 발신자 정보, 발신 허용 설정, 일일 한도를 제공합니다.
Claude Code, Codex, Cursor 등 MCP 클라이언트를 계정에 연결하면, AI 에이전트가 통신사를 연결하고, 음성 에이전트를 만들고, 전화를 걸고, 캠페인을 실행하고, 대화 기록을 읽을 수 있습니다. 비용이 드는 도구는 모두 실행 전에 확인을 요청합니다.
분당 몇 센트로 AI 전화 통화를 운영할 수 있습니다. 선불 크레딧에서 초 단위로 과금하고, 구독이나 최소 금액이 없으며, 자체 SIP 트렁크를 통신 요금 마진 없이 사용하고, 모든 요금이 항목별로 기록됩니다.
음성 에이전트에 얼굴을 줍니다. 에이전트의 말에 맞춰 입을 움직이는 애니메이션 아바타를 웹사이트, 공유 링크, 웹 앱, Flutter 앱에서 쓸 수 있으며, 아바타 요금은 없습니다.
고객마다 고객 자신의 계정과 통신사로, 고객의 언어로 전화 에이전트를 만들고, 초 단위로 과금되는 비용 위에 월 관리비를 청구할 수 있습니다.
운영자, 가격, 한도, 환불, 데이터 위치를 한 페이지에 정리했습니다.