Open in
ThunderPhone 떠나기
에이전트를 오픈 파일로 내보내고, 코딩 에이전트 기술로 LiveKit Agents, Pipecat, Vapi 또는 Retell에서 다시 구축하며, 통화 기록과 녹음 파일을 다운로드합니다.
언제든지 ThunderPhone을 떠날 수 있습니다. 모든 에이전트는 무료로 오픈 파일이 담긴 zip으로 내보낼 수 있으며, 스킬을 사용하면 코딩 에이전트가 LiveKit Agents, Pipecat, Vapi 또는 Retell에서 이를 다시 구축할 수 있습니다. 이 페이지에서는 가져갈 수 있는 항목, 내보내는 방법, 그리고 다른 플랫폼에서 다시 설정해야 하는 항목을 설명합니다.
가져갈 수 있는 항목
| 항목 | 방법 |
|---|---|
| 에이전트: 지시사항, 도구, 전환 번호, 단계, 설정, 번호 라우팅 및 웹훅 | 에이전트당 zip 하나로 제공되는 에이전트 내보내기 |
| 에이전트의 지식 파일 | 에이전트 내보내기 내부 |
| 통화 기록 및 대화 내용 | 요청당 최대 1,000통까지 제공되는 통화 내보내기 |
| 녹음 파일 | 통화별로 요청당 녹음 파일 하나 |
| 자체 통신사에서 사용하는 전화번호 | 해당 번호는 통신사를 떠난 적이 없습니다. 전화번호를 참조하세요. |
에이전트 내보내기
Zeus에서
에이전트를 열고 설정으로 이동합니다(에이전트 편집기의 통화 처리). 하단의 내보내기, 복사 또는 삭제에서 내보내기를 선택합니다. ZIP 파일이 컴퓨터에 다운로드됩니다.
API 사용
curl 'https://api.thunderphone.com/v1/agents/12/export' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-o agent-12.zipZIP 파일은 요청할 때 생성됩니다. 에이전트를 읽을 수 있는 모든 사용자가
내보낼 수 있습니다. 지식, 번호 및 웹훅은 자격 증명으로 읽을 수 있는 경우에만
포함됩니다. OAuth 토큰에는 knowledge:read, numbers:read,
integrations:read 권한이 필요하며, 웹훅에는 관리자 또는 소유자 권한도
필요합니다. 제외된 항목은 manifest.json의 omitted 아래에 나열됩니다.
API는 분당 내보내기가 30회를 초과하면 429를 반환합니다.
| 쿼리 매개변수 | 설명 |
|---|---|
include_url_paths | true이면 도구의 엔드포인트와 같이 내보내기에 각 URL의 경로를 유지합니다. 기본적으로 모든 URL은 호스트까지만 남습니다. 어느 경우든 URL에서 사용자 이름, 비밀번호 및 쿼리 문자열은 제거됩니다 |
도구 엔드포인트가 필요하므로 다른 곳에서 에이전트를 다시 구축하려는 경우
include_url_paths=true를 사용합니다. 공유할 복사본에는 이 옵션을
사용하지 마세요.
ZIP 파일에 포함되는 내용
| 파일 | 내용 |
|---|---|
manifest.json | 형식(thunderphone.agent-export/v1), 포함된 항목, 그리고 제외된 항목과 그 이유를 명시하는 omitted 목록 |
agent.json | 자격 증명을 제거한 상태로 GET /v1/agents/{agent_id}가 반환하는 에이전트 |
prompt.md | 현재 적용 중인 지시사항 |
knowledge/index.json 및 그 옆의 파일 | 에이전트의 지식입니다. 각 문서는 원본 파일이 저장된 경우 해당 원본 파일이며, 그렇지 않은 경우 추출된 텍스트입니다 |
numbers.json | 고정된 버전 또는 변형을 포함하여 이 에이전트로 라우팅되는 수신 및 발신 번호 |
webhooks.json | 시크릿을 제외한 이 에이전트 범위의 웹훅 엔드포인트 |
README.md | 각 파일의 설명 |
25MB보다 큰 지식 파일은 제외되며, 전체 내보내기에서 100MB를 초과하는
항목도 제외됩니다. 각 항목은 다운로드하는 엔드포인트와 함께
manifest.json에 나열됩니다.
GET /v1/knowledge/documents/{document_id}/original.
절대 포함되지 않는 항목
- 자격 증명 값. 도구의 헤더는 이름만 나열됩니다. 헤더 값은 ThunderPhone에서 쓰기 전용입니다. 어떤 API 응답도 이를 반환하지 않으므로 내보내기에도 포함될 수 없습니다. 대상 환경에서 다시 입력해야 합니다. 이는 ThunderPhone이 자격 증명으로 저장하는 자격 증명에 적용됩니다. 지시사항과 지식 파일은 작성하거나 업로드한 그대로 복사되므로, 키를 프롬프트나 문서에 붙여 넣은 적이 있다면 ZIP 파일에 포함됩니다. 공유하기 전에 확인하세요.
- 통화 기록 및 녹음. 별도의 내보내기 기능이 있습니다. 통화 기록 및 녹음을 참조하세요.
- 버전 기록. 내보내기에는 현재 적용 중인 에이전트 상태가 포함됩니다. 이전
버전은 계속해서
GET /v1/agents/{agent_id}/versions에 나열됩니다. - 이 에이전트가 전달하는 다른 에이전트. 각 에이전트를 같은 방식으로 내보내세요.
다른 플랫폼으로 이전
migrate-off-thunderphone 스킬은 코딩 에이전트가 이전 과정을 진행하도록 안내합니다.
ThunderPhone 스킬을 설치합니다:
npx skills add thunderphone/skills그런 다음 코딩 에이전트에 ThunderPhone에서 에이전트를 이전하도록 요청하고 대상 플랫폼을 지정합니다: LiveKit Agents, Pipecat, Vapi 또는 Retell. 이 스킬은 내보내기를 다운로드하고, 각 자격 증명을 요청하며, 해당 대상의 매핑을 기반으로 에이전트를 재구성하고, 번호를 이전하기 전에 그곳에서 테스트합니다. 변환은 자체 키를 사용하여 코딩 에이전트에서 실행됩니다. ThunderPhone은 다른 플랫폼의 계정에 절대 기록하지 않습니다.
스킬이 매핑하는 파일로 이전되는 항목:
- 공유 지침과 단계를 포함한 지침.
- 도구: 동일한 엔드포인트, 메서드 및 매개변수 스키마. 각 도구의
request_format은 엔드포인트가 예상하는 본문 형식을 기록합니다. - 전달 번호 및 통화 종료와 키패드 설정.
- 지식 파일.
- 음성사서함, 무음 및 통화 길이 설정.
- 에이전트가 응답하고 발신 통화에 사용하는 번호.
다른 플랫폼에서 다시 설정해야 하는 항목:
- 음성, 언어 모델 및 음성 제공업체. 대상 플랫폼에서 선택합니다. 음성이나 통화 음질이 일치한다는 보장은 없습니다.
- 자격 증명. 도구 헤더 값과 웹훅 시크릿입니다.
- 전화 통신. 번호가 에이전트에 연결되는 방식은 플랫폼마다 다르게 설정합니다.
- 단계 및 핸드오프. 흐름 또는 핸드오프 기능이 있는 대상에서는 해당 위치에서 다시 구성합니다. 그 외의 경우 스킬이 단계를 지침에 통합하고 알려 줍니다.
- 동등한 기능이 없는 ThunderPhone 설정. 인텔리전스, 듣기 및 응답 속도 설정, 기본 제공 이메일 및 문자 메시지 도구, 통화 평가, 요약 및 결과 레이블은 다시 구성하지 않으면 이전되지 않습니다.
- 요청 서명. ThunderPhone은 전송하는 도구 요청과 웹훅에 서명합니다. 다른 플랫폼은 자체 방식으로 서명하므로, ThunderPhone 서명을 검증하는 엔드포인트에는 새 검증이 필요합니다.
- 테스트. 번호를 이전하기 전에 대상 플랫폼에서 재구성된 에이전트를 테스트합니다.
새 에이전트가 테스트를 통과할 때까지 ThunderPhone 에이전트를 그대로 둡니다. 되돌아갈 수 있는 방법입니다.
전화번호
새 에이전트가 테스트를 통과한 후 마지막으로 번호를 이전합니다.
- 자체 통신사에 있는 번호(VoIP 연결)는
해당 통신사에 그대로 유지됩니다. 통신사 콘솔에서 새 플랫폼을 가리키도록
설정합니다. 그런 다음 ThunderPhone에서 해당 번호의 해제를 선택하고
내 … 계정에서도 이 번호 취소를 선택하지 않은 상태로 둡니다. 번호는
ThunderPhone에서 연결 해제되고 통신사 계정에 유지됩니다. API를 통해서는
DELETE /v1/phone-numbers/{phone_number_id}?confirm=true로 해제하고release_at_provider를 전송하지 않습니다. - ThunderPhone이 제공한 번호. 유지하려는 번호를 해제하기 전에 지원팀에 문의합니다. ThunderPhone 번호의 해제는 영구적입니다. 번호는 풀로 반환되며 다른 고객에게 할당될 수 있습니다.
통화 기록 및 녹음
이 항목들은 에이전트 내보내기와 별개입니다.
- 통화.
GET /v1/calls/export는 요청당 최대 1,000개의 통화를 CSV(메타데이터) 또는 JSON(대화 내용 포함)으로 반환합니다.agent_id로 필터링하고start_date및end_date로 기록을 페이지 처리합니다. 반환된 통화보다 더 많은 통화가 일치하면X-Truncated응답 헤더는true입니다. - 녹음.
GET /v1/calls/{call_id}/audio는 한 통화의 녹음에 대한 단기 URL을 반환합니다. 대량 녹음 다운로드는 지원하지 않습니다.
curl 'https://api.thunderphone.com/v1/calls/export?export_format=json&agent_id=12&start_date=2026-10-01T00:00:00Z&end_date=2026-11-01T00:00:00Z' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-o calls-2026-10.json비용
없습니다. 에이전트 내보내기, 통화 내보내기 및 녹음 다운로드는 무료입니다. ThunderPhone은 구독료나 좌석당 요금이 없는 사용량 기반 요금제입니다. ThunderPhone 번호는 해지하면 과금이 중단됩니다.
떠난 후
약정 기간은 없습니다. 계정의 관리자 이메일 또는 다른 검증 가능한 채널에서 legal@thunderphone.com으로 서면 통지를 보내 계약을 종료할 수 있습니다. 결제 지연으로 서비스가 중단될 수 있지만, 그 자체로 계약이 종료되거나 고객 데이터가 삭제되지는 않습니다. 데이터에 대해 약관은 다음과 같이 명시합니다. "공식적인 종료 후 제공업체는 고객의 내보내기 권리, 백업 주기, 법적 보존 명령, 법적으로 요구되는 보존, DPA 및 체결된 BAA를 조건으로 60일 이내에 고객 데이터를 반환하거나 삭제합니다."
전체 내용은 서비스 약관의 서비스 기간; 중단; 종료에서 확인할 수 있습니다. 약관이 우선하며, 이는 요약입니다.