> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/zh/zoom-workplace/zoom-phone/zoom-phone-local-survivability-field-guide/before-you-begin/pstn-integration-considerations.md).

# PSTN 集成注意事项

本节适用于正在考虑将 ZPLS 模块与 SBC 和 PSTN 连接集成，以增强生存能力的客户。不打算将 ZPLS 模块与 PSTN 连接集成的客户可以跳过本节，不会产生任何影响。

### SBC 集成注意事项

#### <mark style="color:蓝色;">SBC 要求</mark>

要将 SBC 与 Zoom 集成以增强生存能力，SBC 必须满足以下要求：

* TLS 1.2 和 SRTP
* 支持双向 TLS
* 会议发起协议 (SIP)
* DTMF (RFC-2833)
* 拓扑隐藏 (RFC-5853)
* SIP Early Offer（**必需**)
* Opus、G.711 μ-law、G.711 A-law 和 G.729 编解码器

#### <mark style="color:蓝色;">PSTN 集成需要 SBC 和可靠的第三方提供商</mark>

要连接 PSTN，客户必须提供一个会话边界控制器 (SBC)，并将其连接到传统线路，或连接到带有蜂窝网络或备用连接（例如 DSL）的 SIP 中继。客户应注意，部署在 SBC 上的任何 SIP 中继都可能依赖正在发生故障的同一互联网服务。因此，客户应考虑使用可靠的第三路连接来连接 PSTN。

#### <mark style="color:蓝色;">任何通过 Zoom Phone BYOC 认证的 SBC 均可使用</mark>

