> 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/admin/dang-an-guan-li.md).

# 檔案管理

## 概述

FIRST LINE 提供集中管理檔案的功能。透過知識庫上傳圖片、在服務台回覆顧客附件，或於其他功能中使用檔案時，可以在檔案管理中查看相關檔案資訊，並視需求管理公開權限與分享連結。

<figure><img src="https://842546780-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MNRu7dk70ei7JV9HlW9%2Fuploads%2F6Gxshu748ijpjQytEDjO%2Fimage.png?alt=media&amp;token=64b02fb1-debb-47fc-854c-6814547772f5" alt=""><figcaption></figcaption></figure>

## 檔案上傳與基本資訊

透過檔案管理上傳單一檔案時，系統的檔案建立介面限制約為 **25 MB**。不同功能可能有自己的附件數量、大小或格式要求，仍應以各功能的說明為準。

檔案資料包含檔名、檔案大小、檔案類型、上傳者與建立時間等資訊。檔名與是否允許公開可在檔案管理的對應功能中調整。

{% hint style="info" %}
檔案建立 API 在沒有特別指定公開設定時，預設允許公開。不過，不同功能可能自行指定公開狀態，因此不能假設所有上傳的檔案都會自動公開。
{% endhint %}

## 公開與非公開檔案

檔案的「允許公開」設定，決定外部使用者能否透過一般分享連結存取該檔案：

* **允許公開**：外部使用者可以透過有效的分享連結存取檔案，不需要登入 FIRST LINE。
* **不允許公開**：一般分享連結不會直接授予未登入的外部使用者存取權限。

允許公開不代表檔案會自動出現在公開網站，仍需要取得對應的連結。另一方面，只要持有可用的公開連結，就可能存取其指向的檔案；分享前請確認內容適合提供給對方。

## 檔案分享連結管理

同一個檔案可以建立多個分享連結，方便依用途分別管理。進入檔案的編輯或分享管理區域，可查看現有連結，以及新增或移除分享連結。

每個分享連結都有獨立產生的隨機識別碼，並可搭配下列存取條件：

| 設定     | 說明                                     |
| ------ | -------------------------------------- |
| 有效期限   | 可指定連結的到期時間；若未設定，則不會因時間到期而停止使用。         |
| 存取次數限制 | 可限制連結允許存取的次數；設定為 0 代表不限制次數。            |
| 檔案公開權限 | 即使分享連結仍在有效期限內，未登入的外部使用者也必須符合檔案允許公開的條件。 |

不同分享連結可以有不同的限制設定，不需要為每種分享用途重複上傳同一份檔案。

<figure><img src="https://842546780-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MNRu7dk70ei7JV9HlW9%2Fuploads%2FG1zgXNWzLxJTH8yHIS4Y%2Fimage.png?alt=media&amp;token=547cd362-f04e-46cc-9fb7-0e37adf4711d" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
分享網址的隨機識別碼可降低被猜中的可能性，但網址本身不是個人身分驗證機制。若連結被轉寄或公開，其他取得連結的人也可能存取檔案。對於需要限制分享期間或存取範圍的內容，建議設定適當的有效期限及存取次數限制。
{% endhint %}

## 預覽、下載與刪除

分享連結可用於開啟檔案，系統亦提供下載檔案的方式。部分圖片或文件可以由瀏覽器直接顯示；實際能否在瀏覽器內預覽，仍取決於檔案格式及瀏覽器支援能力。

**移除分享連結**與**刪除檔案**是兩種不同操作：

* 移除分享連結：使該連結不再可用，不等於刪除原始檔案或其他分享連結。
* 刪除檔案：移除檔案管理中的檔案紀錄，系統也會刪除對應的儲存檔案。操作前應確認是否仍有其他功能需要使用該附件。

## 哪些情境會使用公開檔案？

部分功能需要讓顧客或第三方通訊平台取得檔案內容，因此會使用對外可存取的檔案網址，例如：

1. **服務台發送圖片**：部分文字管道需要透過外部可讀取的圖片網址，將圖片顯示在顧客的交談中。
2. **電子郵件附件**：使用連結附件形式時，顧客可透過信件中的網址取得檔案；若選用標準信件附件，則採用不同的傳遞方式。
3. **知識庫等功能引用檔案**：若內容需要提供給外部顧客，應確認對應檔案與分享方式符合預期。

不同通訊管道的圖片、影片及一般附件顯示方式並不完全相同，詳見[各管道訊息類型支援度](https://help.firstline.cc/feature/other/ge-guan-dao-xun-xi-lei-xing-zhi-yuan-du.md)；電子郵件的附件傳遞方式請參考[電子郵件附件](https://help.firstline.cc/feature/channels/email/dian-zi-you-jian-fu-jian.md)。
