ThunderPhone 계정이 필요합니다.
가입은 무료이며 1분 이내에 완료됩니다. curl 명령보다 클릭을 선호하시나요?
대시보드 빠른 시작을 사용하면 코드를 작성하지 않고도
동일하게 첫 전화를 받을 수 있습니다.
1단계: API 키 가져오기
1
로그인
app.thunderphone.com을 엽니다.
2
키로 이동
대시보드에서 조직 → 키로 이동합니다.
3
키 생성
키 생성을 클릭하고 이름을 지정한 다음
sk_live_... 값을 복사합니다. 원본 키는 한 번만 표시되므로 즉시
시크릿 관리자에 저장합니다.sk_live_YOUR_API_KEY를 방금 복사한 값으로 바꿉니다.
키가 조직을 자동으로 식별하므로 URL에 조직 ID를 넣을 필요가 없습니다.
2단계: 에이전트 생성
에이전트는 AI가 대화를 처리하는 방식을 정의합니다. 여기에는 프롬프트, 음성, 제품 티어, 도구 및 위젯 사용 가능 여부가 포함됩니다.3단계: 전화번호 프로비저닝
이 호출은 ThunderPhone의 데모 풀에서 번호를 요청하고 새 에이전트를 수신 처리기로 할당합니다. (VoIP 제공업체에서 자체 번호를 가져오려면 VoIP 연결을 참조하세요.)status="provisioning" 상태로 시작하며 몇 초 내에
active로 전환됩니다. 브라우저를 닫을 때쯤이면 번호가 전화를
받을 준비를 마칩니다.
4단계(선택 사항): 웹훅 설정
실시간 이벤트(동적 통화 라우팅, 통화 후 처리)를 위해 웹훅 엔드포인트를 추가합니다. 필요한 이벤트만 구독하세요.secret이 포함됩니다. 이를 비밀 관리
도구에 복사하세요. 이 비밀을 사용하여 수신 요청의
X-ThunderPhone-Signature 헤더를 검증합니다(
웹훅 개요 참조).
5단계: 에이전트 테스트
방금 프로비저닝한 번호로 전화하세요. 에이전트가 전화를 받고 자신을 소개한 다음 프롬프트를 따릅니다. 통화가 끝난 후 통화 정보를 확인합니다.다음 단계
함수 도구 추가
대화 중 에이전트가 API를 호출하도록 설정합니다.
발신 전화 걸기
자체 코드에서 통화를 트리거합니다.
웹훅 처리
실시간으로 통화 이벤트에 대응합니다.
전체 API 레퍼런스
모든 공개 엔드포인트를 문서화했습니다.