ThunderPhone 2.0 正式上线。全程自助，低至2美分/分钟。查看发布公告
立即开始

Team & account

View as Markdown
Open in
ClaudeChatGPTCursor

组织设置参考

管理 ThunderPhone 组织：资料、控制台语言、成员、外呼确认、已阻止来电者、Webhook、单点登录、API 密钥、提醒、账单、支出限额和历史记录。

打开 组织设置（/dashboard/organization）以管理当前组织和您自己的账户。设置分为六个标签页；您的角色决定您可以更改哪些控件。

我的账户

我的账户 标签页包含已登录用户的设置，而非整个组织的设置：

  • 名字、姓氏、电子邮箱和头像 URL。
  • 控制台显示语言。
  • macOS 桌面应用下载。
  • 添加、验证、列出和移除通行密钥。
  • Cookie 偏好设置。
  • 在当前设备上退出登录。

当您通过组织 SSO 登录时，身份提供商会管理您的电子邮箱，因此此处为只读。有关通行密钥和个人资料的详细流程，请参阅账户与安全。

常规

外呼合规性

对于适用该要求的组织，所有者或管理员必须先审核并记录一次性外呼确认，智能体才能拨打外呼电话。成员可以看到需要执行该操作，但无法提交。请参阅外呼法律。

报告

时区、每周营业时间以及组织自身的测试号码。 营业时间决定哪些通话会在首页、各智能体的 通话 标签页和客户门户中的通话 报告数据里计为非营业时间，也决定通话记录中的 营业时间 筛选条件。未勾选任何日期 时，不会追踪非营业时间通话，所有通话均计为营业时间内通话。来自或拨打测试号码的通话 不会计入任何报告数据，也不会显示在门户列表、概览数据和 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 国家代码。
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、您的成员角色以及可编辑的组织名称。团队卡片汇总活跃成员和待处理邀请。

角色典型权限
成员构建和运营智能体，并审核通话。
管理员包含成员权限，以及团队、密钥、门户、连接、提醒、账单和安全管理权限。
所有者包含管理员权限，以及所有者级别的组织操作权限。

所有者和管理员可以邀请 成员 或 管理员、撤销待处理邀请、更改符合条件的成员角色，以及移除成员。邀请仅适用于指定电子邮箱，并会在七天后过期。请参阅邀请您的团队。

危险区域允许符合条件的用户离开组织或永久删除组织。删除会移除组织的智能体、号码、通话记录和账单数据，且无法撤销。

要删除您自己的账户，请打开 账户 选项卡并选择 删除账户。对话框会列出将被删除的组织（即您是唯一成员的组织）以及您将退出的组织。您在退出的组织中创建的 API 密钥将被撤销。如果您是某个仍有其他成员的组织的唯一所有者（请先将其他人设为所有者）、您在保留的组织中创建了自定义语音、通话正在进行中，或存在法律保全，系统将阻止删除；对话框会列出所有阻止删除的原因。此操作无法撤销。

默认 Webhook

设置一个旧版 Webhook URL，以接收组织中所有网页组件和电话号码的事件。如需按端点配置密钥、订阅、投递历史记录和重试，请改用推荐的 Webhook 端点。

企业 SSO

配置一个或多个 SSO 连接、允许的电子邮箱域、即时配置、默认角色以及可选的组到角色映射。安全策略可以要求使用 SSO、允许管理员通过紧急密码访问，以及要求使用通行密钥访问组织。请参阅SSO。

密钥

密钥 标签页用于管理秘密 sk_live_ 服务器 API 密钥。每一行显示名称、前缀、活跃或已撤销状态、创建时间、最近使用时间和撤销时间。

完整密钥仅会在创建后立即显示一次。请在此时复制并存储在密钥管理器中。撤销为永久操作，并会停止使用该密钥的所有集成。请参阅API 密钥。

可发布的 pk_live_ 密钥属于 网页组件，因为它们是受来源限制的浏览器凭据，而非服务器密钥。

提醒

为成功率、失败率、平均评分、通话量或测试套件回归创建指标规则。一条规则包括：

  • 比较器和数值阈值。
  • 1 至 720 小时的评估窗口。
  • 最多 10 位电子邮件收件人。
  • 可选的 Slack 传入 Webhook URL。
  • 可选的开发者 Webhook 投递。
  • 以整分钟计的冷却时间和启用状态。

同一标签页还会列出最近触发的提醒。请参阅提醒。

账单设置

管理组织余额和付款行为：

  • 添加或替换默认付款卡。
  • 手动充值。
  • 启用自动充值，并设置其阈值和充值金额。
  • 设置或移除每月支出限额。

月度限额会在达到 100% 时暂停新的通话和使用，即使关闭自动充值也会保持生效。请参阅定价和账单与充值。

账单历史

使用 账单历史 查看今天、7 天、30 天、90 天或所有时间范围内的余额和支出。内容包括：

  • 余额趋势。
  • 通话费用、报告、电话号码费用和充值的账单构成。
  • 支出最高的智能体。
  • 包含日期、类别、描述、类型、金额和交易后余额的交易表。
  • 类别筛选，以及导出显示历史记录的 CSV 或 JSON 文件。

控制台会在仅显示最新交易记录时提示您；超出该限制的较早记录也不会包含在导出内容中。账单 API 支持以编程方式分页。