> For the complete documentation index, see [llms.txt](https://help.firstline.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.firstline.cc/feature/channels/live-chat/yi-nan-za-zheng.md).

# 疑難雜症

## 無法顯示即時聊天

在某些情況下，您可能不會在網站上看到您期望的 FIRST LINE 即時聊天。讓我們找出原因。有許多原因可能導致即時聊天無法顯示。了解以下最常見的原因：

### 檢查允許的網域

如果您在即時聊天中遇到顯示問題，例如無法讀取畫面。這可能是因為您的「允許的網域」設定中未包含嵌入網站的網域。為了確保順利使用聊天功能，請檢查您的設定，新增相應的網域。

<figure><img src="/files/gAGgioiXYmWJdO3sG1hO" alt=""><figcaption></figcaption></figure>

### **檢查 HTML**

首先，請確保您的網站正確包含了即時聊天的 HTML 置入程式碼。您可以按照以下步驟進行檢查：

* 使用瀏覽器造訪您的網站。
* 右鍵點擊頁面上的某個位置，然後選擇“查看頁面原始碼”。
* 在原始碼中，搜尋 “firstline” 文字。

如果您在頁面原始碼中找不到包含“firstline”關鍵字的相應程式碼：

* 請確認您已在所有網站頁面上嵌入了聊天框的程式碼。
* 檢查是否在網站前端運行了任何快取機制。如果有，請嘗試清除所有快取。例如，如果您使用 Cloudflare，可能需要執行相應的清除操作。

<figure><img src="/files/ZzQoBbcT6cZgJifXt3Fr" alt=""><figcaption></figcaption></figure>

### 檢查 JavaScript 是否運作

FIRST LINE 即時聊天多數透過 JavaScript 來處理資料的運作。在某些特定情況下，比如瀏覽器的安全性設定或是公司的內容安全政策（CSP），可能會對 JavaScript 的運作造成影響。如果您遇到 FIRST LINE 聊天框無法正確顯示的問題，以下是一些解決方案：

#### **停用內容檢查模式**&#x20;

暫時停用瀏覽器的內容檢查模式，然後檢查 即時聊天是否顯示。這樣可以確保沒有任何內容檢查模式干擾 FIRST LINE 即時聊天的執行。

#### CSPv3 **設定**

FIRST LINE 即時聊天現已全面支援 [Google strict CSPv3](https://csp.withgoogle.com/docs/strict-csp.html) 安全政策。這項 Google 政策為多數網路服務提供了更高的安全標準，同時確保了服務的順暢運作：

```
Content-Security-Policy:
  object-src 'none';
  script-src 'nonce-{random}' 'unsafe-inline' 'unsafe-eval' 'strict-dynamic' https: http:;
  base-uri 'self';
```

為了確保 FIRST LINE 即時聊天能在您的網站上順暢運作，如果您有設定內容安全政策（CSP），請檢查一是否包含了必要的指令。您需要在 script-src 指令中加入 'self'、'unsafe-inline' 以及 'unsafe-eval' 這三項。

* `'unsafe-inline'`：允許在網頁使用內嵌(inline)的 JavaScript 代碼或者樣式 CSS。
* `'unsafe-eval'`：允許使用 eval 方式執行 text-to-JavaScript 機制。

這兩項設定將有助於即時聊天工具的正常運作。

<figure><img src="/files/RTaObnhFEwqfgBU6KMki" alt=""><figcaption><p>透過瀏覽器開發工具可以檢視相關原因</p></figcaption></figure>

#### 瀏覽器擴充功能干擾

某些瀏覽器擴充功能，可能會阻止一些網頁元素的載入，這可能包括即時聊天。如果您確定您的瀏覽器中啟用了這類擴充功能，請嘗試停用它們，然後重新載入頁面，看看是否解決了問題。有時，您還可以將特定網站列入擴充功能的例外列表，以確保這些擴充功能不會干擾 FIRST LINE 的功能。

### DOS 保護

我們的網路會自動阻止潛在的 DOS 攻擊。如果太多使用者在同一 IP 下連接到 FIRST LINE 即時聊天，將引發 420 錯誤。如果您在使用 FIRST LINE 即時聊天的過程中遇到 420 錯誤，請確保您的使用者並非故意或非法地觸發這個錯誤。同時，您可能需要藉由調整您的網路安全策略，以確保其他用戶能夠順利使用即時聊天服務。
