--- title: "組織設定リファレンス" description: "ThunderPhone組織のプロフィール、ダッシュボード言語、メンバー、発信確認、ブロックした発信者、Webhook、SSO、APIキー、アラート、請求、利用上限、履歴を管理します。" --- **組織設定** (`/dashboard/organization`) を開き、現在の 組織と自身のアカウントを管理します。設定は6つのタブに分かれており、ロールによって変更できる項目が決まります。 ## マイアカウント **マイアカウント** タブには、組織全体ではなくログイン中のユーザーに関する設定が含まれます。 - 名、姓、メールアドレス、アバターURL。 - ダッシュボードの表示言語。 - macOSデスクトップアプリのダウンロード。 - パスキーの追加、確認、一覧表示、削除。 - Cookie設定。 - 現在のデバイスからログアウト。 組織のSSOを介してログインする場合、メールアドレスはIDプロバイダーによって管理され、この画面では読み取り専用です。パスキーとプロフィールの詳細な手順については、[アカウントとセキュリティ](/ja/guides/account-and-security) を参照してください。 ## 一般 ### 発信コンプライアンス 要件が適用される組織では、エージェントが発信を行う前に、オーナーまたは管理者が一回限りの発信確認を確認して記録する必要があります。メンバーは対応が必要であることを確認できますが、送信はできません。 [発信に関する法律](/ja/guides/outbound-calling-laws)を参照してください。 ### レポート タイムゾーン、週間営業時間、組織独自のテスト番号を設定します。 営業時間は、ホームの通話レポート数、各エージェントの **通話** タブ、クライアントポータル、および通話履歴の **営業時間** フィルターで、どの通話を営業時間外として扱うかを決定します。曜日を選択しない場合、営業時間外の通話は追跡されず、すべての通話が営業時間内として扱われます。テスト番号からの通話またはテスト番号への通話は、すべてのレポート件数、ポータルのリスト、概要の数値、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` の国番号が追加されます。 ```bash 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 はエージェントが応答する前に通話を切断し、その通話には課金しません。通話履歴には引き続き表示され、終了理由が **ブロックされた発信者** の失敗した着信通話として記録されます。発信者番号が非通知または匿名の通話は一致することがなく、ブロックされた番号への発信通話は影響を受けません。通話中にブロックした発信者の通話は切断されず、ブロックは次回の通話から適用されます。 すべてのメンバーがリストを確認できます。オーナーと管理者は **一般 → ブロックされた発信者** で変更できます。 - 1 つの番号をブロックするには、任意のメモとともに番号を入力し、**番号をブロック** を選択します。`+` と国番号を使用します。組織の電話番号がすべて同じ国にある場合は、`(415) 555-0123` のような国内形式も使用できます。 - 複数の番号をまとめてブロックするには、**リストを貼り付け** を選択し、最大 500 件の番号を貼り付けて送信します。番号は 1 行に 1 件ずつ、またはカンマ区切りで入力できます。結果には、追加済み、すでにブロック済み、無効の件数が表示され、無効な項目も一覧表示されます。 - 番号のブロックを解除するには、その行で **削除** を選択し、確認します。 **通話履歴** で着信通話を開き、**この発信者をブロック** を選択することもできます。1 つの組織でブロックできる番号は最大 10,000 件です。API を使用してリストを管理する方法については、[ブロックされた発信者](/api-reference/blocked-callers) を参照してください。 ### 組織情報とメンバーシップ 組織カードには、組織ID、所属ロール、編集可能な組織名が表示されます。チームカードには、有効なメンバーと保留中の招待がまとめて表示されます。 | ロール | 一般的なアクセス権 | | --- | --- | | **メンバー** | エージェントの構築と運用、通話の確認。 | | **管理者** | メンバーのアクセス権に加え、チーム、キー、ポータル、接続、アラート、請求、セキュリティの管理。 | | **オーナー** | 管理者のアクセス権に加え、所有者レベルの組織操作。 | オーナーと管理者は、**メンバー** または **管理者** を招待し、保留中の招待を取り消し、変更可能なメンバーのロールを変更し、メンバーを削除できます。招待はメールアドレスごとに発行され、7日後に期限切れになります。[チームを招待](/ja/guides/invite-your-team)を参照してください。 危険ゾーンでは、権限を持つユーザーが組織を退出したり、組織を完全に削除したりできます。削除すると、組織のエージェント、電話番号、通話履歴、請求データが削除され、元に戻すことはできません。 自身のアカウントを削除するには、**アカウント**タブを開き、**アカウントを削除** を選択します。ダイアログには、削除される組織（唯一のメンバーである組織）と、脱退する組織が表示されます。脱退する組織で作成した API キーは取り消されます。ほかのメンバーがいる組織で唯一の所有者である場合（先に別のメンバーを所有者にしてください）、存続する組織でカスタム音声を作成している場合、通話中の場合、または法的保全措置が適用されている場合は、削除できません。ダイアログには削除を妨げている要因が表示されます。この操作は元に戻せません。 ### デフォルトウェブフック 組織内のすべてのウェブウィジェットと電話番号からイベントを受信するために、レガシーウェブフックURLを1つ設定します。エンドポイントごとのシークレット、サブスクリプション、配信履歴、再試行には、推奨される [ウェブフックエンドポイント](/ja/webhooks/endpoints)を使用してください。 ### Enterprise SSO 1つ以上のSSO接続、許可するメールドメイン、ジャストインタイムプロビジョニング、デフォルトロール、任意のグループからロールへのマッピングを設定します。セキュリティポリシーでは、SSOを必須にし、管理者に緊急時のパスワードアクセスを許可し、組織へのアクセスにパスキーを必須にできます。[SSO](/ja/guides/sso)を参照してください。 ## キー **キー** タブでは、シークレット `sk_live_` サーバーAPIキーを管理します。各行には、名前、プレフィックス、有効または失効の状態、作成時刻、最終使用時刻、失効時刻が表示されます。 完全なシークレットは、作成直後に一度だけ表示されます。その時点でコピーし、シークレットマネージャーに保存してください。失効は永続的であり、そのキーを使用するすべての連携が停止します。[APIキー](/ja/guides/api-keys)を参照してください。 公開可能な `pk_live_` キーは、サーバーキーではなくオリジン制限されたブラウザ認証情報であるため、**ウェブウィジェット** に属します。 ## アラート 成功率、失敗率、平均スコア、通話量、スイートの回帰に対するメトリックルールを作成します。ルールには次の項目が含まれます。 - 比較条件と数値のしきい値。 - 1〜720時間の評価ウィンドウ。 - 最大10件のメール受信者。 - 任意のSlack受信ウェブフックURL。 - 任意の開発者ウェブフックへの配信。 - 整数分単位のクールダウンと有効状態。 同じタブには最近の発火も表示されます。[アラート](/ja/guides/alerts)を参照してください。 ## 請求設定 組織の残高と支払い動作を管理します。 - デフォルトの支払いカードを追加または置き換える。 - 手動で資金を追加する。 - 自動チャージを有効にし、しきい値とチャージ額を設定する。 - 月間利用上限を設定または削除する。 月間上限は100%に達すると新規通話と利用を停止し、自動チャージが無効の場合でも有効なままです。[料金](/ja/guides/pricing)および [請求とチャージ](/ja/guides/billing-and-topups)を参照してください。 ## 請求履歴 **請求履歴**を使用して、今日、7日間、30日間、90日間、または全期間の残高と利用額を確認します。以下が含まれます。 - 残高の推移。 - 通話料金、レポート、電話番号料金、チャージにわたる請求内訳。 - エージェント別の上位利用額。 - 日付、カテゴリ、説明、種別、金額、取引後残高を含む取引テーブル。 - カテゴリによるフィルタリングと、表示中の履歴のCSVまたはJSONエクスポート。 ダッシュボードでは、最新の取引のみが表示されている場合に通知されます。その上限を超える古い行は、エクスポートにも含まれません。[請求API](/api-reference/billing)では、プログラムによるページネーションをサポートしています。