> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 客户门户：品牌化只读通话报告

> 创建 ThunderPhone 客户门户，选择可见智能体，添加查看者，为体验添加品牌标识，连接自定义域名，并分享只读通话记录。

**客户门户**为每位客户提供由您品牌呈现的只读视图，用于查看为其处理的通话。门户可以包含选定的智能体、专属查看者、徽标和强调色，以及可选的自定义域名。

组织管理员可在**客户门户**（`/dashboard/client-portals`）中管理门户。查看者使用托管门户 URL，且绝不会获得对 ThunderPhone 控制台的访问权限。

## 创建门户

<Steps>
  <Step title="选择“新建门户”">
    输入面向客户显示的名称。ThunderPhone 会根据该名称创建唯一的 URL slug；您之后可以编辑该 slug。
  </Step>

  <Step title="分配智能体">
    添加客户应查看其通话的智能体。未分配智能体的门户不会显示任何通话。
  </Step>

  <Step title="添加查看者">
    添加每位获批准查看者的电子邮件地址。查看者可在门户登录页面自行请求登录代码。
  </Step>

  <Step title="分享 URL">
    复制门户 URL，或选择**打开**进行测试。列表页面还会显示每个门户的启用状态、智能体数量和查看者数量。
  </Step>
</Steps>

## 门户详情和可用性

**门户详情**卡片可控制：

* **名称**——显示在门户登录页和页眉中；最多 255 个字符。
* **Slug**——托管 URL 路径段；最多 100 个字符。使用小写字母、数字和单个连字符。Slug 必须唯一，且不能使用平台保留路由。
* **智能体**——门户中可见的智能体通话记录的确切范围。
* **门户已启用**——关闭此选项可阻止所有查看者打开门户，而无需删除配置。

只有属于已分配智能体的通话才在范围内。查看者无法编辑智能体、发起通话、管理账单，或查看组织中的其他数据。

## 品牌

上传不超过 **2 MB** 的 **PNG**、**JPEG** 或 **WebP** 徽标。选择完整的六位十六进制强调色，例如 `#2e8fff`；它会控制主要按钮和高亮显示。重置任一值即可恢复默认品牌样式。

品牌样式会显示在登录页面和已认证门户的页眉中。

## 查看者访问权限

通过电子邮件添加查看者。在门户登录页面，已启用的查看者可以：

* 通过电子邮件请求六位代码。代码有效期为 10 分钟。
* 如果已创建密码，则使用密码登录。
* 登录后创建至少 8 个字符的密码。

您可以停用查看者而不删除其行，也可以将其删除以移除访问权限。门户会话与控制台会话彼此独立。

## 查看者可以看到的内容

门户通话记录表会显示已分配智能体范围内的通话。查看者可以打开通话以查看：

* 日期、方向、主叫方/被叫方、状态和时长。
* 已分配的智能体，以及评分后显示的成功或失败结果。
* 转录文本。
* 有录音时的录音播放。

该界面为只读。它不会显示智能体提示词、组织设置、密钥、账单、工具或内部问题处理流程。

## 连接自定义域名

<Steps>
  <Step title="添加主机名">
    在**自定义域名**下，输入完整主机名，例如
    `calls.client.com`。一个主机名只能属于一个门户。
  </Step>

  <Step title="将流量指向门户">
    在 DNS 提供商处添加显示的 **CNAME** 记录。
  </Step>

  <Step title="证明域名所有权">
    在
    `_tp-portal-verify.<hostname>` 处添加显示的 **TXT** 记录，并使用生成的验证值。
  </Step>

  <Step title="验证">
    选择**立即验证**。DNS 传播可能需要时间；设置页面可每 20 秒再次检查。验证成功后，可以删除 TXT 记录，但必须保留 CNAME。
  </Step>
</Steps>

在其他位置重新使用该主机名之前，请先从门户中移除该域名。

## 删除门户

删除门户会永久移除其查看者访问权限和自定义域名配置。此操作不会删除组织的智能体或通话，但门户无法恢复。如需可逆地暂停，请使用 **门户已启用** 开关。

如需管理员自动化，请参阅
[客户门户 API](/api-reference/client-portals)。
