# vox.ai Docs

## Docs

- [AGENTS](https://docs.tryvox.co/AGENTS.md)
- [MINTLIFY](https://docs.tryvox.co/MINTLIFY.md)
- [TEST](https://docs.tryvox.co/TEST.md)
- [Claude code plugins](https://docs.tryvox.co/_references/claude-code-plugins.md)
- [Codex plugins](https://docs.tryvox.co/_references/codex-plugins.md)
- [Cowork plugins](https://docs.tryvox.co/_references/cowork-plugins.md)
- [통화 목록 조회](https://docs.tryvox.co/api-reference/calls/통화-목록-조회.md): 고급 필터(배열/범위 조건)를 포함해 통화 목록을 조회합니다.
- [통화 생성](https://docs.tryvox.co/api-reference/calls/통화-생성.md): 지정한 에이전트로 아웃바운드 전화를 생성하고 즉시 발신합니다.
- [통화 조회](https://docs.tryvox.co/api-reference/calls/통화-조회.md): 통화 ID로 단일 통화 정보를 조회합니다. Bearer 토큰 인증이 필요합니다.
- [캠페인 목록 조회](https://docs.tryvox.co/api-reference/campaigns/캠페인-목록-조회.md): 필터와 페이징을 적용하여 캠페인 목록을 조회합니다.
- [캠페인 생성](https://docs.tryvox.co/api-reference/campaigns/캠페인-생성.md): 다수의 발신 작업을 포함하는 캠페인을 생성합니다.
- [캠페인 수정](https://docs.tryvox.co/api-reference/campaigns/캠페인-수정.md): 캠페인 설정을 부분 수정합니다. draft 또는 pending 상태에서만 가능합니다.
- [캠페인 일시정지](https://docs.tryvox.co/api-reference/campaigns/캠페인-일시정지.md): 캠페인을 일시정지합니다. 진행 중인 통화는 완료되지만 새로운 통화는 시작되지 않습니다.
- [캠페인 재개](https://docs.tryvox.co/api-reference/campaigns/캠페인-재개.md): 일시정지된 캠페인을 재개합니다.
- [캠페인 조회](https://docs.tryvox.co/api-reference/campaigns/캠페인-조회.md): 캠페인 ID로 캠페인 상세 정보를 조회합니다. Bearer 토큰 인증이 필요합니다.
- [캠페인 취소](https://docs.tryvox.co/api-reference/campaigns/캠페인-취소.md): 캠페인을 취소하고 대기 중(pending)인 아이템을 canceled로 전환합니다.
- [소개](https://docs.tryvox.co/api-reference/introduction.md): vox.ai API를 사용하여 에이전트, 통화, 캠페인 등을 프로그래밍 방식으로 관리하세요.
- [지식 문서 배치 삭제](https://docs.tryvox.co/api-reference/knowledge/지식-문서-배치-삭제.md): 지정된 지식 베이스의 여러 문서를 한 번에 삭제합니다. 최대 10개까지 삭제 가능합니다.
- [지식 베이스 다건 조회](https://docs.tryvox.co/api-reference/knowledge/지식-베이스-다건-조회.md): 조직 단위로 지식 베이스 목록을 조회합니다. Bearer 토큰 인증이 필요합니다.
- [지식 베이스 단건 조회](https://docs.tryvox.co/api-reference/knowledge/지식-베이스-단건-조회.md): 지식 베이스 ID로 단일 지식 베이스 정보를 조회합니다. Bearer 토큰 인증이 필요합니다.
- [지식 베이스 문서 삭제](https://docs.tryvox.co/api-reference/knowledge/지식-베이스-문서-삭제.md): 지식 베이스 문서를 삭제합니다. Bearer 토큰 인증이 필요합니다.
- [지식 베이스 문서 추가](https://docs.tryvox.co/api-reference/knowledge/지식-베이스-문서-추가.md): 지식 베이스에 문서를 추가합니다. Bearer 토큰 인증이 필요합니다.
- [지식 베이스 삭제](https://docs.tryvox.co/api-reference/knowledge/지식-베이스-삭제.md): 지식 베이스를 삭제합니다. Bearer 토큰 인증이 필요합니다.
- [지식 베이스 생성](https://docs.tryvox.co/api-reference/knowledge/지식-베이스-생성.md): 지식 베이스를 생성합니다. Bearer 토큰 인증이 필요합니다.
- [업데이트 로그](https://docs.tryvox.co/changelog/index.md): 새로운 업데이트와 개선 사항
- [Claude Code](https://docs.tryvox.co/docs/ai/claude-code.md): Claude Code에서 vox.ai Plugin을 설치하세요.
- [Claude Cowork](https://docs.tryvox.co/docs/ai/claude-cowork.md): Claude Cowork에서 vox.ai Plugin을 설치하세요.
- [OpenAI Codex](https://docs.tryvox.co/docs/ai/openai-codex.md): OpenAI Codex에서 vox.ai Plugin을 설치하세요.
- [연동 개요](https://docs.tryvox.co/docs/ai/overview.md): AI 앱에 Plugin을 설치하고 대화로 에이전트를 빌드·배포·개선하세요.
- [통화 설정](https://docs.tryvox.co/docs/build/conversation/call-settings.md): 배경음, 노이즈 캔슬링, 인식 민감도, 타임아웃, DTMF 등 통화 동작을 설정하세요.
- [DTMF](https://docs.tryvox.co/docs/build/conversation/dtmf.md): 전화 키패드 입력을 활용해 IVR을 만들거나, 에이전트가 IVR을 탐색하게 하세요.
- [첫 메시지](https://docs.tryvox.co/docs/build/conversation/first-message.md): 대화 시작 방식을 설정하세요 — 사용자 먼저, AI 먼저(동적), AI 먼저(정적).
- [발화 설정](https://docs.tryvox.co/docs/build/conversation/speech-settings.md): 반응 속도, 끼어들기 허용, 키워드 등록 등 에이전트의 발화 동작을 조절하세요.
- [글로벌 노드](https://docs.tryvox.co/docs/build/flow/advanced/global-node.md): 모든 대화 상태에서 접근 가능한 글로벌 노드를 설정하는 방법을 안내합니다.
- [API 노드](https://docs.tryvox.co/docs/build/flow/nodes/api-node.md): API 노드를 추가하고 설정하는 방법을 안내합니다.
- [시작 노드](https://docs.tryvox.co/docs/build/flow/nodes/begin-node.md): 플로우 에이전트의 진입점인 시작 노드를 설정하는 방법을 안내합니다.
- [조건 노드](https://docs.tryvox.co/docs/build/flow/nodes/condition-node.md): 변수 값에 따라 대화 흐름을 자동으로 분기하는 조건 노드를 설정하는 방법을 안내합니다.
- [대화 노드](https://docs.tryvox.co/docs/build/flow/nodes/conversation-node.md): 사용자와의 대화를 처리하는 대화 노드를 설정하는 방법을 안내합니다.
- [종료 노드](https://docs.tryvox.co/docs/build/flow/nodes/end-node.md): 통화를 종료하는 종료 노드를 설정하는 방법을 안내합니다.
- [추출 노드](https://docs.tryvox.co/docs/build/flow/nodes/extraction-node.md): 대화에서 중요한 정보를 추출하여 변수로 저장하는 추출 노드를 설정하는 방법을 안내합니다.
- [개요](https://docs.tryvox.co/docs/build/flow/nodes/overview.md): 플로우 에이전트의 노드 타입과 추가 방법을 안내합니다.
- [SMS 노드](https://docs.tryvox.co/docs/build/flow/nodes/send-sms-node.md): 플로우 중간에 SMS 발송 단계를 추가하는 방법을 안내합니다.
- [도구 노드](https://docs.tryvox.co/docs/build/flow/nodes/tool-node.md): 플로우 에이전트에서 외부 도구를 실행하는 도구 노드를 설정하는 방법을 안내합니다.
- [에이전트 전환 노드](https://docs.tryvox.co/docs/build/flow/nodes/transfer-agent-node.md): 다른 에이전트로 대화를 전환하는 노드를 설정하는 방법을 안내합니다.
- [통화 전환 노드](https://docs.tryvox.co/docs/build/flow/nodes/transfer-node.md): 통화를 다른 번호로 전환하는 노드를 설정하는 방법을 안내합니다.
- [개요](https://docs.tryvox.co/docs/build/flow/overview.md): 플로우 에이전트를 생성하고 테스트하는 방법을 안내합니다.
- [전환 조건](https://docs.tryvox.co/docs/build/flow/transitions.md): 노드 간 전환 조건을 설정하여 대화 흐름을 제어하는 방법을 안내합니다.
- [파일](https://docs.tryvox.co/docs/build/knowledge/file.md): PDF, Word, 텍스트, CSV, 이미지 파일을 업로드해 지식 베이스에 문서로 추가합니다.
- [개요](https://docs.tryvox.co/docs/build/knowledge/overview.md): 에이전트에게 지식 베이스를 연결해 대화 중 필요한 정보를 검색하게 합니다.
- [텍스트](https://docs.tryvox.co/docs/build/knowledge/text.md): 제목과 내용을 직접 입력해 지식 베이스에 문서를 추가합니다.
- [웹페이지](https://docs.tryvox.co/docs/build/knowledge/webpage.md): URL을 입력하면 해당 사이트를 자동으로 크롤링해 지식 베이스에 문서로 추가합니다.
- [개요](https://docs.tryvox.co/docs/build/overview.md): 에이전트 설계부터 음성, 도구, 대화 설정까지 — 빌드에 필요한 모든 설정을 안내합니다.
- [통화 정보 추출](https://docs.tryvox.co/docs/build/post-call/extraction.md): 통화 종료 후 대화에서 데이터를 자동 추출하는 규칙을 설정하세요.
- [민감한 데이터 저장 금지](https://docs.tryvox.co/docs/build/security/data-opt-out.md): 민감한 통화 데이터가 vox.ai 서버에 저장되지 않도록 에이전트 단위로 설정하세요.
- [웹훅](https://docs.tryvox.co/docs/build/security/webhooks.md): 인바운드 웹훅과 통화 데이터 웹훅으로 외부 시스템과 실시간으로 연동하세요.
- [개요](https://docs.tryvox.co/docs/build/single-prompt/overview.md): 프롬프트 에이전트의 개념과 장점을 소개합니다
- [프롬프트 작성](https://docs.tryvox.co/docs/build/single-prompt/prompt-writing.md): 효과적인 AI 음성 에이전트 프롬프트 작성 방법을 안내합니다.
- [API 도구](https://docs.tryvox.co/docs/build/tools/api.md): vox.ai의 에이전트가 사용할 API 도구를 만들고 구성하는 방법을 알아보세요.
- [통화 종료](https://docs.tryvox.co/docs/build/tools/builtin/end-call.md): 에이전트가 대화 종료 시점을 판단해 직접 통화를 끊도록 설정합니다.
- [DTMF 전송](https://docs.tryvox.co/docs/build/tools/builtin/send-dtmf.md): 통화 중 ARS/IVR 키패드 톤을 전송해 메뉴를 자동으로 탐색합니다.
- [SMS 발송](https://docs.tryvox.co/docs/build/tools/builtin/send-sms.md): 통화 중 사용자에게 문자 메시지를 발송합니다. 동적 프롬프트 또는 고정 문장으로 작성할 수 있습니다.
- [에이전트 전환](https://docs.tryvox.co/docs/build/tools/builtin/transfer-agent.md): 현재 통화를 같은 조직의 다른 vox.ai 에이전트로 넘깁니다. 대화 컨텍스트도 함께 전달할 수 있습니다.
- [통화 전환](https://docs.tryvox.co/docs/build/tools/builtin/transfer-call.md): 외부 전화번호 또는 SIP로 통화를 전환합니다. 여러 조건별 전환 규칙, 즉시/안내 후 전환, 발신자 표시 번호, SIP 헤더를 설정할 수 있습니다.
- [도구 개요](https://docs.tryvox.co/docs/build/tools/overview.md): 강력한 함수 호출 도구로 에이전트의 기능을 확장할 수 있습니다.
- [동적 변수](https://docs.tryvox.co/docs/build/variables/dynamic-variables.md): 인바운드 웹훅, 단건/대량 발신, SDK, 테스트 프리셋 — 사용처에 맞춰 동적 변수를 주입하는 방법을 설명합니다.
- [시스템 변수](https://docs.tryvox.co/docs/build/variables/system-variables.md): 모든 통화에서 vox.ai가 자동으로 채워주는 기본 변수 5개와 SIP 헤더 기반 자동 변수 주입을 설명합니다.
- [에이전트 버전 관리](https://docs.tryvox.co/docs/build/versioning.md): 에이전트를 버전별로 관리하고, 프로덕션에 배포하고, 필요 시 이전 버전으로 롤백하세요.
- [발음 가이드](https://docs.tryvox.co/docs/build/voice/pronunciation-guide.md): 전화번호, 금액 등 특수 텍스트의 발음을 제어하세요.
- [음성 인식 & 발화](https://docs.tryvox.co/docs/build/voice/voice-select.md): 에이전트의 음성 인식(STT)과 음성 발화(TTS) 설정을 구성하세요.
- [차단 번호](https://docs.tryvox.co/docs/operate/deploy/blocked-numbers.md): 수신·발신할 수 없는 전화번호를 조직 단위로 관리하세요.
- [대량 발신](https://docs.tryvox.co/docs/operate/deploy/outbound-batch.md): 캠페인으로 대량 통화를 실행하세요.
- [단건 발신](https://docs.tryvox.co/docs/operate/deploy/outbound-single.md): 대시보드 또는 API로 단건 통화를 실행하세요.
- [배포 개요](https://docs.tryvox.co/docs/operate/deploy/overview.md): 에이전트를 전화망에 연결하세요.
- [전화번호](https://docs.tryvox.co/docs/operate/deploy/phone-numbers.md): 전화번호를 구매하고 에이전트를 연결하세요.
- [착신전환](https://docs.tryvox.co/docs/operate/deploy/phone/call-forwarding.md): 기존 전화번호를 유지하면서 AI 에이전트로 통화를 연결하세요.
- [발신표기번호](https://docs.tryvox.co/docs/operate/deploy/phone/caller-id.md): 수신자에게 표시할 번호를 변경하세요.
- [레터링](https://docs.tryvox.co/docs/operate/deploy/phone/lettering.md): 수신자 화면에 전화번호 대신 업체명을 표시하세요.
- [통신가입증명원](https://docs.tryvox.co/docs/operate/deploy/phone/telecom-cert.md): 전화번호 가입 사실을 증명하는 서류를 발급하세요.
- [SIP 연동](https://docs.tryvox.co/docs/operate/deploy/sip-telephony.md): SIP 트렁크로 기존 전화번호를 연결하세요.
- [알림](https://docs.tryvox.co/docs/operate/monitor/alerts.md): 지표 이상을 감지하고 자동으로 알림을 받으세요.
- [분석](https://docs.tryvox.co/docs/operate/monitor/analytics.md): 통화 데이터를 차트로 확인하고 에이전트 성과를 추적하세요.
- [통화종료사유](https://docs.tryvox.co/docs/operate/monitor/disconnection-reasons.md): 통화가 종료된 이유를 파악하고 대응하세요.
- [내보내기](https://docs.tryvox.co/docs/operate/monitor/exports.md): 통화 데이터를 CSV로 내보내세요.
- [통화 기록](https://docs.tryvox.co/docs/operate/monitor/history.md): 에이전트의 통화 이력을 조회하고 상세 정보를 확인하세요.
- [모니터링 개요](https://docs.tryvox.co/docs/operate/monitor/overview.md): 통화 기록, 분석, 알림, 웹훅으로 에이전트를 모니터링하세요.
- [통화 후 분석](https://docs.tryvox.co/docs/operate/monitor/post-call.md): 통화 종료 후 요약과 분석 결과를 확인하세요.
- [에이전트 단위 웹훅](https://docs.tryvox.co/docs/operate/monitor/webhooks/agent.md): 에이전트별 통화 이벤트와 웹훅 페이로드 예시를 안내합니다.
- [워크스페이스 단위 웹훅](https://docs.tryvox.co/docs/operate/monitor/webhooks/organization.md): 워크스페이스 기본 웹훅을 설정하고 HMAC 서명을 검증하는 방법을 안내합니다.
- [웹훅 개요](https://docs.tryvox.co/docs/operate/monitor/webhooks/overview.md): 웹훅 유형, 적용 우선순위, 지원 이벤트를 한눈에 안내합니다.
- [Flutter (준비중)](https://docs.tryvox.co/docs/sdk/flutter.md)
- [JavaScript](https://docs.tryvox.co/docs/sdk/javascript.md)
- [Python (준비중)](https://docs.tryvox.co/docs/sdk/python.md)
- [React](https://docs.tryvox.co/docs/sdk/react.md)
- [React Native (준비중)](https://docs.tryvox.co/docs/sdk/react-native.md)
- [AI 고지 의무](https://docs.tryvox.co/docs/security/ai-disclosure.md): AI 기본법에 따라 통화 중 AI 사용 사실을 고지하세요.
- [vox.ai 시작하기](https://docs.tryvox.co/docs/start/overview.md): AI 음성 에이전트를 빌드하고 배포하고 모니터링하는 방법을 알아보세요.
- [요금](https://docs.tryvox.co/docs/start/pricing.md): vox.ai의 구독 플랜, 통화 요금, 통신료, 문자 요금을 안내합니다.
- [빠른 시작](https://docs.tryvox.co/docs/start/quickstart.md): 5분 안에 첫 음성 에이전트를 만들어 보세요.
- [Code Blocks](https://docs.tryvox.co/essentials/code.md): Display inline code and code blocks
- [Images and Embeds](https://docs.tryvox.co/essentials/images.md): Add image, video, and other HTML elements
- [Markdown Syntax](https://docs.tryvox.co/essentials/markdown.md): Text, title, and styling in standard markdown
- [Navigation](https://docs.tryvox.co/essentials/navigation.md): The navigation field in mint.json defines the pages that go in the navigation menu
- [Reusable Snippets](https://docs.tryvox.co/essentials/reusable-snippets.md): Reusable, custom snippets to keep content in sync
- [Global Settings](https://docs.tryvox.co/essentials/settings.md): Mintlify gives you complete control over the look and feel of your documentation using the mint.json file

## OpenAPI Specs

- [openapi](https://docs.tryvox.co/api-reference/openapi.json)
- [openapi_v2](https://docs.tryvox.co/api-reference/openapi_v2.json)