任何 [通过 Zoom Phone 认证](https://support.zoom.us/hc/en-us/articles/360001299063-Zoom-Phone-Certified-Hardware#h_ec5008d4-3581-46e7-a06d-32599511d089) 的会话边界控制器 (SBC) 也可与 ZPLS 模块搭配使用。使用现有 Zoom Phone BYOC 方案的客户无需为增强生存能力额外配置或单独使用 SBC。

#### <mark style="color:蓝色;">必须在 SBC 上安装 Zoom 的 DigiCert 证书</mark>

要与 ZPLS 模块和 Zoom 云建立 TLS 连接，必须将 Zoom 的 [DigitCert 根证书和中间证书](https://support.zoom.us/hc/en-us/articles/360044092031) 安装在 SBC 上。

#### <mark style="color:蓝色;">SBC 必须将拨入呼叫优先路由到 Zoom Phone 数据中心，第二优先路由到另一数据中心，第三优先路由到 ZPLS 模块</mark>

客户的 SBC 必须先将来自 PSTN 的拨入呼叫路由到主 SIP 区域和备用 SIP 区域，然后才尝试路由到 ZPLS 模块。采用此配置后，只有在发生生存能力事件时，呼叫才会路由到 ZPLS 模块；其他情况下，SBC 和 Zoom Phone 数据中心应保持稳定连接。

如果未遵循此逻辑，可能会导致呼叫投递失败，因为 ZPLS 模块无法将呼叫路由到已在云端注册的设备。

{% hint style="info" %}
生存能力事件发生后，一旦 Zoom Phone 云恢复在线，SBC 可能会暂时尝试将 BYOC 号码路由到 Zoom 云，而受影响号码对应的客户端设备仍注册在 ZPLS 模块上。如果发生这种情况，在此过渡期间，呼叫路由将遵循 [**呼叫未接听时**](https://support.zoom.us/hc/en-us/articles/360059966372-Customizing-call-handling-settings#h_86f4bf1b-51ea-4d70-9e40-4a84a5ca1c2c) 的设置。
{% endhint %}

#### <mark style="color:蓝色;">从 ZPLS 模块发出的外拨呼叫必须路由到 SBC 和 PSTN SIP 中继</mark>

生存能力模式有效时，从 ZPLS 发往 SBC 的呼叫必须路由到 PSTN SIP 中继，以建立外部电话连接。所有发往未在 ZPLS 模块上注册的号码的呼叫，都会以 E.164 格式发送到配置为用于生存能力的 SBC。

### 呼叫转移：本地生存能力注意事项

#### <mark style="color:蓝色;">发生生存能力事件期间，除非通过呼叫转移重新路由，否则 Zoom Phone 提供的电话号码无法从外部接通</mark>

发生生存能力事件期间，从云端来看，Zoom 提供的电话号码无法从外部接通。因此，位于受影响站点内的用户可能无法接通，除非将呼叫转移到其主号码关联的本地 SBC 上的备用号码。

{% hint style="info" %}
受影响号码的常见示例包括分配给以下对象的号码：用户、公共区域、自动总机 (AR)、共享线路组 (SLG) 和呼叫队列 (CQ)。
{% endhint %}

#### <mark style="color:蓝色;">使用本地部署 BYOC 的客户无需进行高级配置；只需在 SBC 中添加一条指向其 ZPLS 模块的第三优先路由，即可绕过呼叫转移</mark>

使用本地部署 BYOC 方案的客户（即不使用已在 Zoom Phone 注册的号码的客户）无需进行高级配置即可启用呼叫转移。BYOC 客户可以改为从本地部署的 SBC 添加一条指向 ZPLS 模块的第三优先路由。

#### <mark style="color:蓝色;">管理员或授权用户可通过 Web 门户设置呼叫转移配置</mark>

账户管理员或授权用户可以 [配置呼叫转移逻辑](#_1od0waijmvaz) 在 Web 门户中通过 [手动输入或批量上传 CSV](#_aezu04x8z043).

#### <mark style="color:蓝色;">配置了呼叫转移的用户将分配到三个号码</mark>

为用户分配 BYOC 号码以实现生存能力呼叫转移后，客户端设备至少会分配 *至少* 三个号码：

1. 前置站点代码的内部分机
2. Zoom 提供的 PSTN 号码
3. BYOC PSTN 号码

<div data-with-frame="true"><figure><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/RlfwmyOhkqzROMBi52i8/Unknown%20image" alt="" width="375"><figcaption></figcaption></figure></div>

#### <mark style="color:蓝色;">电话号码最多只能转移到一个 BYOC 号码</mark>

每个 Zoom Phone 号码最多只能转移到 **一个** 其他 BYOC 号码。但可以将多个电话号码转移到同一个 BYOC 号码。

例如，如果 John 分配到的电话号码是 X55-555-5555，则可以将 John 的电话号码转移到其所在大楼的总机号码 X99-999-9999。同样，John 的同事也可以将自己的号码（X55-555-5554、X55-555-5553 等）转移到 X99-999-9999。或者，也可以将每位用户的电话号码分别转移到完全不同的号码，例如将 X55-555-5554 路由到 X99-999-9998，将 X55-555-5553 路由到 X99-999-9997。但单个用户的号码不能同时转移到 X99-999-9999 和 X99-999-9998。

#### <mark style="color:蓝色;">必须保持呼叫转移处于禁用状态，直到发生生存能力事件</mark>

管理员可以提前为站点预配置呼叫转移逻辑，但必须保持呼叫转移功能处于禁用状态，直到发生生存能力事件。如果在日常运行期间启用呼叫转移，所有拨入 Zoom Phone 注册号码的呼叫都会重新路由到本地 SBC 和关联的 BYOC 电话号码，从而绕过 Zoom Phone 服务。因此，为保持 Zoom Phone 的常规路由，日常运行期间必须禁用呼叫转移。

#### <mark style="color:蓝色;">只有具有正常互联网连接的授权用户或管理员才能启用呼叫转移</mark>

在生存模式事件期间，默认认为站点的互联网连接不可用。不过，由于标准运行时必须停用呼叫转移，因此只有具有正常互联网连接的授权用户或管理员才能启用呼叫转移，例如通过手机数据套餐或其他位置的备用互联网连接。

{% hint style="info" %}
为尽量缩短停机时间并确保业务连续性，Zoom 建议企业制定可靠的流程，以便在发生生存模式事件时通过 Web 门户启用呼叫转移逻辑。
{% endhint %}

#### <mark style="color:蓝色;">呼叫转移规则可应用于整个站点，也可应用于单个号码</mark>

发生生存模式事件时，管理员或授权用户可以通过 Web 门户为整个站点或特定号码启用呼叫转移规则。

#### <mark style="color:蓝色;">为用户的电话号码启用呼叫转移后，即使用户的云注册客户端仍保持独立的云连接，Zoom 也不会让该客户端响铃</mark>

为 Zoom Phone 注册的号码启用呼叫转移后，Zoom 将不会尝试通过云端向用户转接任何呼叫。因此，即使受影响的用户拥有已注册云端的设备（例如手机），只要该电话号码已标记为呼叫转移，所有呼叫都将通过 PSTN 转接至公司的 SBC。

例如，某站点正遭遇生存模式事件，用户的手机通过蜂窝服务提供商的数据连接接入 Zoom Phone 云。如果用户的电话号码已标记为呼叫转移，Zoom Phone 云 **不会** 通过移动应用呼叫其 Zoom Phone 号码，即使连接稳定也是如此。相反，所有呼叫仍将通过 PSTN 转接至客户的 SBC。

#### <mark style="color:蓝色;">如果在生存模式事件期间未为用户启用呼叫转移，来电将按照各用户的通话处理偏好进行处理</mark>

如果在生存模式事件期间未启用呼叫转移，来电将根据 [通话处理逻辑](https://support.zoom.us/hc/en-us/articles/360059966372-Customizing-call-handling-settings) 为每位用户设置的逻辑进行处理。如果用户没有注册到云端的备用电话客户端（例如手机），来电者将受 **无人接听时** 通话处理偏好部分所定义的规则约束。

#### <mark style="color:蓝色;">呼叫转移仅适用于通过 PSTN 呼入的呼叫</mark>

生存模式下的呼叫转移仅适用于通过 PSTN 和/或 Zoom Phone 云路由的呼叫。来自同一站点内已注册 Zoom 的分机的呼叫将首先尝试通过 ZPLS 模块连接；如果已连接 SBC，则随后尝试通过 PSTN 连接。无法连接的呼叫将按照 **无人接听时** 用户电话设置中“通话处理”规则部分所定义的方式处理。

### 呼叫转移流程

下图详细说明了生存模式事件期间启用呼叫转移后的逻辑。此逻辑将持续生效，直到停用呼叫转移或恢复标准运行。不过，如果在恢复标准运行 *后* 仍未停用呼叫转移，转移的呼叫将从 Zoom Phone 云发往 SBC，再返回云端，然后才会转接到用户的设备。因此，生存模式事件结束后应尽快停用呼叫转移。

<div data-with-frame="true"><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/oITDPnN2h3r5uCsJcZky/Unknown%20image" alt=""></div>

1. 外部来电者向已注册 Zoom Phone 的号码发起呼叫，该呼叫通过 PSTN 路由。
2. 呼叫被路由至 Zoom Phone 云，并且系统识别出所拨打的电话号码受到呼叫转移的影响。

{% hint style="info" %}
如果未启用呼叫转移，Zoom Phone 将按照 **无人接听时** 为该用户或分机设置的逻辑进行处理。
{% endhint %}

3. 由于已启用呼叫转移，Zoom 不会尝试提醒用户，而是会将呼叫通过 PSTN 转接至指定的呼叫转移号码。
4. 呼叫通过 PSTN 路由至生存模式 SBC。
5. 生存模式 SBC 将呼叫转发至 ZPLS 模块。
6. 如果用户的注册客户端已连接，ZPLS 模块会将呼叫转发至该客户端。

### 紧急位置识别号码 (ELIN) 注意事项

#### <mark style="color:蓝色;">ELIN 是专属于某个站点的电话号码，拨打该号码时可向紧急服务传达位置信息</mark>

紧急位置识别号码 (ELIN) 是一个专用电话号码，公共安全应答点 (PSAP) 可通过该号码在来电者拨打紧急服务电话时识别其实际地址。使用此功能时，企业必须与其 PSTN 服务提供商合作，将地址映射到电话号码，以确保 PSAP 接线员接听呼叫时，该地址已登记在自动位置识别 (ALI) 数据库中。

例如，某大学校园跨越多栋建筑，每栋建筑分别对应一个 Zoom Phone 站点。如果用户在生存模式事件期间通过与该站点 [关联的电话或设备](#_ggwzik1hd9xi)拨打紧急服务电话，紧急服务部门将自动收到该站点备案的完整地址，前提是该位置已配置，并且服务提供商处的信息为最新信息。

#### <mark style="color:蓝色;">每个站点可支持多个 ELIN</mark>

客户可以为站点分配多个 ELIN，以建立紧急号码资源池。在生存模式事件期间发生紧急情况时，这样便可为多位来电者分别分配唯一的 ELIN，帮助紧急服务部门在回拨时联系到最初的来电者。

此外，还可以将 ELIN 分配给用户或公共区域电话，实现比站点级分配更精细的 ELIN 分配，为紧急服务部门提供更准确的位置。

#### <mark style="color:蓝色;">生存模式事件期间，所有紧急呼叫都会替换为 ELIN</mark>

用户在生存模式事件期间拨打紧急电话时，如果有可用的用户呼叫号码，该号码将替换为站点级别指定的 ELIN。这样一来，没有直线号码的用户也可以拨打紧急服务电话，并可供紧急服务接线员回拨。

#### <mark style="color:蓝色;">ELIN 必须是与站点 SBC PSTN 中继关联的 BYOC 号码</mark>

站点的 ELIN **必须** 是一个 BYOC 号码，并且必须接入位于站点故障切换 SBC 上的 PSTN 中继。不得使用其他类型的号码。

#### <mark style="color:蓝色;">ZPLS 模块会自动将拨打 ELIN 的紧急服务呼叫转接回最初拨打该号码的用户分机，最长可达 2 小时</mark>

如果紧急服务接线员回拨 ELIN，ZPLS 模块会将呼叫转接回最初拨打紧急电话的用户。ZPLS 模块会在最长 2 小时内持续将 PSAP 回拨转接给最初的来电者。目前，此功能仅支持最初的一位来电者。

#### <mark style="color:蓝色;">电话号码一旦被指定为 ELIN，就不能再分配给用户或设备</mark>

管理员将 BYOC 号码指定为某个站点的 ELIN 后，除非取消该指定，否则无法将其分配给任何用户或其他 Zoom Phone 实体。

#### <mark style="color:蓝色;">客户负责维护和更新与各站点 ELIN 关联的实际地址</mark>

Zoom 不负责向 BYOC 运营商更新与各 ELIN 对应的实际地址。客户负责确保紧急地址正确映射到相应的实际地址。

### PSTN 路由注意事项

#### <mark style="color:蓝色;">生存模式有效时，媒体数据包通过 ZPLS 模块路由</mark>

启用生存模式后，客户端不会直接与 SBC 或其他内部客户端通信；媒体数据包会通过 ZPLS 模块进行锚定或“发夹式”转发，不支持媒体卸载。

下图展示了正在进行的内部和外部呼叫的信令和媒体路径。

<div data-with-frame="true"><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/irEOa0JWa2qCCobkIU1u/Unknown%20image" alt=""></div>

#### <mark style="color:蓝色;">呼叫将首先尝试通过本地路由</mark>

只要条件允许，ZPLS 模块就会尝试将已注册 Zoom 客户端发起的呼叫路由到本地注册的目标。只有当传入 SIP 邀请的 Request URI 字段中的目标与已注册的分机不匹配时，呼叫才会转发到 SBC。

{% hint style="info" %}
已注册的分机可以是没有站点代码的短分机、有站点代码的长分机、已分配的 Zoom 注册号码或已分配的 BYOC 号码。管理员应注意，ZPLS 模块更新此数据的频率为 [每 10 小时一次](#_54gf3fuxcnk5).
{% endhint %}

#### <mark style="color:蓝色;">在生存能力事件 & 活动 &直播期间，外部外拨呼叫将显示用户的 BYOC 号码</mark>

在生存能力事件 & 活动 &直播期间，从已向 ZPLS 注册的设备发起的外部外拨呼叫将包含 BYOC Calling Number。下图展示了用户在生存模式下的呼叫流程：

<div data-with-frame="true"><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/ycSBccAalA5qPcF077rF/Unknown%20image" alt=""></div>

#### <mark style="color:蓝色;">回拨呼叫可能会路由到用户的 BYOC 号码</mark>

由于在生存能力事件 & 活动 &直播期间发起的外部外拨呼叫会使用 BYOC 号码，外部呼叫者可能会使用 BYOC 号码而非用户的 Zoom 注册电话号码回拨。如果生存能力事件 & 活动 &直播已经结束， [且配置了正确的路由优先级](#_zgofkpkt74xr)，呼叫将通过云路由回来。但是，如果事件 & 活动 &直播仍在持续，SBC 会将呼叫路由到 ZPLS 模块和客户端注册的设备。

<div data-with-frame="true"><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/TcZnB68gxWNsSzN4j9fS/Unknown%20image" alt=""></div>

#### <mark style="color:蓝色;">支持的生存模式编解码器</mark>

生存模式支持的编解码器包括 Opus、G.711 μ-law、G.711 A-law 和 G.729。不支持音频编解码器的转码或码率转换。正在进行的呼叫中的所有参与方都必须支持相同的编解码器和采样率。

### 生存能力分配群组注意事项

本节介绍生存能力分配群组 (SDG) 的注意事项。不打算使用 SDG 或将 ZPLS 模块与 PSTN 连接集成的客户可以直接跳过本节。

#### <mark style="color:蓝色;">生存能力分配群组在生存能力事件 & 活动 &直播期间提供精细的呼叫路由选项</mark>

生存能力分配群组 (SDG) 可在生存能力事件 & 活动 &直播期间为企业提供精细的呼叫路由选项，例如呼叫队列和互动式语音应答 (IVR) 菜单。借助 SDG，企业可以继续支持核心电话通讯服务和呼叫路由配置（类似于呼叫队列、自动接线员和共享线路群组），直到标准运行恢复。

#### <mark style="color:蓝色;">SDG 不同于标准运行时使用的分配群组，必须单独创建和维护</mark>

虽然 SDG 提供与标准运行时的分配群组类似的呼叫路由功能，但 SDG 是专门针对生存能力事件 & 活动 &直播的独立群组，因此必须单独创建和维护。换言之，SDG **不会** 继承标准运行时的分配群组（例如呼叫队列、自动接线员、IVR 等）的设置或配置

#### <mark style="color:蓝色;">SDG 最好与 BYOC-PSTN 集成搭配使用，并启用呼叫转接</mark>

虽然 SDG 可以仅提供内部支持（即非 PSTN 呼叫），但最好与 BYOC-PSTN 集成搭配使用。对于启用了 PSTN 的 SDG，在生存能力事件 & 活动 &直播期间启用呼叫转接后，公司主机号码可将呼叫路由到指定的 SDG 电话号码，呼叫将按照配置的路由规则进行转接。这样，企业就能在标准运行恢复之前，为外部呼叫者提供一致的呼叫流程体验。

下图展示了启用 PSTN 的 SDG 的呼叫路由逻辑：

<div data-with-frame="true"><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/5NrGHutNwcJ18M9i7SRf/Unknown%20image" alt=""></div>

#### <mark style="color:蓝色;">可以通过以下方式自定义 SDG</mark>

SDG 支持以下选项：

* 专用分机号码
* 已分配的直接拨入号码
* 时区
* 工作时间
* 录制的问候语
* 群组成员
* 路由至：
  * 用户
  * 互动式语音应答 (IVR) 菜单
  * 群组成员
  * 电话号码
* 呼叫分配：
  * 同时
  * 顺序

### 硬件和网络注意事项

本节介绍 ZPLS 模块、SBC 集成、Zoom 客户端和电话设备的硬件及网络注意事项。阅读本节后，您将了解部署 ZPLS 所需的网络通信和配置。

{% hint style="info" %}
本节专门介绍硬件部署和网络 *设计注意事项*。有关分步部署说明，请参阅 [部署 ZPLS](#_wrba5u2ahyc) 一节。
{% endhint %}

#### <mark style="color:蓝色;">ZPLS 模块部署和网络注意事项</mark>

**ZPLS 模块需要在您的网络中使用静态 IPv4 地址**

ZPLS 模块应部署在内部 LAN 上，并使用 Zoom Phone 设备和桌面客户端可访问的静态 IPv4 地址。目前，ZPLS 模块不支持 IPv6 地址。

**ZPLS 模块必须定期与 Zoom Phone 云建立 HTTPS 连接**

ZPLS 模块需要定期与 Zoom Phone 云建立 HTTPS 连接，以便 [同步账户和用户设置](#_54gf3fuxcnk5).

在大多数情况下，ZPLS 模块可部署在客户网络的内部 LAN 上。在某些情况下，也可以使用 DMZ 网络；不过，网络管理员必须确保能够通过企业防火墙进行通信。无论采用哪种方式，管理员都必须调整企业防火墙策略，以启用 ZPLS 模块与 Zoom 云之间的通信。

**ZPLS 模块必须定期向 Zoom Phone 云发送 OPTIONS ping**

处于空闲状态时，ZPLS 模块必须定期向 Zoom Phone 云发送 OPTIONS 保活 ping，以监控连接状态。如果某个站点内的客户端设备和 ZPLS 模块都失去与 Zoom Phone 云的连接，则受支持的客户端和设备将使用 TLS v1.2 上的 SIP Digest 身份验证注册到 ZPLS 模块。

#### <mark style="color:蓝色;">SBC 部署和网络注意事项</mark>

**应尽可能确保 ZPLS 和 Zoom 云能够访问 SBC**

客户应尽可能确保 SBC 与 ZPLS 模块和 Zoom Phone 云均保持连接。客户可以配置带有私有和公有 IPv4 地址的双网卡 SBC，或者在边缘防火墙上配置静态 1:1 NAT 规则，并开放所需端口。

**SBC 必须在 Zoom Phone 云与 ZPLS 模块之间保持 TLS 和 UDP 连接**

在常规运行期间，SBC 必须同时与 Zoom Phone 云以及关联站点的 ZPLS 模块保持 TLS 和 UDP 连接。此连接用于将可能拨打至 BYOC 列出的电话号码的呼叫进行路由 [并经由 Zoom Phone 云传送](#_zgofkpkt74xr)。ZPLS 与 SBC 之间会自动启用 OPTIONS 保活机制；SBC 与云之间的此机制则为可选。

#### <mark style="color:蓝色;">Zoom 客户端和电话设备注意事项</mark>

**客户端和设备必须能够在局域网内发现站点的 ZPLS 模块**

已启用电话生存能力的客户端和受支持设备 [必须能够](#_ah8xua8wdq10) 在启动过程中从 Zoom Phone 云发现相应的故障转移 ZPLS 模块。不过，该模块必须已 [绑定到电话系统站点](#_k11n5zxkx1pq) 并具有可在内部发现的 IPv4 地址。

**设备应使用静态 IP，或由本地 DHCP 服务器分配私有 IP**

为降低潜在问题的影响，电话设备应使用静态 IP，或由本地 DHCP 服务器分配内部 IP。如果设备未分配静态 IP，或者在生存能力事件期间 DHCP 服务器不可用，电话设备可能无法注册。

**客户端和设备必须定期向 Zoom Phone 云发送 OPTIONS ping**

与 ZPLS 模块类似，受支持的客户端和设备必须定期向 Zoom Phone 云发送 OPTIONS 保活 ping，以确定数据中心的连接状态。发生中断时，客户端会继续发送保活消息，以检测云服务何时恢复并启动正常运行的恢复流程。此过程会自动进行，且无法禁用。

#### <mark style="color:蓝色;">防火墙和网络数据流</mark>

请参阅以下部分： [网络端口和数据流](#_pswiusfsww6t).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://library.zoom.com/technical-library/zh/zoom-workplace/zoom-phone/zoom-phone-local-survivability-field-guide/before-you-begin/pstn-integration-considerations.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
