--- title: "組織設定參考" description: "管理 ThunderPhone 組織：設定檔、控制台語言、成員、外撥確認、封鎖來電者、Webhook、單一登入、API 金鑰、警示、帳務、支出上限與紀錄。" --- 開啟 **組織設定**（`/dashboard/organization`）以管理目前的組織和你自己的帳戶。設定分為六個分頁；你可變更的控制項目取決於你的角色。 ## 我的帳戶 **我的帳戶** 分頁包含已登入使用者的設定，而非整個組織的設定： - 名字、姓氏、電子郵件地址和頭像 URL。 - 控制台顯示語言。 - macOS 桌面版應用程式下載。 - 新增、驗證、列出和移除通行金鑰。 - Cookie 偏好設定。 - 在目前裝置上登出。 當你透過組織 SSO 登入時，電子郵件地址由身分識別提供者管理，且在此處為唯讀。請參閱[帳戶與安全性](/zh-Hant/guides/account-and-security)，了解通行金鑰和個人資料的詳細流程。 ## 一般 ### 外撥通話法規遵循 對於適用此要求的組織，擁有者或管理員必須先檢閱並記錄一次性的外撥通話確認，智慧體才能撥打外撥電話。成員可以看到需要完成此操作，但無法送出確認。請參閱[外撥通話法規](/zh-Hant/guides/outbound-calling-laws)。 ### 報表 時區、每週營業時間及組織專屬的測試號碼。 營業時間會決定首頁、各智慧體的 **通話** 分頁及客戶入口網站中的通話報表數據，以及通話紀錄中的 **營業時間** 篩選條件，哪些通話會被視為非營業時間。未勾選任何日期時，不會追蹤非營業時間通話，且所有通話都會計入營業時間。與測試號碼之間的通話會從所有報表計數、入口網站清單、總覽數據及 CSV 匯出中排除；無法在入口網站中開啟。智慧體可在智慧體建置工具的 **報表** 下設定專屬時區和營業時間，且僅套用至該智慧體的通話。 擁有者和管理員可在 **一般 → 報表** 下變更這些設定。 選擇時區並勾選每個營業日，然後輸入開店和打烊時間。在 **測試號碼** 下輸入每個號碼並選擇 **新增**。接著選擇 **儲存報表設定**。在儲存時區前，報表會使用 UTC；頁面會將瀏覽器時區建議為尚未儲存的變更。設定任何營業時間後，未勾選的日期會針對使用該排程的通話計為非營業時間。 #### 透過 API 設定報表 擁有者和管理員可使用 `timezone`、`business_hours` 和 `excluded_numbers` 對 `PATCH /v1/orgs/{id}/`： - `timezone`：IANA 時區名稱，例如 `America/Los_Angeles`，最多 64 個字元。 - `business_hours`：星期索引鍵 `mon` 至 `sun`，每個索引鍵包含最多四個 `{start, end}` 時段，使用 24 小時制 `HH:MM`，且每個結束時間必須晚於開始時間。 `{}` 代表不區分非營業時間。 - `excluded_numbers`：最多 50 個電話號碼，以 E.164 格式儲存。未含國碼的 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 會在智慧體接聽前掛斷，且不會對該通話計費。該通話仍會顯示在通話紀錄中，並標示為結束原因是 **已封鎖的來電者** 的失敗撥入通話。隱藏或匿名來電顯示的通話永遠不會被比對，且撥往已封鎖號碼的撥出通話不受影響。在通話期間封鎖來電者不會中斷目前通話；封鎖會從對方下一次來電起生效。 所有成員都可以查看此清單；擁有者和管理員可在 **一般 → 封鎖來電者** 下變更： - 若要封鎖一個號碼，請輸入號碼和選填的備註，然後選擇 **封鎖 號碼**。請使用 `+` 和國碼；若組織的所有電話號碼都位於同一個國家， 也可使用如 `(415) 555-0123` 的國內格式。 - 若要一次封鎖多個號碼，請選擇 **貼上清單**，貼上最多 500 個號碼 （每行一個或以逗號分隔）後提交。結果會顯示已新增、已封鎖或無效的號碼數量， 並列出無效項目。 - 若要解除封鎖號碼，請在該列選擇 **移除** 並確認。 你也可以在 **通話紀錄** 中開啟撥入通話，並選擇 **封鎖此來電者**。一個組織最多可封鎖 10,000 個號碼。若要透過 API 管理清單，請參閱 [封鎖來電者](/api-reference/blocked-callers)。 ### 組織身分與成員資格 組織卡片會顯示組織 ID、你的成員角色，以及可編輯的組織名稱。團隊卡片則整合目前成員和待處理邀請。 | 角色 | 一般存取權限 | | --- | --- | | **成員** | 建立及操作智慧體，並檢閱通話。 | | **管理員** | 包含成員權限，以及團隊、金鑰、入口網站、連線、警示、帳務和安全性管理。 | | **擁有者** | 包含管理員權限，以及組織擁有權層級的操作。 | 擁有者和管理員可以邀請 **成員** 或 **管理員**、撤銷待處理邀請、變更符合資格的成員角色，以及移除成員。邀請僅限指定電子郵件地址使用，並會在七天後到期。請參閱[邀請你的團隊](/zh-Hant/guides/invite-your-team)。 危險區域可讓符合資格的使用者離開組織，或永久刪除組織。刪除會移除組織的智慧體、電話號碼、通話紀錄和帳務資料，且無法復原。 若要刪除自己的帳戶，請開啟 **帳戶** 分頁，並選擇 **刪除帳戶**。對話方塊會列出將被刪除的組織（即你是唯一成員的組織），以及你將離開的組織。你在離開的組織中建立的 API 金鑰會被撤銷。若你是某個仍有其他成員的組織之唯一擁有者（請先將其他人設為擁有者）、你在仍保留的組織中建立了自訂語音、通話正在進行中，或適用法律保留，系統會阻止刪除；對話方塊會列出所有阻礙項目。此操作無法復原。 ### 預設 Webhook 設定一個舊版 Webhook URL，以接收組織中所有網頁小工具和電話號碼的事件。如需每個端點的祕密、訂閱、傳送紀錄和重試功能，請改用建議的 [Webhook 端點](/zh-Hant/webhooks/endpoints)。 ### 企業 SSO 設定一個或多個 SSO 連線、允許的電子郵件網域、即時佈建、預設角色，以及選用的群組至角色對應。安全性原則可要求使用 SSO、允許管理員使用緊急密碼存取，以及要求使用通行金鑰存取組織。請參閱[SSO](/zh-Hant/guides/sso)。 ## 金鑰 **金鑰** 分頁可管理祕密 `sk_live_` 伺服器 API 金鑰。每一列會顯示名稱、前綴、啟用／撤銷狀態、建立時間、上次使用時間和撤銷時間。 完整祕密只會在建立後立即顯示一次。請在當下複製並儲存在祕密管理工具中。撤銷為永久操作，且會停止所有使用該金鑰的整合。請參閱[API 金鑰](/zh-Hant/guides/api-keys)。 可發布的 `pk_live_` 金鑰屬於 **網頁小工具**，因為它們是受來源限制的瀏覽器憑證，而非伺服器金鑰。 ## 警示 為成功率、失敗率、平均分數、通話量或測試套件回歸建立指標規則。規則包含： - 比較運算子和數值門檻。 - 介於 1 至 720 小時的評估期間。 - 最多 10 位電子郵件收件者。 - 選用的 Slack 傳入 Webhook URL。 - 選用的開發人員 Webhook 傳送。 - 以整分鐘計算的冷卻時間和啟用狀態。 同一分頁也會列出最近的觸發紀錄。請參閱[警示](/zh-Hant/guides/alerts)。 ## 帳務設定 管理組織餘額和付款行為： - 新增或更換預設付款卡。 - 手動儲值。 - 啟用自動儲值，並設定其門檻和補充金額。 - 設定或移除每月支出上限。 每月上限在達到 100% 時會暫停新的通話和使用量，即使自動儲值已關閉仍會維持生效。請參閱[定價](/zh-Hant/guides/pricing)和 [帳務與儲值](/zh-Hant/guides/billing-and-topups)。 ## 帳務紀錄 使用 **帳務紀錄** 檢視今天、7 天、30 天、90 天或所有時間的餘額與支出。內容包括： - 餘額趨勢。 - 通話費用、報告、電話號碼費用與儲值的帳務組成。 - 支出最高的智慧體。 - 包含日期、類別、說明、類型、金額與交易後餘額的交易表格。 - 類別篩選，以及匯出目前顯示紀錄的 CSV 或 JSON。 控制台會在僅顯示最近交易時通知你；超過該限制的較舊資料列也不會包含在匯出檔案中。[Billing API](/api-reference/billing) 支援以程式方式進行分頁。