Open in
조직 설정 참조
ThunderPhone 조직의 프로필, 대시보드 언어, 구성원, 발신 확인, 차단된 발신자, 웹훅, SSO, API 키, 알림, 청구, 지출 한도 및 기록을 관리합니다.
활성 조직과 내 계정을 관리하려면 조직 설정(/dashboard/organization)을 엽니다. 설정은 6개의 탭으로 나뉘며, 역할에 따라 변경할 수 있는 통제 항목이 결정됩니다.
내 계정
내 계정 탭에는 전체 조직이 아닌 로그인한 사용자를 위한 설정이 있습니다.
- 이름, 성, 이메일, 아바타 URL
- 대시보드 표시 언어
- macOS 데스크톱 앱 다운로드
- 패스키 추가, 확인, 목록 조회 및 제거
- 쿠키 환경설정
- 현재 기기에서 로그아웃
조직 SSO를 통해 로그인하면 ID 공급자가 이메일을 관리하므로 여기에서는 읽기 전용입니다. 자세한 패스키 및 프로필 워크플로는 계정 및 보안을 참조하세요.
일반
발신 통화 규정 준수
요건이 적용되는 조직에서는 에이전트가 발신 통화를 걸기 전에 소유자 또는 관리자가 일회성 발신 통화 확인을 검토하고 기록해야 합니다. 멤버는 조치가 필요하다는 사실은 확인할 수 있지만 제출할 수는 없습니다. 발신 통화 법률을 참조하세요.
보고
시간대, 주간 영업 시간 및 조직에서 사용하는 테스트 번호를 설정합니다. 영업 시간은 홈의 통화 보고서 수치, 각 에이전트의 통화 탭, 클라이언트 포털 및 통화 기록의 영업 시간 필터에서 어떤 통화가 영업 시간 외 통화로 집계되는지 결정합니다. 선택한 요일이 없으면 영업 시간 외 통화가 추적되지 않으며 모든 통화가 영업 시간 통화로 집계됩니다. 테스트 번호에서 걸려 오거나 테스트 번호로 건 통화는 모든 보고서 집계, 포털 목록, 개요 수치 및 CSV 내보내기에서 제외되며 포털에서 열 수 없습니다. 에이전트 빌더의 보고에서 에이전트별 시간대와 영업 시간을 설정할 수 있으며, 이 설정은 해당 에이전트의 통화에만 적용됩니다.
소유자와 관리자는 일반 → 보고에서 이 설정을 변경합니다. 시간대를 선택하고 영업하는 각 요일을 선택한 다음, 해당 요일의 영업 시작 및 종료 시간을 입력합니다. 테스트 번호에서 각 번호를 입력하고 추가를 선택합니다. 그런 다음 보고 설정 저장을 선택합니다. 시간대가 저장되기 전까지 보고서는 UTC를 사용하며, 페이지에는 브라우저의 시간대가 저장되지 않은 변경 사항으로 제안됩니다. 영업 시간을 하나라도 설정하면, 해당 일정을 사용하는 통화에서는 선택하지 않은 요일이 영업 시간 외로 집계됩니다.
API를 통한 보고 설정
소유자와 관리자는 timezone, business_hours, excluded_numbers를 사용하여
PATCH /v1/orgs/{id}/를 호출할 수 있습니다.
timezone:America/Los_Angeles와 같은 IANA 시간대 이름이며, 최대 64자입니다.business_hours:mon부터sun까지의 요일 키입니다. 각 키는 24시간제HH:MM형식의{start, end}시간 구간을 최대 4개까지 포함하는 목록이며, 각 종료 시간은 시작 시간보다 늦어야 합니다.{}는 영업 시간 외 구분이 없음을 의미합니다.excluded_numbers: E.164 형식으로 저장되는 전화번호를 최대 50개까지 지정할 수 있습니다. 국가 코드가 없는 북미 10자리 번호에는+1국가 코드가 추가됩니다.
curl -X PATCH https://api.thunderphone.com/v1/orgs/42/ \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"timezone": "America/Los_Angeles",
"business_hours": {
"mon": [{"start": "09:00", "end": "17:00"}],
"sat": [{"start": "10:00", "end": "14:00"}]
},
"excluded_numbers": ["+14155550199"]
}'차단된 발신자
이 목록에 있는 번호는 에이전트에게 연결할 수 없습니다. 차단된 번호가 조직의 전화번호로 전화하면 ThunderPhone은 에이전트가 응답하기 전에 전화를 끊으며 해당 통화에 비용을 청구하지 않습니다. 이 통화는 통화 기록에 종료 사유가 차단된 발신자인 실패한 수신 통화로 계속 표시됩니다. 발신자 번호가 표시 제한되었거나 익명인 통화는 일치 대상으로 처리되지 않으며, 차단된 번호로 거는 발신 통화에는 영향을 주지 않습니다. 통화 중에 발신자를 차단해도 통화가 끊기지 않으며, 차단은 다음 통화부터 적용됩니다.
모든 멤버가 목록을 볼 수 있으며, 소유자와 관리자는 일반 → 차단된 발신자에서 목록을 변경합니다.
- 번호 하나를 차단하려면 선택 사항인 메모와 함께 번호를 입력하고 번호
차단을 선택합니다.
+및 국가 코드를 사용합니다. 조직의 모든 전화번호가 한 국가에 있는 경우(415) 555-0123과 같은 국내 형식도 사용할 수 있습니다. - 여러 번호를 한 번에 차단하려면 목록 붙여넣기를 선택하고, 최대 500개의 번호를 붙여넣은 후(한 줄에 하나씩 또는 쉼표로 구분) 제출합니다. 결과에는 추가된 번호, 이미 차단된 번호 및 잘못된 번호의 개수가 표시되며, 잘못된 항목도 나열됩니다.
- 번호 차단을 해제하려면 해당 행에서 제거를 선택하고 확인합니다.
통화 기록에서 수신 통화를 열고 이 발신자 차단을 선택할 수도 있습니다. 조직은 최대 10,000개의 번호를 차단할 수 있습니다. API를 통해 목록을 관리하려면 차단된 발신자를 참조하세요.
조직 식별 정보 및 멤버십
조직 카드에는 조직 ID, 내 멤버십 역할 및 편집 가능한 조직 이름이 표시됩니다. 팀 카드에는 활성 멤버와 대기 중인 초대가 함께 표시됩니다.
| 역할 | 일반적인 액세스 |
|---|---|
| 멤버 | 에이전트를 구축 및 운영하고 통화를 검토합니다. |
| 관리자 | 멤버 액세스에 더해 팀, 키, 포털, 연결, 알림, 청구 및 보안을 관리합니다. |
| 소유자 | 관리자 액세스에 더해 소유자 수준의 조직 작업을 수행합니다. |
소유자와 관리자는 멤버 또는 관리자를 초대하고, 대기 중인 초대를 취소하며, 대상 멤버의 역할을 변경하고, 멤버를 제거할 수 있습니다. 초대는 이메일별로 적용되며 7일 후 만료됩니다. 팀 초대하기를 참조하세요.
위험 영역에서는 권한이 있는 사용자가 조직에서 나가거나 조직을 영구적으로 삭제할 수 있습니다. 삭제하면 조직의 에이전트, 번호, 통화 기록 및 청구 데이터가 제거되며 되돌릴 수 없습니다.
자신의 계정을 삭제하려면 계정 탭을 열고 계정 삭제를 선택합니다. 대화 상자에는 삭제될 조직(내가 유일한 구성원인 조직)과 내가 탈퇴할 조직이 표시됩니다. 탈퇴하는 조직에서 내가 생성한 API 키는 취소됩니다. 다른 구성원이 있는 조직의 유일한 소유자인 경우(먼저 다른 사람을 소유자로 지정), 유지되는 조직에서 사용자 지정 음성을 생성한 경우, 통화가 진행 중인 경우 또는 법적 보류가 적용되는 경우에는 삭제할 수 없습니다. 대화 상자에는 삭제를 차단하는 항목이 표시됩니다. 이 작업은 취소할 수 없습니다.
기본 웹훅
조직의 모든 웹 위젯과 전화번호에서 이벤트를 받도록 레거시 웹훅 URL 하나를 설정합니다. 엔드포인트별 비밀, 구독, 전송 기록 및 재시도가 필요한 경우 권장되는 웹훅 엔드포인트를 대신 사용하세요.
엔터프라이즈 SSO
하나 이상의 SSO 연결, 허용된 이메일 도메인, 적시 프로비저닝, 기본 역할 및 선택적 그룹-역할 매핑을 구성합니다. 보안 정책에서는 SSO를 요구하고, 관리자의 긴급 비밀번호 액세스를 허용하며, 조직 액세스에 패스키를 요구할 수 있습니다. SSO를 참조하세요.
키
키 탭에서는 비밀 sk_live_ 서버 API 키를 관리합니다. 각 행에는 이름, 접두사, 활성/해지 상태, 생성 시간, 마지막 사용 시간 및 해지 시간이 표시됩니다.
전체 비밀 값은 생성 직후 한 번만 표시됩니다. 그때 복사하여 비밀 관리자에 저장하세요. 해지는 영구적이며 해당 키를 사용하는 모든 통합을 중지합니다. API 키를 참조하세요.
공개용 pk_live_ 키는 서버 키가 아니라 오리진으로 제한된 브라우저 자격 증명이므로 웹 위젯에 속합니다.
알림
성공률, 실패율, 평균 점수, 통화량 또는 스위트 회귀에 대한 측정항목 규칙을 만듭니다. 규칙에는 다음이 포함됩니다.
- 비교 연산자 및 숫자 임곗값
- 1시간에서 720시간까지의 평가 기간
- 최대 10명의 이메일 수신자
- 선택적 Slack 수신 웹훅 URL
- 선택적 개발자 웹훅 전송
- 정수 분 단위의 쿨다운 및 활성화 상태
같은 탭에 최근 트리거 발생도 표시됩니다. 알림을 참조하세요.
청구 설정
조직 잔액 및 결제 동작을 관리합니다.
- 기본 결제 카드 추가 또는 교체
- 수동으로 자금 추가
- 자동 충전 활성화 및 임곗값과 충전 금액 설정
- 월별 지출 한도 설정 또는 제거
월별 한도는 100%에 도달하면 새 통화와 사용을 일시 중지하며, 자동 충전이 꺼져 있어도 계속 적용됩니다. 가격 및 청구 및 충전을 참조하세요.
청구 내역
청구 내역을 사용하여 오늘, 7일, 30일, 90일 또는 전체 기간의 잔액과 지출을 확인합니다. 다음이 포함됩니다.
- 잔액 추이
- 통화 요금, 보고서, 전화번호 수수료, 충전으로 구성된 청구 내역
- 에이전트별 주요 지출
- 날짜, 카테고리, 설명, 유형, 금액 및 처리 후 잔액이 포함된 거래 테이블
- 카테고리 필터링 및 표시된 내역의 CSV 또는 JSON 내보내기
대시보드에는 최근 거래만 표시되는 경우가 안내됩니다. 해당 제한을 초과하는 이전 행은 내보내기에도 포함되지 않습니다. 청구 API는 프로그래밍 방식의 페이지네이션을 지원합니다.