소개
실제 전화 통화와 삽입 가능한 웹 위젯에서 프로덕션 음성 에이전트를 운영하기 위한 문서입니다. 빠른 시작 가이드, 가이드, 전체 ThunderPhone API 레퍼런스를 제공합니다.
ThunderPhone을 사용하면 실제 전화를 걸고 받으며 웹사이트에서 마이크 기반 대화를 지원하는 AI 음성 에이전트를 구축할 수 있습니다. 문서는 네 개의 탭으로 나뉩니다.
대시보드와 API를 위한 빠른 시작, 개념 및 사용 방법입니다. 처음이라면 여기서 시작하세요.
모든 엔드포인트, 요청 필드 및 응답 형식입니다.
임베드 가능한 웹 위젯 — React 컴포넌트, 헤드리스 훅 및 CDN 스크립트 태그입니다.
실시간 이벤트, 서명 및 전달 의미 체계입니다.
구축할 수 있는 기능
보유한 번호로 걸려 오는 전화를 프롬프트를 따르고, 도구를 사용하며, 필요할 때 사람에게 연결하는 AI 에이전트로 응답합니다.
코드에서 프로그래밍 방식으로 전화를 겁니다 — 설문조사, 후속 연락 또는 확인 흐름에 사용할 수 있습니다.
고객이 클릭하여 대화할 수 있도록 임베드 가능한 웹 위젯을 사이트에 추가합니다. 전화번호는 필요하지 않습니다.
배치에서 사전 정의된 시나리오를 에이전트로 실행하여 고객이 듣기 전에 회귀 문제가 감지되도록 합니다.
시작하는 두 가지 방법
대시보드에서 시작 (첫 에이전트에 권장) — 가입하면 대시보드에서 5단계 설정 마법사를 안내합니다. 에이전트 생성, 결제 설정, 전화번호 추가, 시뮬레이션 실행 및 통화 검토를 진행합니다. 대시보드 빠른 시작에서는 이 마법사를 단계별로 안내합니다.
터미널에서 시작 — API 빠른 시작에서는 동일한 첫 통화를 REST 호출 4번으로 수행합니다.
- 개념 훑어보기
개념 — 사용할 모든 객체와 각 객체가 대시보드에서 어디에 있는지를 보여 주는 안내입니다.
- 빠른 시작 실행
대시보드 빠른 시작 또는 API 빠른 시작 — AI 에이전트로 첫 통화를 수행합니다.
- 가이드 선택
가이드 찾아보기
에이전트를 구축하고, 잔액을 충전하고, 번호를 추가하고, 통화를 시뮬레이션하고 검토합니다.
OAuth 앱, 사용자 지정 API, MCP 서버 및 VoIP 공급자입니다.
보고서, 관측 가능성, 실험, 이슈 및 알림입니다.
초대 및 역할, API 키, 보안 및 SSO입니다.
기본 URL
https://api.thunderphone.com/v1
인증에는 sk_live_ 조직 API 키를 사용하는 표준 OAuth 2.0 Bearer 방식을 사용합니다. 키는 대상 조직을 자동으로 식별하므로 URL 경로에 조직 ID가 없습니다. 자세한 내용은 인증을 참조하세요.