> 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-tw/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 trunk。客戶應留意，部署在 SBC 的任何 SIP trunk 可能依賴於同一個正在發生中斷的網際網路服務。因此，客戶應考慮為 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 連線，必須在 SBC 上安裝 Zoom 的 [DigitCert 根憑證與中繼憑證](https://support.zoom.us/hc/en-us/articles/360044092031) 。

#### <mark style="color:藍色;">SBC 必須將來電路由至 Zoom Phone 資料中心作為第一與第二路由選擇，ZPLS 模組則作為第三路由</mark>

客戶 SBC 必須先將來自 PSTN 的來電路由至主要與次要 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 trunk</mark>

當存活模式啟用時，從 ZPLS 進入 SBC 的通話必須路由至 PSTN SIP Trunk，以建立外部電話連線。所有撥打至未註冊於 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:藍色;">呼叫轉接設定由管理員或授權使用者在網頁入口網站中設定</mark>

帳戶管理員或授權使用者可以 [設定呼叫轉接邏輯](#_1od0waijmvaz) ，透過網頁入口網站中的 [手動輸入或大量 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 建議企業建立可靠流程，以便在存活事件期間從網頁入口網站啟用呼叫轉接邏輯。
{% endhint %}

#### <mark style="color:藍色;">呼叫轉接規則可套用至整個站點或個別號碼</mark>

在存活事件期間，管理員或授權使用者可從網頁入口網站為整個站點或特定號碼啟用呼叫轉接規則。

#### <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 trunk 相關聯的 BYOC 號碼</mark>

站點的 ELIN **必須** 必須是終止於位於該站點故障轉移 SBC 的 PSTN trunk 上的 BYOC 號碼。不得使用其他類型的號碼。

#### <mark style="color:藍色;">ZPLS 模組將自動把對 ELIN 的緊急服務回呼路由回原先撥號的使用者分機，最長可達 2 小時</mark>

若緊急接線員回撥至 ELIN，ZPLS 模組將把通話路由回發出緊急電話的原始使用者。ZPLS 模組將持續在最長 2 小時內把 PSAP 回撥路由給原始來電者。目前此功能僅限於第一位來電者。

#### <mark style="color:藍色;">一旦電話號碼被指定為 ELIN，就不能再指派給使用者或裝置</mark>

一旦管理員將某個 BYOC 號碼指派為站點指定的 ELIN，除非先取消指派，否則該 BYOC 號碼不能指派給任何使用者或其他 Zoom Phone 實體。

#### <mark style="color:藍色;">客戶有責任維護及更新各站點與其 ELIN 相關聯的實體地址</mark>

Zoom 不負責將與每個 ELIN 相對應的實體地址更新給 BYOC 承運商。客戶有責任確保緊急地址正確對應至適當的實體地址。

### PSTN 路由注意事項

#### <mark style="color:藍色;">當存活模式啟用時，媒體封包會透過 ZPLS 模組路由</mark>

當啟用存活模式時，用戶端不會直接與 SBC 或其他內部用戶端通訊；相反地，媒體封包會透過 ZPLS 模組作為錨點或「hairpin」路由，且不支援媒體卸載。

下圖說明作用中內部與外部通話的信令與媒體路徑。

<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 Invite 的 Request URI 欄位所包含的目的地不符合已註冊分機時，通話才會轉送至 SBC。

{% hint style="info" %}
已註冊分機是指不含站點代碼的短分機、含站點代碼的長分機、已指派的 Zoom 註冊號碼，或已指派的 BYOC 號碼。管理員應留意，ZPLS 模組會更新此資料 [每 10 小時一次](#_54gf3fuxcnk5).
{% endhint %}

#### <mark style="color:藍色;">在存活事件期間，外部外撥電話將顯示使用者的 BYOC 號碼</mark>

在存活事件期間，來自 ZPLS 註冊裝置的外部外撥電話將包含 BYOC 來電號碼。下圖說明使用者的存活模式通話流程：

<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 Cloud 之間的通訊。

**ZPLS 模組必須與 Zoom Phone 雲端保持定期 OPTIONS ping**

在閒置狀態下，ZPLS 模組必須與 Zoom Phone 雲端維持 OPTIONS keepalive ping，以監控連線狀態。若站點內的用戶端裝置與 ZPLS 模組都與 Zoom Phone 雲端失去連線，支援的用戶端與裝置將透過 TLS v1.2 上的 SIP Digest Authentication 註冊至 ZPLS 模組。

#### <mark style="color:藍色;">SBC 部署與網路注意事項</mark>

**在可行的情況下，SBC 必須可從 ZPLS 與 Zoom 雲端存取**

客戶應確保 SBC 在可行的情況下，能維持與 ZPLS 模組及 Zoom Phone 雲端的連線。客戶可以部署配置有私有與公有 IPv4 位址的雙 NIC SBC，或確保邊緣防火牆上已建立靜態 1:1 NAT 規則，並開啟所需連接埠。

**SBC 必須維持 Zoom Phone 雲端與 ZPLS 模組之間的 TLS 與 UDP 連線**

在正常運作期間，SBC 必須同時維持對 Zoom Phone 雲端及相關站點 ZPLS 模組的 TLS 與 UDP 連線。此連線用於路由任何可能撥打至 BYOC 列名電話號碼的通話 [透過 Zoom Phone 雲端](#_zgofkpkt74xr)。OPTIONS keepalive 機制會在 ZPLS 與 SBC 之間自動啟用，而在 SBC 與雲端之間則為選用。

#### <mark style="color:藍色;">Zoom 用戶端與電話裝置注意事項</mark>

**用戶端與裝置必須能在本地區域網路中探索到站點的 ZPLS 模組**

用戶端與支援的裝置 [已啟用電話存活功能](#_ah8xua8wdq10) 在開機過程中，會從 Zoom Phone 雲端探索適當的故障轉移 ZPLS 模組。然而，該模組必須已經 [綁定至電話系統站點](#_k11n5zxkx1pq) 並具有可由內部探索的 IPv4 位址。

**裝置應具有靜態 IP，或由本地 DHCP 伺服器指派私有 IP**

為降低潛在問題，電話裝置應透過本地 DHCP 伺服器指派靜態或內部 IP。若裝置未指派靜態 IP，或在存活事件期間 DHCP 伺服器不可用，電話裝置可能無法註冊。

**用戶端與裝置必須與 Zoom Phone 雲端定期維持 OPTIONS ping**

與 ZPLS 模組類似，支援的用戶端與裝置必須維持與 Zoom Phone 雲端的 OPTIONS keepalive ping，以判定資料中心連線狀態。若發生中斷，用戶端會持續傳送 keepalive 訊息，以偵測雲端服務恢復並啟動恢復正常運作。此流程為自動化，且無法停用。

#### <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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.