# vox.ai 문서

- [vox.ai 소개](https://docs.tryvox.co/docs/start/overview.md): vox.ai로 AI 전화 에이전트를 만들고, 배포하고, 운영할 수 있어요.
- [시작하기](https://docs.tryvox.co/docs/start/quickstart.md): 매장 안내 에이전트를 만들고 영업시간과 위치를 물어볼 수 있어요.
- [요금](https://docs.tryvox.co/docs/start/pricing.md): 구독 플랜, 통화 요금, 통신료, 문자와 채팅 요금을 찾아볼 수 있어요.
- [구축 개요](https://docs.tryvox.co/docs/build/overview.md): 에이전트 방식을 고르고, 보이스, 도구, 지식 베이스, 대화 동작 설정을 찾아갈 수 있어요.
- [프롬프트 에이전트 개요](https://docs.tryvox.co/docs/build/single-prompt/overview.md): 프롬프트 하나로 대화 전체를 이끄는 에이전트를 빠르게 만들 수 있어요.
- [실시간 음성 런타임 API 작성](https://docs.tryvox.co/docs/build/single-prompt/gpt-live.md): v3 API의 프롬프트 에이전트에서 실시간 음성 런타임을 지정하고 제공사별 제약을 확인할 수 있어요.
- [프롬프트 작성](https://docs.tryvox.co/docs/build/single-prompt/prompt-writing.md): 음성 통화에 맞는 구조로 프롬프트를 써서 에이전트가 늘 같은 방식으로 응대하게 할 수 있어요.
- [첫 메시지](https://docs.tryvox.co/docs/build/conversation/first-message.md): 고객의 용건부터 듣거나 준비한 인사로 통화를 시작할 수 있어요.
- [플로우 에이전트 개요](https://docs.tryvox.co/docs/build/flow/overview.md): 대화를 노드로 나누고 조건에 따라 다음 단계로 넘겨, 순서가 정해진 상담을 그대로 따르는 에이전트를 만들 수 있어요.
- [노드 개요](https://docs.tryvox.co/docs/build/flow/nodes/overview.md): 플로우를 노드로 나누고 전환 조건으로 이어, 단계마다 에이전트가 할 일을 정할 수 있어요.
- [시작 노드](https://docs.tryvox.co/docs/build/flow/nodes/begin-node.md): 플로우를 고객의 용건부터 들을지, 에이전트의 안내로 시작할지 정할 수 있어요.
- [대화 노드](https://docs.tryvox.co/docs/build/flow/nodes/conversation-node.md): 고객에게 필요한 정보를 묻고, 답에 따라 다음 단계로 안내할 수 있어요.
- [API 노드](https://docs.tryvox.co/docs/build/flow/nodes/api-node.md): 플로우의 정해진 지점에서 주문을 조회하거나 예약을 접수하고, 응답 값을 다음 안내에 쓸 수 있어요.
- [추출 노드](https://docs.tryvox.co/docs/build/flow/nodes/extraction-node.md): 고객이 말한 이름, 전화번호, 날짜 같은 정보를 변수로 저장해 다음 노드에서 쓸 수 있어요.
- [조건 노드](https://docs.tryvox.co/docs/build/flow/nodes/condition-node.md): 변수 값을 비교해 문의 유형이나 조회 결과에 맞는 안내로 연결할 수 있어요.
- [도구 노드](https://docs.tryvox.co/docs/build/flow/nodes/tool-node.md): 등록해 둔 API 도구를 플로우의 정해진 지점에서 실행하고, 결과에 맞춰 다음 안내로 이어갈 수 있어요.
- [문자 발신 노드](https://docs.tryvox.co/docs/build/flow/nodes/send-sms-node.md): 예약 확인이나 상담 자료를 플로우의 정해진 지점에서 문자로 보내고, 결과에 맞춰 다음 안내를 정할 수 있어요.
- [통화 전환 노드](https://docs.tryvox.co/docs/build/flow/nodes/transfer-node.md): 플로우가 정한 지점에서 통화를 상담사의 전화번호나 SIP 주소로 넘길 수 있어요.
- [에이전트 전환 노드](https://docs.tryvox.co/docs/build/flow/nodes/transfer-agent-node.md): 플로우가 정한 단계를 마친 고객을 원하는 지점에서 담당 에이전트에게 넘길 수 있어요.
- [종료 노드](https://docs.tryvox.co/docs/build/flow/nodes/end-node.md): 상담을 마친 고객에게 마지막 인사를 전하고 통화를 끝낼 수 있어요.
- [전환 조건](https://docs.tryvox.co/docs/build/flow/transitions.md): 노드마다 다음으로 넘어갈 조건을 적어, 고객의 답과 처리 결과에 따라 대화가 갈 길을 정할 수 있어요.
- [API로 플로우 작성 및 검증](https://docs.tryvox.co/docs/build/flow/api-authoring.md): v3 API의 flow 필드로 플로우 에이전트 그래프를 작성하고 검증하고, 기존 flow_data에서 옮길 수 있어요.
- [글로벌 노드](https://docs.tryvox.co/docs/build/flow/advanced/global-node.md): 대화가 어느 단계에 있든 거절이나 상담사 연결 요청 같은 공통 상황을 한 노드에서 처리할 수 있어요.
- [음성 인식 & 발화](https://docs.tryvox.co/docs/build/voice/voice-select.md): 고객의 말을 인식할 언어와 에이전트의 목소리를 정하고, 통화로 인식 결과와 말하는 속도를 확인할 수 있어요.
- [보이스 클론](https://docs.tryvox.co/docs/build/voice/voice-clone.md): 짧은 음성 샘플로 내 보이스를 만들어 에이전트 목소리로 쓸 수 있어요.
- [발음 가이드](https://docs.tryvox.co/docs/build/voice/pronunciation-guide.md): 전화번호, 금액, 약어처럼 읽기 까다로운 글자를 에이전트가 뜻대로 읽게 할 수 있어요.
- [도구 개요](https://docs.tryvox.co/docs/build/tools/overview.md): 에이전트가 통화 중에 통화를 끝내거나 넘기고, 문자를 보내고, 고객이 말한 값을 저장하고, 자체 시스템을 조회하게 할 수 있어요.
- [통화 종료](https://docs.tryvox.co/docs/build/tools/builtin/end-call.md): 대화가 끝났다고 판단되면 에이전트가 스스로 통화를 끊게 할 수 있어요.
- [통화 전환](https://docs.tryvox.co/docs/build/tools/builtin/transfer-call.md): 에이전트가 처리하기 어려운 통화를 끊지 않고 상담사에게 넘길 수 있어요.
- [에이전트 전환](https://docs.tryvox.co/docs/build/tools/builtin/transfer-agent.md): 통화를 끊지 않고 같은 워크스페이스의 다른 에이전트에게 응대를 넘길 수 있어요.
- [문자 발신](https://docs.tryvox.co/docs/build/tools/builtin/send-sms.md): 통화 중인 고객에게 예약 정보나 링크를 문자로 보낼 수 있어요.
- [DTMF 전송](https://docs.tryvox.co/docs/build/tools/builtin/send-dtmf.md): 에이전트가 ARS 안내에 맞춰 번호를 눌러 원하는 메뉴나 내선으로 연결되게 할 수 있어요.
- [주소 검색](https://docs.tryvox.co/docs/build/tools/builtin/search-address.md): 통화 중 들은 주소로 후보를 찾고, 고객에게 배송지나 방문지가 맞는지 확인받을 수 있어요.
- [변수 추출](https://docs.tryvox.co/docs/build/tools/builtin/extract-variables.md): 통화 중에 고객이 말하거나 키패드로 누른 값을 변수에 저장해 프롬프트와 다른 도구에서 바로 쓸 수 있어요.
- [API 도구](https://docs.tryvox.co/docs/build/tools/api.md): 에이전트가 통화 중에 자체 서버나 외부 API를 호출해 정보를 조회하거나 작업을 처리하게 할 수 있어요.
- [실행 대기음](https://docs.tryvox.co/docs/build/tools/tool-call-sound.md): 도구가 실행되는 동안 대기음을 재생해, 고객이 무음 구간에 통화가 끊겼다고 느끼지 않게 할 수 있어요.
- [지식 베이스 개요](https://docs.tryvox.co/docs/build/knowledge/overview.md): FAQ, 제품 안내, 정책 자료를 에이전트에 연결해 상담에 쓸 수 있어요.
- [웹페이지](https://docs.tryvox.co/docs/build/knowledge/webpage.md): 공개 웹페이지 본문을 가져와 에이전트의 상담 자료로 쓰고, 원본이 바뀌면 다시 반영할 수 있어요.
- [파일](https://docs.tryvox.co/docs/build/knowledge/file.md): 업무 안내서와 제품 설명서 파일을 올려 에이전트가 상담에 참고하게 할 수 있어요.
- [텍스트](https://docs.tryvox.co/docs/build/knowledge/text.md): 직접 쓴 FAQ와 업무 안내를 에이전트의 답에 쓸 수 있어요.
- [메뉴얼 개요](https://docs.tryvox.co/docs/build/manuals/overview.md): 업무 절차를 에이전트 안에 메뉴얼로 나눠 두고, 대화가 트리거와 맞는 순간에만 그 절차를 불러올 수 있어요.
- [메뉴얼 작성](https://docs.tryvox.co/docs/build/manuals/writing.md): 메뉴얼의 트리거와 본문을 쓰고, 도구와 다른 메뉴얼을 참조하고, 템플릿이나 문서로 초안을 시작할 수 있어요.
- [고객 메모리 개요](https://docs.tryvox.co/docs/build/customer-memory/overview.md): 에이전트가 지난 대화에서 확인한 고객 정보를 기억했다가 다음 대화에 쓰게 할 수 있어요.
- [메모리](https://docs.tryvox.co/docs/build/customer-memory/memory.md): 지난 대화에서 확인한 사실을 기억해 두고, 같은 고객이 다시 연락하면 에이전트가 이어서 응대하게 할 수 있어요.
- [고객 속성](https://docs.tryvox.co/docs/build/customer-memory/attributes.md): 멤버십 등급이나 관심 상품 같은 고객 값을 정한 형식으로 대화에서 자동으로 모을 수 있어요.
- [시스템 변수](https://docs.tryvox.co/docs/build/variables/system-variables.md): vox.ai가 통화와 채팅마다 채우는 변수와 SIP 헤더로 들어오는 변수를 프롬프트에서 바로 쓸 수 있어요.
- [동적 변수](https://docs.tryvox.co/docs/build/variables/dynamic-variables.md): 통화마다 바뀌는 고객 정보를 프롬프트에 넣어 에이전트 하나로 고객마다 다르게 응대할 수 있어요.
- [인바운드 웹훅](https://docs.tryvox.co/docs/build/variables/inbound-webhook.md): 걸려 온 통화의 발신번호로 내 서버에서 고객 정보를 받아 통화 시작 전에 동적 변수로 넣을 수 있어요.
- [발화 설정](https://docs.tryvox.co/docs/build/conversation/speech-settings.md): 고객 말을 충분히 듣고 답하도록 응답 타이밍과 끼어들기, 자주 틀리는 단어를 조정할 수 있어요.
- [통화 설정](https://docs.tryvox.co/docs/build/conversation/call-settings.md): 통화 소리를 다듬고, 통화 길이를 관리하고, 키패드 입력과 통화 스크리닝에 대응할 수 있어요.
- [DTMF](https://docs.tryvox.co/docs/build/conversation/dtmf.md): 고객이 누른 키패드 입력으로 메뉴를 고르게 하거나, 에이전트가 다른 전화의 ARS 메뉴를 누르게 할 수 있어요.
- [에이전트 버전 관리](https://docs.tryvox.co/docs/build/versioning.md): 에이전트 설정을 버전으로 저장해 프로덕션에 배포하고, 문제가 생기면 이전 버전으로 되돌릴 수 있어요.
- [통화 정보 추출](https://docs.tryvox.co/docs/build/post-call/extraction.md): 통화가 끝나면 대화에서 문의 유형, 금액, 예약 여부 같은 값을 자동으로 뽑아 모을 수 있어요.
- [데이터 보존 정책](https://docs.tryvox.co/docs/build/security/data-retention.md): 에이전트마다 통화와 채팅 콘텐츠를 얼마나, 어떤 종류까지 보관할지 정할 수 있어요.
- [통화 데이터 저장 제외](https://docs.tryvox.co/docs/build/security/data-opt-out.md): 스크립트와 분석 결과는 두고 통화 녹음만 저장하지 않거나, 통화 콘텐츠를 아예 남기지 않을 수 있어요.
- [개인정보 보호](https://docs.tryvox.co/docs/build/security/pii-protection.md): 통화와 채팅이 끝난 뒤 대화 내용, 요약, 도구 호출에 담긴 개인정보를 가릴 수 있어요.
- [배포 개요](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): 기존 전화번호를 그대로 두고 걸려 오는 전화를 vox.ai 에이전트가 받게 할 수 있어요.
- [SIP 연동](https://docs.tryvox.co/docs/operate/deploy/sip-telephony.md): SIP 트렁크로 기존 전화번호를 연결하세요.
- [장애 시 우회연결](https://docs.tryvox.co/docs/operate/deploy/phone/fallback-routing.md): 에이전트가 전화를 받기 전에 연결이 실패하거나 일정 시간 응답이 없으면 걸려 온 전화를 지정한 번호나 SIP 주소로 넘길 수 있어요.
- [발신표기번호](https://docs.tryvox.co/docs/operate/deploy/phone/caller-id.md): 070 번호 대신 기존 유선번호나 대표번호를 수신자 화면에 보일 수 있어요.
- [통신가입증명원](https://docs.tryvox.co/docs/operate/deploy/phone/telecom-cert.md): 번호의 가입 사실을 증명하는 서류를 발급해 발신표기번호 등록에 제출할 수 있어요.
- [레터링](https://docs.tryvox.co/docs/operate/deploy/phone/lettering.md): 전화를 받는 사람의 화면에 전화번호 대신 업체명을 보일 수 있어요.
- [문자 부가서비스](https://docs.tryvox.co/docs/operate/deploy/phone/sms.md): 전화번호에 문자 발신과 수신을 신청하고 상태와 요금을 확인할 수 있어요.
- [광고 문자](https://docs.tryvox.co/docs/operate/deploy/phone/sms-ad.md): 전화번호에 광고 문자 표시와 무료 수신거부 안내를 붙이고, 수신거부한 번호를 광고 문자에서 뺄 수 있어요.
- [차단 번호](https://docs.tryvox.co/docs/operate/deploy/blocked-numbers.md): 수신거부 번호와 악성 번호를 등록해 통화와 문자를 자동으로 막을 수 있어요.
- [위젯 개요](https://docs.tryvox.co/docs/operate/deploy/widget/overview.md): 웹사이트 방문자가 페이지를 떠나지 않고 에이전트와 채팅하거나 통화하고, 전화를 요청할 수 있어요.
- [위젯 유형](https://docs.tryvox.co/docs/operate/deploy/widget/modes.md): 채팅, 음성, 전화 콜백 가운데 방문자가 상담을 시작할 방식을 고를 수 있어요.
- [모양과 메시지](https://docs.tryvox.co/docs/operate/deploy/widget/appearance.md): 위젯 버튼과 창의 색, 형태, 첫 인사를 웹사이트에 맞게 바꿀 수 있어요.
- [방문자 식별](https://docs.tryvox.co/docs/operate/deploy/widget/visitors.md): 여러 기기의 방문자를 같은 고객으로 잇고, 지난 대화의 메모리를 다음 상담에 이어 갈 수 있어요.
- [API와 CLI](https://docs.tryvox.co/docs/operate/deploy/widget/api.md): v3 위젯 API와 vox CLI로 위젯 설정과 게시 상태를 관리할 수 있어요.
- [연동 개요](https://docs.tryvox.co/docs/operate/deploy/integrations/overview.md): 고객이 쓰는 메신저 채널을 에이전트에 연결하고, 연결한 채널의 상태를 한 화면에서 볼 수 있어요.
- [카카오 상담톡 연결과 운영](https://docs.tryvox.co/docs/operate/deploy/integrations/kakao/overview.md): 카카오톡 채널을 에이전트에 연동해 상담톡 문의에 AI가 답하고, 필요할 때 상담사가 데스크에서 이어받을 수 있어요.
- [네이버톡톡 연결과 운영](https://docs.tryvox.co/docs/operate/deploy/integrations/navertalk/overview.md): 네이버톡톡 계정을 에이전트에 연결해 톡톡 문의에 AI가 답하고, 필요할 때 상담사가 이어받을 수 있어요.
- [채널톡 연결과 운영](https://docs.tryvox.co/docs/operate/deploy/integrations/channeltalk/overview.md): 채널톡 상담에 에이전트를 연결해 고객 문의에 AI가 답하고, 필요할 때 채널톡 매니저가 이어받을 수 있어요.
- [전화](https://docs.tryvox.co/docs/operate/outbound/call.md): 전화 한 통을 지금 걸어 에이전트가 실제로 어떻게 통화하는지 확인할 수 있어요.
- [에이전트가 문자 대화 시작하기](https://docs.tryvox.co/docs/operate/outbound/sms.md): 에이전트가 먼저 문자를 보내 고객과 대화하게 하거나, 문자 한 통을 직접 보낼 수 있어요.
- [대량 발신](https://docs.tryvox.co/docs/operate/outbound/campaigns.md): 시트 하나로 수백에서 수천 건을 전화나 문자로 내보내고, 실행 결과를 한곳에서 추적할 수 있어요.
- [프로젝트](https://docs.tryvox.co/docs/operate/outbound/projects.md): 수신자 목록을 시트로 만들고, 컬럼으로 수신자마다 다른 값을 채울 수 있어요.
- [전화 대량 발신](https://docs.tryvox.co/docs/operate/outbound/call-batch.md): 시트에서 고른 행으로 통화를 한 번에 걸고, 미연결 건을 자동으로 다시 걸 수 있어요.
- [문자 대량 발신](https://docs.tryvox.co/docs/operate/outbound/sms-batch.md): 시트에 모은 수신자에게 개인화한 문자를 한 번에 보내고 행마다 결과를 볼 수 있어요.
- [대량 발신 이력](https://docs.tryvox.co/docs/operate/outbound/batch-history.md): 실행한 대량 발신을 찾아 진행을 제어하고, 결과를 파일로 내보낼 수 있어요.
- [모니터링 개요](https://docs.tryvox.co/docs/operate/monitor/overview.md): 통화·채팅·문자 기록을 검토하고, 고객별 이력을 보고, 이상 징후를 알림으로 받을 수 있어요.
- [홈](https://docs.tryvox.co/docs/operate/monitor/dashboard.md): 워크스페이스 홈에서 통화 성과와 비용, 연결률, 응답 지연을 한눈에 볼 수 있어요.
- [통화 기록](https://docs.tryvox.co/docs/operate/monitor/history.md): 통화를 찾아 검토하고, 팀과 공유하고, 파일로 내보낼 수 있어요.
- [채팅 기록](https://docs.tryvox.co/docs/operate/monitor/chats.md): 에이전트가 나눈 채팅을 찾아 대화 내용과 분석을 볼 수 있어요.
- [문자 기록](https://docs.tryvox.co/docs/operate/monitor/sms-history.md): 보내고 받은 문자를 한 목록에서 찾아 전송 결과를 확인하고, 파일로 내보낼 수 있어요.
- [통화 녹음](https://docs.tryvox.co/docs/operate/monitor/recording.md): 통화 녹음을 대시보드에서 듣고, API와 웹훅으로 원본 파일을 내려받을 수 있어요.
- [연결 종료 사유](https://docs.tryvox.co/docs/operate/monitor/disconnection-reasons.md): 통화가 끝난 이유를 값별로 찾아보고 대응할 수 있어요.
- [내보내기](https://docs.tryvox.co/docs/operate/monitor/exports.md): 통화 기록, 대량 발신 이력, 고객 목록을 CSV나 XLSX 파일로 내보낼 수 있어요.
- [고객](https://docs.tryvox.co/docs/operate/monitor/customers.md): 고객을 찾아 대화 이력과 메모리를 확인하고, 흩어진 기록을 정리하고, 파일로 내보낼 수 있어요.
- [A/B 테스트](https://docs.tryvox.co/docs/operate/monitor/ab-testing.md): 새 버전을 일부 통화에 먼저 적용하고 기존 버전과 결과를 비교할 수 있어요.
- [알림](https://docs.tryvox.co/docs/operate/monitor/alerts.md): 지표가 임계값을 넘으면 웹훅, 이메일, 슬랙으로 알림을 받을 수 있어요.
- [통화 후 분석](https://docs.tryvox.co/docs/operate/monitor/post-call.md): 통화가 끝나면 자동으로 만들어지는 요약, 만족도, 추출 결과를 확인하고 활용할 수 있어요.
- [웹훅 개요](https://docs.tryvox.co/docs/operate/monitor/webhooks/overview.md): 통화, 상담사 통화, 채팅, 문자, 대량 발신 이벤트를 외부 서버에서 실시간으로 받을 수 있어요.
- [워크스페이스 단위 웹훅](https://docs.tryvox.co/docs/operate/monitor/webhooks/organization.md): 워크스페이스 웹훅 URL과 서명 키를 설정하고 수신 서버에서 요청이 vox.ai에서 왔는지 검증할 수 있어요.
- [통화 이벤트와 페이로드](https://docs.tryvox.co/docs/operate/monitor/webhooks/agent.md): 통화와 상담사 통화의 이벤트를 받아 외부 시스템에 기록하는 수신 서버를 만들 수 있어요.
- [웹훅 스키마](https://docs.tryvox.co/docs/operate/monitor/webhooks/schema.md): 이벤트별 웹훅 페이로드의 필드와 예시를 찾아볼 수 있어요.
- [웹훅 이벤트 라이프사이클](https://docs.tryvox.co/docs/operate/monitor/webhooks/lifecycle.md): 통화 유형마다 어떤 웹훅 이벤트가 언제 오는지 보고, 수신 서버에서 처리할 이벤트를 정할 수 있어요.
- [워크스페이스 개요](https://docs.tryvox.co/docs/workspace/overview.md): 팀, 에이전트, 전화번호, 결제를 워크스페이스 하나로 묶어 관리할 수 있어요.
- [워크스페이스 설정](https://docs.tryvox.co/docs/workspace/settings.md): 팀, 결제, 보안, 외부 연동 설정을 한곳에서 관리할 수 있어요.
- [워크스페이스 역할](https://docs.tryvox.co/docs/workspace/roles.md): 오너, 관리자, 멤버가 각각 무엇을 할 수 있는지 확인하고 역할을 정할 수 있어요.
- [워크스페이스 인증](https://docs.tryvox.co/docs/workspace/verification.md): 명의에 맞는 서류로 워크스페이스를 인증하고 전화번호와 통신 기능을 쓸 수 있어요.
- [하위 워크스페이스](https://docs.tryvox.co/docs/workspace/sub-organizations.md): 상위 워크스페이스 아래에 하위 워크스페이스를 두어 팀과 번호는 나누고 청구는 한곳으로 모을 수 있어요.
- [API 키](https://docs.tryvox.co/docs/workspace/api-keys.md): 서버와 앱에서 vox.ai를 호출할 API 키를 만들고 안전하게 보관할 수 있어요.
- [발신 콘텐츠 정책](https://docs.tryvox.co/docs/security/outbound-content-policy.md): vox.ai 발신망으로 보낼 수 없는 콘텐츠 유형과 위반했을 때의 조치를 확인할 수 있어요.
- [AI 고지 의무](https://docs.tryvox.co/docs/security/ai-disclosure.md): 첫 인사에서 AI 상담사임을 밝히고, 통화에서 안내가 실제로 들리는지 확인할 수 있어요.
- [AI 연동 시작하기](https://docs.tryvox.co/docs/ai/overview.md): 작업 방식에 맞는 AI 연결 방법을 골라 vox.ai 에이전트를 만들고 관리할 수 있어요.
- [vox.ai 플러그인](https://docs.tryvox.co/docs/ai/plugin.md): 코딩 에이전트에 vox.ai를 연결해 대화로 에이전트를 만들고 운영할 수 있어요.
- [vox.ai MCP](https://docs.tryvox.co/docs/ai/mcp.md): MCP를 지원하는 AI 앱을 vox.ai에 연결해 에이전트와 통화를 대화로 다룰 수 있어요.
- [vox.ai CLI](https://docs.tryvox.co/docs/ai/cli.md): 에이전트와 메뉴얼을 파일로 관리하고 터미널에서 검증·저장할 수 있어요.
- [MCP 도구 참조](https://docs.tryvox.co/docs/ai/mcp-reference.md): MCP 도구의 역할과 저장·게시, 실행 확인, 재시도 규칙을 확인할 수 있어요.
- [CLI 명령 참조](https://docs.tryvox.co/docs/ai/cli-reference.md): CLI의 명령과 JSON 출력, 인증·CI 설정을 찾아볼 수 있어요.
- [JavaScript](https://docs.tryvox.co/docs/sdk/javascript.md): 바닐라 JavaScript로 웹 페이지에 음성 에이전트를 연결할 수 있어요.
- [React](https://docs.tryvox.co/docs/sdk/react.md): useConversation 훅으로 React 앱에 음성 에이전트를 연결할 수 있어요.
- [React Native (준비중)](https://docs.tryvox.co/docs/sdk/react-native.md): React Native SDK는 정식 공개 전이라 베타로 신청해 쓸 수 있어요.
- [Python (준비중)](https://docs.tryvox.co/docs/sdk/python.md): Python SDK는 정식 공개 전이라 베타로 신청해 쓸 수 있어요.
- [Flutter (준비중)](https://docs.tryvox.co/docs/sdk/flutter.md): Flutter SDK는 정식 공개 전이라 베타로 신청해 쓸 수 있어요.
- [소개](https://docs.tryvox.co/api-reference/v3/introduction.md): vox.ai v3 API로 에이전트, 모델, 도구, 통화와 고객 데이터를 관리할 수 있어요.
- [통화 생성](https://docs.tryvox.co/api-reference/v3/calls/통화-생성.md): 아웃바운드 통화를 생성합니다. 발신번호에 활성 traffic split 정책이 없을 때만 `agent`를 직접 지정할 수 있습니다.
- [통화 목록 조회](https://docs.tryvox.co/api-reference/v3/calls/통화-목록-조회.md): 인증된 워크스페이스(`organization_id`)의 통화 목록을 조회합니다. 에이전트, 통화 상태, 통화 유형, 전화번호, 종료 사유, 시작 시각, 통화 시간, 에이전트 버전, 메타데이터, 동적 변수로 필터링할 수 있습니다.
- [통화 조회](https://docs.tryvox.co/api-reference/v3/calls/통화-조회.md): 인증된 워크스페이스(`organization_id`)의 통화 1건을 조회합니다.
- [진행 중 통화 전환 요청](https://docs.tryvox.co/api-reference/v3/calls/진행-중-통화-전환-요청.md): 진행 중인 전화 통화에 즉시 전환 (cold) 또는 안내 후 전환 (warm)을 요청합니다. 전환 대상은 전화번호 또는 SIP URI로 지정할 수 있습니다. 202 응답은 서버가 보낸 전환 명령이 진행 중인 통화에 전달되어 수락되었다는 뜻입니다. 실제 전환 완료나 전환 대상의 응답을 뜻하지 않습니다.
- [상담사 통화 목록 조회](https://docs.tryvox.co/api-reference/v3/operator-calls/상담사-통화-목록-조회.md): 인증된 워크스페이스(`organization_id`)의 상담사 통화를 조회합니다. 결과는 레코드 생성 시각인 `requested_at`순으로 정렬합니다. `start_at` 필터는 사람 상담 구간 시작 시각을 기준으로 적용합니다.
- [상담사 통화 조회](https://docs.tryvox.co/api-reference/v3/operator-calls/상담사-통화-조회.md): 상담사 통화 한 건을 조회합니다. 전체 사람 상담 대화록, 사용 가능한 경우 15분 동안 유효한 서명된 녹음 URL, 상담사 통화 비용을 포함합니다.
- [에이전트 생성](https://docs.tryvox.co/api-reference/v3/agents/에이전트-생성.md): single-prompt 또는 flow 에이전트를 생성합니다. flow 에이전트는 권장 경로인 `flow` 필드(`{nodes, edges}`)로 그래프를 작성하고, 기존 `flow_data`는 호환용입니다.
- [에이전트 목록](https://docs.tryvox.co/api-reference/v3/agents/에이전트-목록.md): 인증된 워크스페이스(`organization_id`)의 에이전트 목록을 조회합니다. 목록 항목은 요약 정보이며, `data`, `flow_data`, 버전 스냅샷은 단건 조회에서 확인합니다.
- [에이전트 단건 조회](https://docs.tryvox.co/api-reference/v3/agents/에이전트-단건-조회.md): 에이전트 1건을 조회합니다. `version=current`는 수정 가능한 현재 상태를, `production`이나 `v{n}`은 저장된 스냅샷을 반환합니다.
- [에이전트 수정](https://docs.tryvox.co/api-reference/v3/agents/에이전트-수정.md): 에이전트를 부분 수정합니다. 생략한 필드는 유지되고, `type`은 변경할 수 없습니다. flow 그래프는 `flow` 필드로 작성하며 전체 교체로 동작합니다(현재 그래프를 유지하려면 생략). 기존 `flow_data`는 호환용입니다.
- [에이전트 삭제](https://docs.tryvox.co/api-reference/v3/agents/에이전트-삭제.md): 인증된 워크스페이스(`organization_id`)의 에이전트를 삭제 처리합니다.
- [플로우 검증](https://docs.tryvox.co/api-reference/v3/agents/플로우-검증.md): `flow`(`{nodes, edges}`)를 저장하지 않고 검증합니다. `valid`는 저장 가능 여부를 나타내며, 저장을 막는 치명적 오류가 없으면 `true`입니다. 런타임 주의 항목은 `valid`에 영향을 주지 않습니다.
- [에이전트 버전 생성](https://docs.tryvox.co/api-reference/v3/agentversions/에이전트-버전-생성.md): 에이전트의 현재 `data`와 `flow_data`를 변경 불가능한 버전으로 저장합니다.
- [에이전트 버전 목록 조회](https://docs.tryvox.co/api-reference/v3/agentversions/에이전트-버전-목록-조회.md): 에이전트의 저장된 버전 목록을 조회합니다. 응답에는 버전 메타데이터만 포함되며, 스냅샷 본문은 에이전트 단건 조회에서 `version=v{n}`으로 확인합니다.
- [에이전트 버전 프로덕션 게시](https://docs.tryvox.co/api-reference/v3/agentversions/에이전트-버전-프로덕션-게시.md): 기존 버전을 production 버전으로 지정합니다. 이후 `agent_version=production`으로 실행되는 통화는 이 스냅샷을 사용합니다.
- [도구 생성](https://docs.tryvox.co/api-reference/v3/tools/도구-생성.md): 에이전트가 호출할 custom API 도구를 생성합니다. 모델에 노출할 `input_schema`와 서버가 실행할 API 설정을 함께 정의합니다.
- [도구 목록 조회](https://docs.tryvox.co/api-reference/v3/tools/도구-목록-조회.md): 인증된 워크스페이스(`organization_id`)에서 사용할 수 있는 custom API 도구 목록을 조회합니다. 목록 응답에는 실행 설정이 생략되며, 자세한 내용은 `GET /v3/tools/{tool_id}`에서 확인합니다.
- [도구 상세 조회](https://docs.tryvox.co/api-reference/v3/tools/도구-상세-조회.md): custom 도구 1건을 조회합니다. 입력 스키마와 API 실행 설정을 함께 반환합니다.
- [도구 수정](https://docs.tryvox.co/api-reference/v3/tools/도구-수정.md): custom API 도구의 이름, 스키마, 실행 설정, 발화 동작을 수정합니다.
- [도구 삭제](https://docs.tryvox.co/api-reference/v3/tools/도구-삭제.md): 인증된 워크스페이스의 사용자 정의 도구를 삭제하고 에이전트의 현재 초안에서 해당 도구의 참조를 제거합니다. 발행된 버전은 유지됩니다.
- [지식 베이스 생성](https://docs.tryvox.co/api-reference/v3/knowledges/지식-베이스-생성.md): 빈 knowledge base를 생성합니다. 생성 후 text, webpage, file document를 추가합니다.
- [지식 베이스 목록 조회](https://docs.tryvox.co/api-reference/v3/knowledges/지식-베이스-목록-조회.md): 인증된 워크스페이스(`organization_id`)가 보유한 knowledge base 목록을 조회합니다. source document 조회와 관리는 각 knowledge base 하위 document endpoint를 사용합니다.
- [지식 베이스 삭제](https://docs.tryvox.co/api-reference/v3/knowledges/지식-베이스-삭제.md): knowledge base와 그 source document를 삭제합니다.
- [지식 베이스 문서 생성](https://docs.tryvox.co/api-reference/v3/knowledge-documents/지식-베이스-문서-생성.md): knowledge base 안에 text, webpage, file document를 생성합니다. document는 즉시 반환되며 처리는 비동기로 진행됩니다.
- [지식 베이스 문서 목록 조회](https://docs.tryvox.co/api-reference/v3/knowledge-documents/지식-베이스-문서-목록-조회.md): knowledge base에 연결된 source document 목록을 조회합니다. document type이나 처리 상태는 반복 query parameter로 필터링할 수 있습니다.
- [지식 베이스 문서 삭제](https://docs.tryvox.co/api-reference/v3/knowledge-documents/지식-베이스-문서-삭제.md): knowledge base에서 source document 1건을 삭제하고 vector data를 제거합니다. 상위 knowledge base는 유지됩니다.
- [에이전트 메뉴얼 생성](https://docs.tryvox.co/api-reference/v3/agentmanuals/에이전트-메뉴얼-생성.md): 에이전트의 현재 편집본에 메뉴얼을 추가합니다. 추가한 메뉴얼은 다음 에이전트 버전부터 포함됩니다.
- [에이전트 메뉴얼 목록 조회](https://docs.tryvox.co/api-reference/v3/agentmanuals/에이전트-메뉴얼-목록-조회.md): 에이전트의 현재 편집본에 있는 메뉴얼 목록을 조회합니다. 목록 항목은 요약 정보이며, 본문과 빌트인 도구는 메뉴얼 단건 조회에서 확인합니다.
- [에이전트 메뉴얼 단건 조회](https://docs.tryvox.co/api-reference/v3/agentmanuals/에이전트-메뉴얼-단건-조회.md): 메뉴얼 1건을 조회합니다. 본문, 빌트인 도구, 참조, 진단을 함께 반환합니다.
- [에이전트 메뉴얼 수정](https://docs.tryvox.co/api-reference/v3/agentmanuals/에이전트-메뉴얼-수정.md): 에이전트의 현재 편집본에 있는 메뉴얼을 부분 수정합니다. 생략한 필드는 유지되고, 필드에 `null`은 보낼 수 없습니다.
- [에이전트 메뉴얼 삭제](https://docs.tryvox.co/api-reference/v3/agentmanuals/에이전트-메뉴얼-삭제.md): 에이전트의 현재 편집본에서 메뉴얼을 삭제합니다. 삭제 후 리비전은 응답 헤더 `X-Agent-Head-Revision`으로 반환합니다.
- [LLM 모델 목록 조회](https://docs.tryvox.co/api-reference/v3/models/llm-모델-목록-조회.md): `agent.data.llm.model`에 사용할 수 있는 LLM 모델 목록을 조회합니다. 가능한 경우 temperature 범위 같은 capability 정보도 함께 반환합니다.
- [음성 모델 생성](https://docs.tryvox.co/api-reference/v3/models/음성-모델-생성.md): 오디오 샘플로 워크스페이스(`organization_id`) 전용 보이스 클론을 생성합니다. `multipart/form-data`로 `clip` 오디오 파일과 `name`, `language` 필드를 보냅니다. 오디오 파일은 6MB 이하여야 합니다. 생성된 보이스는 `GET /v3/models/voices` 목록에 나타나며 `agent.data.voice`로 사용할 수 있습니다. 클론 한도에 도달하면 요청은 409 `VOICE_CLONE_LIMIT_REACHED`로 실패하며, `error.details.current_count`와…
- [음성 모델 목록 조회](https://docs.tryvox.co/api-reference/v3/models/음성-모델-목록-조회.md): `agent.data.voice`에 사용할 수 있는 음성 모델 목록을 조회합니다. 워크스페이스(`organization_id`) 전용 보이스도 포함합니다. 다음 페이지는 `next_cursor`를 `cursor`로 다시 전달해 조회합니다. `is_public: false`는 삭제 가능한 워크스페이스 전용 보이스를 나타냅니다.
- [음성 모델 삭제](https://docs.tryvox.co/api-reference/v3/models/음성-모델-삭제.md): 워크스페이스(`organization_id`) 전용으로 생성한 보이스 클론을 삭제합니다. 공개 카탈로그 보이스는 삭제할 수 없으며 `403`을 반환합니다. 다른 워크스페이스의 보이스와 존재하지 않는 보이스는 동일하게 `404`를 반환합니다.
- [스키마 목록 조회](https://docs.tryvox.co/api-reference/v3/schemas/스키마-목록-조회.md): API와 MCP 클라이언트가 사용할 수 있는 public JSON Schema 목록을 조회합니다. 스키마 본문까지 받으려면 `include_schema=true`를 사용합니다.
- [스키마 조회](https://docs.tryvox.co/api-reference/v3/schemas/스키마-조회.md): namespace, schema type, 선택적 version으로 public JSON Schema 1건을 조회합니다. 설명·제목·예시를 제거한 가벼운 응답이 필요하면 `detail=minimal`을 사용합니다.
- [보유 전화번호 목록 조회](https://docs.tryvox.co/api-reference/v3/organization-telephone-numbers/보유-전화번호-목록-조회.md): 인증된 워크스페이스(`organization_id`)가 보유한 전화번호 목록을 조회합니다. 에이전트 매핑, SIP 설정, 해지 요청에는 각 항목의 `id`를 사용합니다.
- [보유 전화번호 상세 조회](https://docs.tryvox.co/api-reference/v3/organization-telephone-numbers/보유-전화번호-상세-조회.md): 워크스페이스(`organization_id`)가 보유한 전화번호 1건을 API `id`로 조회합니다.
- [보유 전화번호 수정](https://docs.tryvox.co/api-reference/v3/organization-telephone-numbers/보유-전화번호-수정.md): 워크스페이스(`organization_id`)가 보유한 전화번호의 수정 가능한 메타데이터를 변경합니다. 에이전트 매핑과 SIP 설정은 별도 endpoint에서 관리합니다.
- [보유 전화번호 에이전트 설정](https://docs.tryvox.co/api-reference/v3/organization-telephone-numbers/보유-전화번호-에이전트-설정.md): 전화번호의 인바운드/아웃바운드 에이전트 매핑을 설정하거나 해제합니다.
- [보유 전화번호 SIP 설정](https://docs.tryvox.co/api-reference/v3/organization-telephone-numbers/보유-전화번호-sip-설정.md): custom 전화번호의 SIP trunk 설정을 수정합니다.
- [보유 전화번호 해지](https://docs.tryvox.co/api-reference/v3/organization-telephone-numbers/보유-전화번호-해지.md): 워크스페이스(`organization_id`)가 보유한 전화번호를 해지 요청하거나 만료 처리합니다.
- [보유 전화번호 해지 취소](https://docs.tryvox.co/api-reference/v3/organization-telephone-numbers/보유-전화번호-해지-취소.md): 워크스페이스(`organization_id`)가 보유한 vox.ai 번호의 해지 예약을 취소합니다.
- [보유 전화번호 통신서비스 이용증명원 발급 요청](https://docs.tryvox.co/api-reference/v3/organization-telephone-numbers/보유-전화번호-통신서비스-이용증명원-발급-요청.md): 워크스페이스(`organization_id`)가 보유한 전화번호의 통신서비스 이용증명원 발급 요청을 생성합니다. 사용자를 같은 탭에서 `verification_url`로 이동시켜 본인인증을 완료하도록 하세요. URL은 30분간 유효합니다. 발급이 끝나면 `GET /v3/files/{file_key}/content`로 PDF를 내려받습니다. 발급 전에는 해당 엔드포인트가 404를 반환합니다.
- [전화번호 자원 목록 조회](https://docs.tryvox.co/api-reference/v3/telephone-numbers/전화번호-자원-목록-조회.md): 워크스페이스(`organization_id`)가 구매할 수 있는 vox.ai 제공 전화번호 목록을 조회합니다. 구매 요청의 `telephone_line_id`에는 응답의 `id`를 사용합니다.
- [전화번호 구매](https://docs.tryvox.co/api-reference/v3/telephone-numbers/전화번호-구매.md): 인증된 워크스페이스(`organization_id`)에서 사용할 vox.ai 전화번호를 구매합니다.
- [SIP 연동](https://docs.tryvox.co/api-reference/v3/telephone-numbers/sip-연동.md): vox.ai 외부에서 보유한 custom SIP 전화번호를 등록합니다. 고객이 관리하는 SIP trunk로 라우팅할 번호에 사용합니다.
- [발신표기번호 등록 신청](https://docs.tryvox.co/api-reference/v3/telephone-presentation-numbers/발신표기번호-등록-신청.md): 인증된 워크스페이스(`organization_id`)의 발신번호 표시 등록을 요청합니다. 증빙 서류는 multipart/form-data로 보내세요. pending 상태로 생성되며 심사를 거쳐야 발신번호로 사용할 수 있습니다. rejected 상태의 번호를 재신청하면 새 항목을 만들지 않고 기존 등록에 새 서류를 반영해 pending으로 되돌립니다.
- [발신표기번호 목록 조회](https://docs.tryvox.co/api-reference/v3/telephone-presentation-numbers/발신표기번호-목록-조회.md): 인증된 워크스페이스(`organization_id`)가 수동 등록한 발신표기번호 목록을 조회합니다. 삭제하거나 발신표기번호 부가서비스에 연결할 때 각 항목의 `id`를 사용합니다.
- [발신표기번호 삭제](https://docs.tryvox.co/api-reference/v3/telephone-presentation-numbers/발신표기번호-삭제.md): 인증된 워크스페이스(`organization_id`)의 발신표기번호 등록 레코드를 삭제합니다. 존재하지 않거나 접근할 수 없는 ID는 찾을 수 없는 것으로 처리됩니다.
- [차단 번호 생성](https://docs.tryvox.co/api-reference/v3/blocked-numbers/차단-번호-생성.md): 인증된 워크스페이스(`organization_id`)에 차단 번호 규칙을 생성합니다. 규칙을 특정 번호에서만 적용하려면 `specific` 적용 범위에 적용 번호(`specific_numbers`)를 함께 지정합니다.
- [차단 번호 일괄 생성](https://docs.tryvox.co/api-reference/v3/blocked-numbers/차단-번호-일괄-생성.md): 한 요청으로 차단 번호 규칙을 최대 500건까지 생성합니다. 각 번호는 독립적으로 처리되며, 실패 항목은 성공 항목을 되돌리지 않고 `results`에 보고됩니다. 중복 규칙은 `skipped`로 반환되며, 기존 규칙 교체는 지원하지 않습니다.
- [차단 번호 목록 조회](https://docs.tryvox.co/api-reference/v3/blocked-numbers/차단-번호-목록-조회.md): 인증된 워크스페이스(`organization_id`)의 차단 번호 규칙 목록을 조회합니다. 적용 범위, 차단 방향, 활성 상태, 검색 필터로 페이지 결과를 좁힐 수 있습니다.
- [차단 번호 수정](https://docs.tryvox.co/api-reference/v3/blocked-numbers/차단-번호-수정.md): 차단 번호 규칙의 일부 필드를 수정합니다. 생략한 필드는 유지되고, `memo`처럼 null을 허용하는 필드는 null로 보내 비울 수 있습니다.
- [차단 번호 삭제](https://docs.tryvox.co/api-reference/v3/blocked-numbers/차단-번호-삭제.md): 인증된 워크스페이스(`organization_id`)의 차단 번호 규칙을 삭제합니다.
- [대량 발신 생성](https://docs.tryvox.co/api-reference/v3/campaigns/대량-발신-생성.md): 하나의 에이전트와 발신번호로 여러 수신자에게 전화를 거는 대량 발신(`campaign`)을 생성합니다.
- [대량 발신 목록 조회](https://docs.tryvox.co/api-reference/v3/campaigns/대량-발신-목록-조회.md): 인증된 워크스페이스(`organization_id`)의 대량 발신(`campaign`) 목록을 조회합니다. 상태, 에이전트, 생성 시각으로 필터링할 수 있습니다.
- [대량 발신 조회](https://docs.tryvox.co/api-reference/v3/campaigns/대량-발신-조회.md): 인증된 워크스페이스(`organization_id`)의 대량 발신(`campaign`) 1건을 조회합니다.
- [대량 발신 수정](https://docs.tryvox.co/api-reference/v3/campaigns/대량-발신-수정.md): 대량 발신(`campaign`) 이름과 통화 가능 시간대처럼 수정 가능한 설정을 변경합니다.
- [대량 발신 일시정지](https://docs.tryvox.co/api-reference/v3/campaigns/대량-발신-일시정지.md): task를 삭제하지 않고 진행 중이거나 예약된 대량 발신(`campaign`)을 일시정지합니다.
- [대량 발신 재개](https://docs.tryvox.co/api-reference/v3/campaigns/대량-발신-재개.md): 일시정지된 대량 발신(`campaign`)을 재개해 남은 task를 계속 진행합니다.
- [대량 발신 취소](https://docs.tryvox.co/api-reference/v3/campaigns/대량-발신-취소.md): 대량 발신(`campaign`)을 취소하고 아직 대기 중인 발신 task를 중단합니다.
- [시트 생성](https://docs.tryvox.co/api-reference/v3/sheets/시트-생성.md): 아웃바운드 시트와 이를 소유하는 프로젝트를 하나의 작업으로 생성합니다.
- [시트 목록 조회](https://docs.tryvox.co/api-reference/v3/sheets/시트-목록-조회.md): 행을 불러오지 않고 워크스페이스(`organization_id`)에 속한 아웃바운드 시트 목록을 조회합니다.
- [시트 조회](https://docs.tryvox.co/api-reference/v3/sheets/시트-조회.md): 원본 행을 포함해 워크스페이스(`organization_id`)에 속한 아웃바운드 시트 하나를 조회합니다.
- [위젯 생성](https://docs.tryvox.co/api-reference/v3/widgets/위젯-생성.md): `draft` 상태의 위젯을 생성합니다. `public_id`는 서버가 발급합니다. 본문의 `status`와 `published_*`는 무시됩니다.
- [위젯 목록 조회](https://docs.tryvox.co/api-reference/v3/widgets/위젯-목록-조회.md): 인증된 워크스페이스(`organization_id`)의 위젯 목록을 조회합니다. `status=archived`를 지정하지 않으면 `archived` 위젯은 제외됩니다. `status`를 반복하면 여러 상태를 함께 조회합니다.
- [위젯 조회](https://docs.tryvox.co/api-reference/v3/widgets/위젯-조회.md): 인증된 워크스페이스(`organization_id`)의 위젯 1건을 조회합니다. `archived` 위젯도 조회할 수 있습니다.
- [위젯 수정](https://docs.tryvox.co/api-reference/v3/widgets/위젯-수정.md): 인증된 워크스페이스(`organization_id`)의 위젯을 부분 수정합니다. 본문이 비어 있으면 400, `archived` 위젯은 409를 반환합니다. 본문의 `status`와 `public_id`는 무시됩니다. `branding`을 보내면 모양과 메시지 설정 전체를 교체합니다.
- [위젯 게시](https://docs.tryvox.co/api-reference/v3/widgets/위젯-게시.md): 현재 편집 내용을 새 버전으로 저장하고 인증된 워크스페이스(`organization_id`)의 위젯을 게시합니다. 다시 게시하면 항상 새 버전이 추가됩니다.
- [위젯 게시 해제](https://docs.tryvox.co/api-reference/v3/widgets/위젯-게시-해제.md): 인증된 워크스페이스(`organization_id`)의 위젯을 `status=draft`로 바꿔 게시를 해제합니다. 마지막 게시 버전(`published_version_id`)과 `published_at`은 유지됩니다. 게시되지 않은 위젯은 409를 반환합니다.
- [위젯 삭제](https://docs.tryvox.co/api-reference/v3/widgets/위젯-삭제.md): 인증된 워크스페이스(`organization_id`)의 위젯을 `status=archived`로 바꿉니다. 이미 `archived`인 위젯도 204를 반환합니다.
- [발신 SMS 목록 조회](https://docs.tryvox.co/api-reference/v3/sms/발신-sms-목록-조회.md): 인증된 조직의 발신 SMS를 조회합니다. 귀속된 통화나 Chat, 발신번호·수신번호, 전달 상태, 생성 시각으로 필터링할 수 있습니다.
- [SMS 단건 조회](https://docs.tryvox.co/api-reference/v3/sms/sms-단건-조회.md): ID로 단건 SMS 메시지의 상세 정보를 조회합니다.
- [수신 SMS 목록 조회](https://docs.tryvox.co/api-reference/v3/sms/수신-sms-목록-조회.md): 인증된 워크스페이스(`organization_id`)의 수신 SMS·MMS 메시지 목록을 조회합니다. 귀속 통화, 발신번호·수신번호, 수신 시각으로 필터링합니다.
- [파일 업로드](https://docs.tryvox.co/api-reference/v3/files/파일-업로드.md): MMS 이미지 첨부 파일을 `multipart/form-data`로 업로드하고 `file_key`를 받습니다. 받은 `file_key`는 SMS/MMS 발송 페이로드에서 사용합니다. 동일한 byte를 다시 업로드하면 같은 `file_key`가 반환됩니다.
- [파일 다운로드](https://docs.tryvox.co/api-reference/v3/files/파일-다운로드.md): 워크스페이스(`organization_id`)가 소유한 `file_key`의 저장된 파일 바이트를 다운로드합니다. `sms_received` 웹훅 페이로드나 대화 메시지 `attachments`에 담긴 수신 MMS 첨부, 발급된 통신서비스 이용증명원 PDF를 받을 때 사용합니다. `Authorization: Bearer <token>`을 보내세요. 응답 본문은 저장된 MIME 타입(`image/jpeg`, `image/png`, `image/gif`, `application/pdf`)으로 제공되는 원본 바이트입니다. `file_ke…
- [고객 생성](https://docs.tryvox.co/api-reference/v3/customers/고객-생성.md): 인증된 워크스페이스(`organization_id`)에 고객을 생성합니다. 식별자가 하나 이상 필요합니다. 식별자 값은 유형에 맞게 정규화됩니다. 값이 올바르지 않으면 400 `VALIDATION_ERROR`를 반환합니다. 같은 `(type, value)`를 이미 사용 중이면 409 `CUSTOMER_IDENTIFIER_EXISTS`를 반환하며 고객을 생성하지 않습니다. 중복 고객은 생성 후 병합할 수 있습니다.
- [고객 목록 조회](https://docs.tryvox.co/api-reference/v3/customers/고객-목록-조회.md): 인증된 워크스페이스(`organization_id`)의 고객 목록을 생성 시각 내림차순으로 조회합니다. `q`는 고객 이름과 식별자 값에서 대소문자 구분 없이 일부 일치 항목을 찾습니다. 메모는 검색하지 않습니다. 목록에는 `metadata`와 `interaction_summary`가 없습니다. 전체 프로필과 인터랙션 요약은 고객 단건 조회에서 확인합니다.
- [고객 조회](https://docs.tryvox.co/api-reference/v3/customers/고객-조회.md): 인증된 워크스페이스(`organization_id`)의 고객 한 명을 조회합니다. 프로필, 식별자, 인터랙션 요약과 에이전트별 활성 메모리를 반환합니다. 메모리는 고객 단건 조회에만 포함됩니다. 목록, 식별자 검색, 생성, 수정, 병합 응답에는 포함되지 않습니다. 다른 워크스페이스의 고객 ID는 404 `CUSTOMER_NOT_FOUND`로 처리합니다.
- [식별자로 고객 조회](https://docs.tryvox.co/api-reference/v3/customers/식별자로-고객-조회.md): 인증된 워크스페이스(`organization_id`)에서 식별자로 고객 한 명을 찾습니다. 전화번호는 한국 표준 형식으로 정규화하고, 이메일은 소문자로 바꾸며, 그 밖의 식별자 값은 앞뒤 공백을 제거한 뒤 검색합니다. `identifier_type`을 지정하면 해당 유형만 검색합니다. 생략하면 `phone`, `email`, `external_id` 순서로 검색해 처음 일치한 고객을 반환합니다. 일치하는 고객이 없으면 404 `CUSTOMER_NOT_FOUND`를 반환합니다.
- [식별자로 고객 조회 또는 생성](https://docs.tryvox.co/api-reference/v3/customers/식별자로-고객-조회-또는-생성.md): 인증된 워크스페이스(`organization_id`)에서 전화번호, 이메일, 외부 ID 중 하나 이상으로 고객 한 명을 찾거나 만듭니다. 식별자는 인터랙션 귀속과 같은 표준 정규화와 우선순위를 사용합니다. 우선순위는 `external_id`, 전화번호, 이메일 순입니다. 같은 워크스페이스 범위 식별자에 대해 원자적이고 멱등하게 동작합니다.
- [고객 수정](https://docs.tryvox.co/api-reference/v3/customers/고객-수정.md): 인증된 워크스페이스(`organization_id`)의 고객 정보를 수정합니다. 생략한 필드는 유지합니다. `metadata`는 최상위 키를 추가하거나 교체하며 기존 키를 삭제하지 않습니다. `identifiers`에 담은 식별자는 고객에게 추가됩니다. 기존 식별자 값은 수정하거나 삭제하지 않습니다. 식별자 하나라도 사용 중이면 전체 요청이 409 `CUSTOMER_IDENTIFIER_EXISTS`로 실패합니다. 다른 워크스페이스의 고객 ID는 404 `CUSTOMER_NOT_FOUND`로 처리합니다.
- [고객 삭제](https://docs.tryvox.co/api-reference/v3/customers/고객-삭제.md): 인증된 워크스페이스의 고객을 영구 삭제합니다. 식별자, 상담사 메모(답글·반응 포함), 상태·담당자 이력과 메모리도 함께 삭제합니다. 연결된 통화와 채팅의 `customer_id`는 null로 바꾸고 대화 기록은 유지합니다. 다른 워크스페이스의 ID는 404 `CUSTOMER_NOT_FOUND`를 반환합니다.
- [중복 고객 병합](https://docs.tryvox.co/api-reference/v3/customers/중복-고객-병합.md): 인증된 워크스페이스의 중복 고객을 대표 고객으로 병합합니다. 중복 고객의 식별자, 통화, 상담사 통화, 채팅, 발신·수신 SMS, 메모리, 대기 중인 메모리 이벤트, 상담사 메모(답글·반응 포함), 상태·담당자 이력을 대표 고객으로 옮기고 중복 고객을 영구 삭제합니다. 충돌 시 대표 고객의 프로필을 우선하지만, 이름·메모가 비어 있거나 속성 값이 없으면 중복 고객의 값으로 채웁니다. 병합 후 메모리 저장 한도를 다시 적용합니다. `main_customer_id`와 `duplicate_customer_id`는 달라야 하며, 같으면 4…
- [고객 식별자 삭제](https://docs.tryvox.co/api-reference/v3/customers/고객-식별자-삭제.md): 인증된 워크스페이스(`organization_id`)의 고객에서 식별자 하나를 삭제합니다. 마지막 식별자는 삭제할 수 없으며 409 `CUSTOMER_LAST_IDENTIFIER`를 반환합니다. 식별자가 없거나 다른 워크스페이스에 속하면 404 `CUSTOMER_NOT_FOUND`를 반환합니다.
- [고객 속성 정의 생성](https://docs.tryvox.co/api-reference/v3/customer-attribute-definitions/고객-속성-정의-생성.md): 인증된 워크스페이스(`organization_id`)에 고객 속성 정의를 생성합니다. 속성 키는 워크스페이스 안에서 고유해야 합니다.
- [고객 속성 정의 목록 조회](https://docs.tryvox.co/api-reference/v3/customer-attribute-definitions/고객-속성-정의-목록-조회.md): 인증된 워크스페이스(`organization_id`)의 고객 속성 정의 목록을 조회합니다.
- [고객 속성 정의 조회](https://docs.tryvox.co/api-reference/v3/customer-attribute-definitions/고객-속성-정의-조회.md): 인증된 워크스페이스(`organization_id`)의 고객 속성 정의 하나를 조회합니다.
- [고객 속성 정의 수정](https://docs.tryvox.co/api-reference/v3/customer-attribute-definitions/고객-속성-정의-수정.md): 인증된 워크스페이스(`organization_id`)의 고객 속성 정의를 수정합니다. 생략한 필드는 유지합니다.
- [고객 속성 정의 삭제](https://docs.tryvox.co/api-reference/v3/customer-attribute-definitions/고객-속성-정의-삭제.md): 고객 속성 정의를 영구 삭제합니다. 고객의 `attributes`에 저장된 기존 값은 유지되지만 더 이상 속성 정의와 연결되지 않습니다.
- [메모리 생성](https://docs.tryvox.co/api-reference/v3/memories/메모리-생성.md): 인증된 워크스페이스(`organization_id`)에서 고객과 에이전트 쌍에 메모리 fact 하나를 직접 추가합니다. 통화와 채팅이 끝난 뒤 실행되는 자동 추출은 tier를 스스로 정하지만, 이 직접 생성 요청에서는 요청자가 `tier`를 선택합니다. ID와 상태는 서버가 부여합니다. tier마다 보관 한도가 있으며, 한도를 넘으면 오래된 fact부터 만료합니다. 저장 전에 앞뒤 공백을 제거하고, 연속된 공백을 하나로 합치며, 문장 부호를 제거해 중복을 비교합니다. 같은 고객, 에이전트, tier에 정규화 결과가 같은 활성 fac…
- [메모리 목록 조회](https://docs.tryvox.co/api-reference/v3/memories/메모리-목록-조회.md): 인증된 워크스페이스(`organization_id`)의 활성 메모리를 고객과 에이전트 쌍으로 묶어 조회합니다. `customer_id`와 `agent_id` 중 하나 이상을 전달해야 합니다. 둘 다 생략하면 400 `VALIDATION_ERROR`를 반환합니다. 각 그룹은 활성 fact를 `static`과 `dynamic` tier로 나눕니다. 각 tier는 `created_at` 내림차순입니다. 그룹은 페이지 사이에서 나뉘지 않으며 `total_count`는 그룹 수입니다. 에이전트가 없으면 404 `AGENT_NOT_FOUND`…
- [메모리 조회](https://docs.tryvox.co/api-reference/v3/memories/메모리-조회.md): 인증된 워크스페이스(`organization_id`)의 활성 메모리 fact 하나를 출처와 함께 조회합니다. 만료되었거나 없거나 다른 워크스페이스에 속한 ID는 404 `MEMORY_NOT_FOUND`로 처리합니다. `agent_id`는 공개 UUID입니다.
- [메모리 삭제](https://docs.tryvox.co/api-reference/v3/memories/메모리-삭제.md): 인증된 워크스페이스(`organization_id`)의 메모리 fact 하나를 만료 처리합니다. 데이터는 유지되며 상태가 `expired`로 바뀝니다. 워크스페이스 API 키로 요청하면 `expire_reason`은 `user_manual`, 관리자가 요청하면 `admin_manual`입니다. 이미 만료되었거나 없거나 다른 워크스페이스에 속한 ID는 404 `MEMORY_NOT_FOUND`를 반환합니다. 같은 고객과 에이전트 쌍의 메모리가 갱신되는 동안에는 최대 5초 기다린 뒤 409 `MEMORY_LOCKED`를 반환합니다.
- [메모리 일괄 만료](https://docs.tryvox.co/api-reference/v3/memories/메모리-일괄-만료.md): 인증된 워크스페이스(`organization_id`)의 활성 메모리를 조건에 따라 일괄 만료합니다. `customer_id`와 `agent_id` 중 하나 이상을 전달해야 하며, 둘 다 생략하면 400 `VALIDATION_ERROR`를 반환합니다. `agent_id`만 보내면 해당 에이전트의 모든 고객 메모리를 만료합니다. `customer_id`만 보내면 해당 고객의 모든 에이전트 메모리를 만료합니다. 대상이 없어도 204를 반환하는 멱등 동작이며, 이후에도 새 fact를 추가할 수 있습니다. 에이전트가 없으면 404 `AGEN…
- [알림 규칙 생성](https://docs.tryvox.co/api-reference/v3/alerts/알림-규칙-생성.md): 워크스페이스(`organization_id`) 단위 모니터링을 위한 알림 규칙을 생성합니다. 규칙에는 메트릭 조건, 알림 채널, 활성 스케줄, 활성화 상태가 포함됩니다.
- [알림 규칙 목록 조회](https://docs.tryvox.co/api-reference/v3/alerts/알림-규칙-목록-조회.md): 인증된 워크스페이스(`organization_id`)의 알림 규칙 목록을 조회합니다. 현재 동작 상태는 각 항목의 `status`, `enabled`, `paused_until` 필드를 확인합니다.
- [알림 규칙 상세 조회](https://docs.tryvox.co/api-reference/v3/alerts/알림-규칙-상세-조회.md): 알림 규칙 1건을 조회합니다. 조건, 채널, 스케줄, 현재 상태를 함께 반환합니다.
- [알림 규칙 수정](https://docs.tryvox.co/api-reference/v3/alerts/알림-규칙-수정.md): 알림 규칙의 수정 가능한 메타데이터를 변경합니다. 현재는 `name`과 `description`을 수정할 수 있습니다.
- [알림 규칙 채널 수정](https://docs.tryvox.co/api-reference/v3/alerts/알림-규칙-채널-수정.md): 알림 규칙에서 사용할 알림 채널을 전체 교체합니다.
- [알림 규칙 조건 수정](https://docs.tryvox.co/api-reference/v3/alerts/알림-규칙-조건-수정.md): 알림 조건의 임계값, 비교 방식, 시간 창, label을 수정합니다.
- [알림 규칙 스케줄 수정](https://docs.tryvox.co/api-reference/v3/alerts/알림-규칙-스케줄-수정.md): 알림 규칙이 알림을 보낼 활성 시간대를 수정합니다.
- [알림 규칙 활성화](https://docs.tryvox.co/api-reference/v3/alerts/알림-규칙-활성화.md): 조건에 맞는 incident가 알림을 보낼 수 있도록 알림 규칙을 활성화합니다.
- [알림 규칙 비활성화](https://docs.tryvox.co/api-reference/v3/alerts/알림-규칙-비활성화.md): 설정이나 incident 이력을 삭제하지 않고 알림 규칙을 비활성화합니다.
- [알림 규칙 일시정지](https://docs.tryvox.co/api-reference/v3/alerts/알림-규칙-일시정지.md): 알림 규칙의 알림 전송을 일시정지합니다. 재개 시각을 함께 지정할 수 있습니다.
- [알림 규칙 일시정지 해제](https://docs.tryvox.co/api-reference/v3/alerts/알림-규칙-일시정지-해제.md): 알림 규칙의 일시정지 상태를 해제하고 다시 알림을 보낼 수 있게 합니다.
- [알림 규칙 삭제](https://docs.tryvox.co/api-reference/v3/alerts/알림-규칙-삭제.md): 알림 규칙을 삭제합니다. 이 규칙에 기록된 인시던트와 알림 이력은 유지됩니다.
- [알림 규칙 테스트 알림 발송](https://docs.tryvox.co/api-reference/v3/alerts/알림-규칙-테스트-알림-발송.md): incident를 만들지 않고 규칙에 설정된 채널로 테스트 알림을 보냅니다.
- [알림 규칙 인시던트 목록 조회](https://docs.tryvox.co/api-reference/v3/alerts/알림-규칙-인시던트-목록-조회.md): 특정 알림 규칙에서 발생한 incident 목록을 조회합니다. incident 상태로 필터링할 수 있습니다.
- [인시던트 목록 조회](https://docs.tryvox.co/api-reference/v3/incidents/인시던트-목록-조회.md): 인증된 워크스페이스(`organization_id`)의 모든 알림 규칙에서 발생한 incident 목록을 조회합니다.
- [하위 워크스페이스 생성](https://docs.tryvox.co/api-reference/v3/organizations/하위-워크스페이스-생성.md): 인증된 워크스페이스 아래에 하위 워크스페이스를 생성합니다. JWT 호출자는 상위 워크스페이스의 소유자 또는 관리자여야 합니다. 선택 설정인 `webhook_url`, `webhook_event_subscriptions`, `billing_invoice_recipient_emails`는 전달하면 적용하고 생략하면 기본값을 사용합니다. 청구서 수신 이메일을 지정하지 않으면 상위 워크스페이스의 값을 상속합니다.
- [워크스페이스 목록 조회](https://docs.tryvox.co/api-reference/v3/organizations/워크스페이스-목록-조회.md): 인증된 상위 워크스페이스(`organization_id`)와 그 직속 하위 워크스페이스를 한 목록으로 조회합니다. `is_main`으로 상위·하위 워크스페이스를 구분하며, 상위 워크스페이스 자신도 포함됩니다. 상위 워크스페이스의 API 키로만 호출할 수 있고, 하위 워크스페이스 키로 요청하면 권한이 없습니다. 구독 정보는 포함되지 않으며 단건 조회에서 확인합니다.
- [워크스페이스 조회](https://docs.tryvox.co/api-reference/v3/organizations/워크스페이스-조회.md): 워크스페이스(`organization_id`) 1건을 조회합니다. 본인 워크스페이스와 직속 하위 워크스페이스를 조회할 수 있습니다. 상위 워크스페이스는 구독 정보가 `subscription`에 포함되고, 하위 워크스페이스는 `subscription`이 `null`입니다. 접근 권한이 없는 워크스페이스는 찾을 수 없는 것으로 처리되며, 하위 워크스페이스가 상위 워크스페이스를 조회하면 권한이 없습니다.
- [워크스페이스 수정](https://docs.tryvox.co/api-reference/v3/organizations/워크스페이스-수정.md): 본인 워크스페이스 또는 바로 아래 하위 워크스페이스(`organization_id`)의 지정한 필드를 수정합니다. 생략한 필드는 유지하며, 계층과 결제 설정은 이 API로 변경할 수 없습니다. Supabase JWT 호출자가 이름과 청구서 수신자를 변경하려면 대상 워크스페이스의 소유자 또는 관리자여야 합니다. 웹훅 필드는 모든 멤버가 변경할 수 있습니다. 그 외 ID는 404, 하위 워크스페이스가 상위 워크스페이스를 수정하면 403을 반환합니다.
- [하위 워크스페이스 삭제](https://docs.tryvox.co/api-reference/v3/organizations/하위-워크스페이스-삭제.md): 하위 워크스페이스(`organization_id`)를 삭제합니다. JWT 호출자는 상위 워크스페이스의 소유자 또는 관리자여야 하며, 대상은 바로 아래 하위 워크스페이스여야 합니다. 전화번호와 부가서비스는 즉시 해지하고 대기 중인 대량 발신은 취소합니다. 남은 청구서가 있어도 삭제할 수 있습니다. 열린 청구서는 지연 도착한 통화 상세 기록(CDR)·SMS 요금 반영을 위해 유지하고 정기 월 마감 작업에서 마감합니다. 마감되거나 발행된 청구서는 다음 청구 주기에도 유지됩니다. 삭제에 성공하면 해당 하위 워크스페이스의 모든 API 키를…
- [API 키 발급](https://docs.tryvox.co/api-reference/v3/organizations/api-키-발급.md): 하위 워크스페이스(`organization_id`)의 API 키를 발급합니다. 하위 워크스페이스의 키로 본인 워크스페이스에, 상위 메인 워크스페이스의 키로 바로 아래 하위 워크스페이스에 접근할 수 있습니다. 메인 워크스페이스의 자체 키는 이 API로 관리할 수 없으며 403을 반환합니다. 평문 `api_key`는 이 응답에서 한 번만 반환하므로 즉시 저장해야 합니다. `key_name`은 필수이며, 키 폐기 시 `key_name`과 `secret_key_suffix` 조합으로 식별합니다. 내부 키 ID는 노출하지 않습니다. 하위 워…
- [API 키 목록 조회](https://docs.tryvox.co/api-reference/v3/organizations/api-키-목록-조회.md): 하위 워크스페이스(`organization_id`)의 마스킹된 API 키 목록을 조회합니다. 각 항목에는 `key_name`, `secret_key_suffix`, `created_at`, `last_used_at`이 포함됩니다. 하위 워크스페이스의 키로 본인 워크스페이스를 조회하고, 상위 워크스페이스의 키로 직속 하위 워크스페이스를 조회할 수 있습니다. 상위 워크스페이스의 키로 자기 워크스페이스의 키를 관리할 수 없으며 403을 반환합니다. 평문 키와 해시된 키는 모두 노출하지 않습니다.
- [API 키 폐기](https://docs.tryvox.co/api-reference/v3/organizations/api-키-폐기.md): 하위 워크스페이스(`organization_id`)의 API 키를 폐기합니다. JWT 호출자는 대상 워크스페이스의 소유자 또는 관리자여야 합니다. 필수 쿼리인 `key_name`과 `secret_key_suffix` 조합으로 키를 식별하며, 하위 워크스페이스 자체 키 또는 상위 메인 워크스페이스의 키로 접근할 수 있습니다. 메인 워크스페이스의 자체 키는 이 API로 관리할 수 없으며 403을 반환합니다. 내부 키 ID는 노출하지 않습니다. 다른 워크스페이스 소유의 키를 포함해 일치하는 키가 없으면 404 `API_KEY_NOT_FO…
- [워크스페이스 인증 신청](https://docs.tryvox.co/api-reference/v3/organizations/워크스페이스-인증-신청.md): 워크스페이스(`organization_id`) 인증을 `multipart/form-data`로 제출합니다. 사업자 유형(`sole_proprietor`/`corporation`)은 `verification_case`와 `business_registration` 서류가 필수입니다. 직원 신청은 `employment_certificate`도 필요합니다. `personal`은 서류가 없으며 `verification_case`를 지정하면 안 됩니다. 신분증은 수집하지 않으며, 기존 `identity_document` 파트를 보내면 400…
- [워크스페이스 인증 상태 조회](https://docs.tryvox.co/api-reference/v3/organizations/워크스페이스-인증-상태-조회.md): 워크스페이스(`organization_id`)의 인증 상태를 조회합니다. 본인 워크스페이스와 직속 하위 워크스페이스를 조회할 수 있습니다. `latest`는 가장 최근 인증 기록이며(신청 이력이 없으면 `null`), 상태는 `requested`(자동 확인 중), `pending`(수동 심사 중), `approved`(승인), `rejected`(반려, 사유는 `rejection_reason`), `revoked`(철회)입니다. `currently_verified`와 `current_grade`는 현재 유효한 승인을 나타내며, 재인…
- [네이버톡톡 연동 생성](https://docs.tryvox.co/api-reference/v3/navertalk/네이버톡톡-연동-생성.md): 중지 상태의 네이버톡톡 연동과 15분 동안 유효한 확인 코드를 생성합니다. API 서버 주소에 `webhook_path`를 붙인 URL을 네이버 파트너센터에 등록한 뒤, 고객용 톡톡 대화창에서 확인 코드를 보내야 합니다. 토큰을 저장하는 것만으로는 연동 확인이나 활성화가 끝나지 않습니다.
- [네이버톡톡 연동 목록 조회](https://docs.tryvox.co/api-reference/v3/navertalk/네이버톡톡-연동-목록-조회.md): 워크스페이스(`organization_id`)의 네이버톡톡 연동 목록을 조회합니다. 해제된 연동도 포함하며, 토큰과 연동 확인 코드는 반환하지 않습니다.
- [네이버톡톡 연동 조회](https://docs.tryvox.co/api-reference/v3/navertalk/네이버톡톡-연동-조회.md): 저장된 연동 설정과 연동 확인 결과를 조회합니다. 이 요청은 네이버와의 현재 연결 상태를 점검하지 않습니다.
- [네이버톡톡 연동 수정](https://docs.tryvox.co/api-reference/v3/navertalk/네이버톡톡-연동-수정.md): 중지된 연동의 설정을 수정합니다. 토큰이나 파트너 ID를 바꾸면 기존 연동 확인이 무효가 됩니다. 설정을 바꾸면 이전 버전에서 대기하던 작업은 실행하지 않습니다. 에이전트 변경은 새로 만들어지는 채팅부터 적용됩니다.
- [네이버톡톡 확인 코드 재발급](https://docs.tryvox.co/api-reference/v3/navertalk/네이버톡톡-확인-코드-재발급.md): 중지된 연동에 15분 동안 유효한 새 확인 코드를 발급합니다. 이전 확인 코드와 연동 확인 결과는 모두 무효가 됩니다. 이 요청은 네이버로 메시지를 보내지 않습니다.
- [네이버톡톡 연동 활성화](https://docs.tryvox.co/api-reference/v3/navertalk/네이버톡톡-연동-활성화.md): 연동 확인을 마쳤고 활성 플랜과 유효한 채팅 에이전트가 있는 연동을 활성화합니다. 이전 버전에서 받은 입력은 다시 처리하지 않습니다. 이미 활성인 연동에 다시 요청해도 상태는 바뀌지 않습니다.
- [네이버톡톡 연동 중지](https://docs.tryvox.co/api-reference/v3/navertalk/네이버톡톡-연동-중지.md): 새 AI 처리를 멈추고 대기 중인 발신을 막습니다. 이미 네이버로 보내기 시작한 요청은 취소할 수 없습니다. 중지된 연동에 다시 요청해도 상태는 바뀌지 않습니다.
- [네이버톡톡 연동 해제](https://docs.tryvox.co/api-reference/v3/navertalk/네이버톡톡-연동-해제.md): 연동을 중지하고 저장한 토큰을 삭제합니다. 대화 기록과 중복 발신 방지 기록은 보존 정책에 따라 유지됩니다. 해제한 연동은 다시 활성화할 수 없으며, 다시 연결하려면 새 연동을 생성해야 합니다. 네이버 파트너센터의 웹훅 URL은 따로 삭제해야 합니다.
- [네이버톡톡 응대권 조회](https://docs.tryvox.co/api-reference/v3/chats/네이버톡톡-응대권-조회.md): 저장된 네이버 응대권과 마지막 전환 요청 결과를 조회합니다. 이 요청은 네이버에 상태를 묻지 않으며, 전환 요청을 만들거나 재시도하지도 않습니다. 응대권이 `unknown`이면 AI가 답하지 않습니다. 대시보드 사용자는 연동이 활성이고 대화가 진행 중이며 스팸이 아닐 때 복구를 직접 요청할 수 있습니다.
- [네이버톡톡 응대권 전환](https://docs.tryvox.co/api-reference/v3/chats/네이버톡톡-응대권-전환.md): 네이버 응대권 전환을 요청하고 저장된 처리 결과를 반환합니다. API 키를 쓰는 에이전트 도구는 `X-Vox-Chat-Turn-Id`와 도구마다 고정한 `Idempotency-Key`를 지정해 `external`로 전환할 수 있습니다. AI 복구(`target=ai`)에는 대시보드 로그인 인증(Supabase JWT)이나 내부 관리자 인증이 필요합니다. 결과가 `unknown`이면 자동으로 다시 보내지 않으며, 같은 키로 다시 요청하면 기존 결과를 돌려줍니다.
- [2026년 9월](https://docs.tryvox.co/changelog/2026/09.md)
- [2026년 8월](https://docs.tryvox.co/changelog/2026/08.md)
- [2026년 7월](https://docs.tryvox.co/changelog/2026/07.md)
- [2026년 6월](https://docs.tryvox.co/changelog/2026/06.md)
- [2026년 5월](https://docs.tryvox.co/changelog/2026/05.md)
- [2026년 4월](https://docs.tryvox.co/changelog/2026/04.md)
- [2026년 3월](https://docs.tryvox.co/changelog/2026/03.md)
- [2026년 2월](https://docs.tryvox.co/changelog/2026/02.md)
- [2026년 1월](https://docs.tryvox.co/changelog/2026/01.md)
- [2025년 12월](https://docs.tryvox.co/changelog/2025/12.md)
- [2025년 11월](https://docs.tryvox.co/changelog/2025/11.md)
- [2025년 10월](https://docs.tryvox.co/changelog/2025/10.md)
- [2025년 9월](https://docs.tryvox.co/changelog/2025/09.md)
- [2025년 8월](https://docs.tryvox.co/changelog/2025/08.md)
- [2025년 7월](https://docs.tryvox.co/changelog/2025/07.md)
- [2025년 6월](https://docs.tryvox.co/changelog/2025/06.md)
- [2025년 5월](https://docs.tryvox.co/changelog/2025/05.md)
- [2025년 4월](https://docs.tryvox.co/changelog/2025/04.md)
- [2025년 3월](https://docs.tryvox.co/changelog/2025/03.md)

## OpenAPI Specs

- [openapi.base](/api-reference/v3/openapi.base.json)
- [openapi](/api-reference/v3/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.