--- title: "组织设置参考" description: "管理 ThunderPhone 组织：资料、控制台语言、成员、外呼确认、已阻止来电者、Webhook、单点登录、API 密钥、提醒、账单、支出限额和历史记录。" --- 打开 **组织设置**（`/dashboard/organization`）以管理当前组织和您自己的账户。设置分为六个标签页；您的角色决定您可以更改哪些控件。 ## 我的账户 **我的账户** 标签页包含已登录用户的设置，而非整个组织的设置： - 名字、姓氏、电子邮箱和头像 URL。 - 控制台显示语言。 - macOS 桌面应用下载。 - 添加、验证、列出和移除通行密钥。 - Cookie 偏好设置。 - 在当前设备上退出登录。 当您通过组织 SSO 登录时，身份提供商会管理您的电子邮箱，因此此处为只读。有关通行密钥和个人资料的详细流程，请参阅[账户与安全](/zh/guides/account-and-security)。 ## 常规 ### 外呼合规性 对于适用该要求的组织，所有者或管理员必须先审核并记录一次性外呼确认，智能体才能拨打外呼电话。成员可以看到需要执行该操作，但无法提交。请参阅[外呼法律](/zh/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`，每个键包含最多四个采用 24 小时制 `HH:MM` 格式的 `{start, end}` 时段，且每个结束时间必须晚于 开始时间。`{}` 表示不区分非营业时间。 - `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/guides/invite-your-team)。 危险区域允许符合条件的用户离开组织或永久删除组织。删除会移除组织的智能体、号码、通话记录和账单数据，且无法撤销。 要删除您自己的账户，请打开 **账户** 选项卡并选择 **删除账户**。对话框会列出将被删除的组织（即您是唯一成员的组织）以及您将退出的组织。您在退出的组织中创建的 API 密钥将被撤销。如果您是某个仍有其他成员的组织的唯一所有者（请先将其他人设为所有者）、您在保留的组织中创建了自定义语音、通话正在进行中，或存在法律保全，系统将阻止删除；对话框会列出所有阻止删除的原因。此操作无法撤销。 ### 默认 Webhook 设置一个旧版 Webhook URL，以接收组织中所有网页组件和电话号码的事件。如需按端点配置密钥、订阅、投递历史记录和重试，请改用推荐的 [Webhook 端点](/zh/webhooks/endpoints)。 ### 企业 SSO 配置一个或多个 SSO 连接、允许的电子邮箱域、即时配置、默认角色以及可选的组到角色映射。安全策略可以要求使用 SSO、允许管理员通过紧急密码访问，以及要求使用通行密钥访问组织。请参阅[SSO](/zh/guides/sso)。 ## 密钥 **密钥** 标签页用于管理秘密 `sk_live_` 服务器 API 密钥。每一行显示名称、前缀、活跃或已撤销状态、创建时间、最近使用时间和撤销时间。 完整密钥仅会在创建后立即显示一次。请在此时复制并存储在密钥管理器中。撤销为永久操作，并会停止使用该密钥的所有集成。请参阅[API 密钥](/zh/guides/api-keys)。 可发布的 `pk_live_` 密钥属于 **网页组件**，因为它们是受来源限制的浏览器凭据，而非服务器密钥。 ## 提醒 为成功率、失败率、平均评分、通话量或测试套件回归创建指标规则。一条规则包括： - 比较器和数值阈值。 - 1 至 720 小时的评估窗口。 - 最多 10 位电子邮件收件人。 - 可选的 Slack 传入 Webhook URL。 - 可选的开发者 Webhook 投递。 - 以整分钟计的冷却时间和启用状态。 同一标签页还会列出最近触发的提醒。请参阅[提醒](/zh/guides/alerts)。 ## 账单设置 管理组织余额和付款行为： - 添加或替换默认付款卡。 - 手动充值。 - 启用自动充值，并设置其阈值和充值金额。 - 设置或移除每月支出限额。 月度限额会在达到 100% 时暂停新的通话和使用，即使关闭自动充值也会保持生效。请参阅[定价](/zh/guides/pricing)和[账单与充值](/zh/guides/billing-and-topups)。 ## 账单历史 使用 **账单历史** 查看今天、7 天、30 天、90 天或所有时间范围内的余额和支出。内容包括： - 余额趋势。 - 通话费用、报告、电话号码费用和充值的账单构成。 - 支出最高的智能体。 - 包含日期、类别、描述、类型、金额和交易后余额的交易表。 - 类别筛选，以及导出显示历史记录的 CSV 或 JSON 文件。 控制台会在仅显示最新交易记录时提示您；超出该限制的较早记录也不会包含在导出内容中。[账单 API](/api-reference/billing) 支持以编程方式分页。