---
title: "客户门户：品牌化只读通话报告"
description: "创建 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 个字符的密码。

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

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

门户包含两个部分：**概览**和**通话**。

**概览**显示过去 7、14 或 30 天的五项数据。对比指示器显示与此前相同长度周期相比的变化。当之前的值为零且当前值为正数时，不显示指示器。颜色表示变化是好是坏，而非变化方向：

1. **已接听通话**：已接通智能体的呼入和网页通话、对方接听的呼出通话，以及其中有多少通话在非营业时间开始。
2. **全程完成**：客户无需再处理任何事项的通话。
3. **未顺利完成**：呼叫者在通话过程中挂断，或智能体请求信息后挂断；智能体难以获取详细信息；预约失败；或转接未接通的通话。会显示最常见的原因。仅在问候语阶段挂断不计入其中。
4. **感到沮丧的呼叫者**：表现出沮丧情绪的呼叫者，以及最常见的原因。数量越少越好。
5. **已安排预约**，以及其中有多少是与新客户的预约。

在这些数据下方，概览会列出最多八个需要跟进的通话；**查看所有已标记通话**会打开经过筛选的通话列表。当所选周期内有多个智能体接听通话时，表格会显示每个智能体的通话数、非营业时间通话数、全程完成通话数、未顺利完成通话数、预约数和已标记通话数。这五项标题数据也会显示在控制台主页以及每个智能体的**通话**标签页中。

**通话**会列出已分配智能体的呼入、呼出和小组件通话；不包括浏览器测试和模拟通话。每一行显示日期、**来源**号码及您的组织为其添加的任何[标签](/zh/guides/review-calls)、单行摘要、结果标签（智能体自己的列表，或成功／失败）、任何**需要关注**标记及原因、智能体和通话时长。已标记通话会排在最前面；**排序**筛选器可切换为最新优先。筛选器还涵盖日期范围、通话类型、需要关注和营业时间。**导出 CSV**会下载最多 5,000 个符合条件的通话，并包含报告列，已标记通话优先。如果符合条件的通话超过 5,000 个，文件将被截断。

打开通话后，会在录音上方显示标记、结果、摘要和呼叫者体验。对于感到沮丧的呼叫者，呼叫者体验会显示沮丧原因；否则，会在可用时显示呼叫者体验备注。当标记记录了时间且通话有录音时，**跳转至……** 会从该时刻开始播放。随后显示转录文本。

来自或拨打至组织已排除测试号码的通话不会显示在门户列表、概览数据和 CSV 导出中，也无法在门户中打开。非营业时间统计使用组织的时区和营业时间（[组织设置](/zh/guides/organization-settings)），或者使用在智能体构建器的**报告**中设置的智能体自身时区和营业时间。

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

## 连接自定义域名

<Steps>
  <Step title="添加主机名">
    在**自定义域名**下输入完整主机名，例如
    `calls.client.com`。一个主机名只能属于一个门户。
  </Step>
  <Step title="将流量指向门户">
    在 DNS 提供商处添加显示的 **CNAME** 记录。
  </Step>
  <Step title="证明域名所有权">
    在 `_tp-portal-verify.<hostname>` 处添加显示的 **TXT** 记录，并填入生成的验证值。
  </Step>
  <Step title="允许 Azure 主机名验证">
    在 `asuid.<hostname>` 处添加显示的 **TXT** 记录，并填入 Azure 验证值。主机名连接期间请保留该记录。
  </Step>
  <Step title="验证">
    选择**立即验证**。DNS 传播可能需要一些时间；设置页面可每 20 秒再次检查。验证成功后，可以删除 TXT 记录，但必须保留 CNAME。
  </Step>
</Steps>

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

## 删除门户

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

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