# 疑難雜症

## 無法顯示即時聊天

在某些情況下，您可能不會在網站上看到您期望的 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 錯誤，請確保您的使用者並非故意或非法地觸發這個錯誤。同時，您可能需要藉由調整您的網路安全策略，以確保其他用戶能夠順利使用即時聊天服務。


---

# Agent Instructions: 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:

```
GET https://help.firstline.cc/feature/channels/live-chat/yi-nan-za-zheng.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.