# 聯絡人

## 什麼是聯絡人？ <a href="#what-is-contact" id="what-is-contact"></a>

**聯絡人**(Contact)是 MaiAgent 的核心功能之一，就像企業的「客戶名片夾」。它讓企業能夠為每位客戶建立專屬的身份檔案，確保每次對話都能提供個人化的服務體驗。

{% hint style="info" %}
**簡單理解：**

聯絡人就像是「客戶資料卡」，記錄了客戶的身份和權限。當客戶來訪時，AI 助理會根據這張資料卡決定要提供什麼樣的服務和內容。
{% endhint %}

<figure><img src="/files/WSZDQxMmW19CQrDiR3cY" alt=""><figcaption><p>身分識別範例</p></figcaption></figure>

想像一下，當客戶透過網站聊天室與您互動時，系統能立即識別「這是張先生，他是 VIP 會員」或「這是新訪客，只能開放部分文件」，並據此提供相應的服務內容和權限。

## 為什麼需要聯絡人功能？ <a href="#why-contact-feature" id="why-contact-feature"></a>

### **個人化服務體驗** <a href="#personalized-service" id="personalized-service"></a>

每位客戶都有獨特的需求和背景，聯絡人功能讓 AI 助理能夠：

* 記住與該客戶的對話歷史
* 根據客戶身份提供合適的資訊
* 避免重複詢問已知資訊

### **精確的權限管理** <a href="#precise-permission-management" id="precise-permission-management"></a>

不同客戶應該看到不同的內容：

* VIP 會員可以查看專屬優惠
* 一般會員看到標準服務內容
* 訪客只能使用公開資訊

### **資料安全保護** <a href="#data-security" id="data-security"></a>

* 確保客戶只能存取屬於自己的資料，防止資訊洩露。

## 聯絡人如何運作？ <a href="#how-contact-works" id="how-contact-works"></a>

當使用者展開對話框後，對話請求會被送入企業內部系統進行處理，判斷是否已有會員資訊帶入，根據判斷結果決定尋找/建立聯絡人(匿名或非匿名)。無論走哪條路徑，最終都會展開個人化對話，確保每位使用者都能獲得適合的個人化體驗。

聯絡人運作示意圖

<figure><img src="/files/zf1Qimm0hhhLzsb9aB1m" alt=""><figcaption><p>聯絡人運作示意圖</p></figcaption></figure>

## 聯絡人類型說明 <a href="#contact-types" id="contact-types"></a>

MaiAgent 的聯絡人系統根據用戶身份識別方式，分為兩種類型：

{% hint style="info" %}
**簡單理解：**

* **匿名聯絡人** = 沒有登入的訪客，系統不知道他是誰
* **非匿名聯絡人** = 已登入的會員，系統知道他的身份和資料
  {% endhint %}

## 聯絡人類型比較表格 <a href="#contact-type-comparison" id="contact-type-comparison"></a>

<table><thead><tr><th width="104.83331298828125">項目</th><th>匿名聯絡人</th><th>非匿名聯絡人</th></tr></thead><tbody><tr><td><strong>適用情況</strong></td><td>從網頁直接進入的訪客，並未登入企業會員系統，因此沒有帳號可以對應取得使用者資料</td><td>已登入的會員或透過其他平台帳號進入（如 Facebook、LINE 等），系統能夠取得使用者姓名和帳號資訊</td></tr><tr><td><strong>身份識別</strong></td><td>無法取得具體的個人資訊</td><td>擁有明確的身份識別資訊(如：姓名、大頭照等)</td></tr><tr><td><strong>系統設定</strong></td><td>在 MaiAgent 系統內設定為「匿名」</td><td>原本的會員帳號 ID 將轉換為 Source ID</td></tr><tr><td><strong>權限管理</strong></td><td>知識庫文件權限、對話平台管理</td><td>兩者相同</td></tr><tr><td><strong>資料對應</strong></td><td>無 Source ID，無法對應企業會員資料</td><td>透過來源 ID 確保聯絡人每次都能對應到正確的使用者</td></tr><tr><td><strong>建立方式</strong></td><td>若為訪客(未帶有會員身分)進入，每個對話會自動建立一個新的匿名聯絡人</td><td>系統根據會員登入資訊透過 MaiAgent API 自動建立或更新<br>詳細串接內容請參考：<a href="https://docs.maiagent.ai/tech/authorization-integration/contacts">技術人員手冊—聯絡人(Contact) 介紹及串接</a></td></tr><tr><td><strong>記錄機制</strong></td><td>系統會依快取記錄使用者的對話紀錄</td><td>透過 Source ID、聯絡人對應維持對話連續性</td></tr></tbody></table>

{% hint style="info" %}
**來源 ID (Source ID) 的重要性**

**來源 ID** 是連結 MaiAgent 聯絡人與企業會員系統的關鍵橋樑。當使用者透過不同管道（網站、APP、社群平台）與企業互動時，系統都能透過來源 ID 正確識別使用者身份，確保對話的連續性和個人化體驗。

\*\*簡單理解：\*\*來源 ID 就像是「會員編號」，讓系統能夠在不同平台上都認得同一個客戶。
{% endhint %}

## 設定聯絡人 <a href="#setup-contact" id="setup-contact"></a>

### 匿名使用者 <a href="#anonymous-user" id="anonymous-user"></a>

使用者建立新對話，系統自動在後台建立新匿名使用者(每個對話都是一位匿名使用者)⬇️

<div><figure><img src="/files/8oG9RYxGbBU0r6FhGyis" alt=""><figcaption></figcaption></figure> <figure><img src="/files/b3BfeFma9Mr7ovQeyw9D" alt=""><figcaption></figcaption></figure></div>

包含聯絡人 ID、對話平台紀錄、建立時間等資訊

您可以點選編輯，手動編輯匿名聯絡人資訊：

<div><figure><img src="/files/xRZaQbjfXIrGdkZ4rYKV" alt=""><figcaption></figcaption></figure> <figure><img src="/files/XnnkHjoVMoa07xTruPBK" alt=""><figcaption></figcaption></figure></div>

**透過編輯**，您可以：

* 變更連結會員資訊：透過輸入來源 ID ，將匿名聯絡人連結到會員資料
* 更新權限等級：開放、限制更多文件讀取的範圍
* 補充客戶姓名、聯絡方式等基本資料

### 非匿名使用者 <a href="#non-anonymous-user" id="non-anonymous-user"></a>

使用者使用其他對話平台進入(如：LINE、FB Messenger、Telegram)：

後台會自動根據 FB 使用者資訊，建立對應非匿名使用者(包含來源 ID、聯絡人姓名、大頭照等)：

<div><figure><img src="/files/Cqs2ThXruY3qOfFYFplB" alt=""><figcaption></figcaption></figure> <figure><img src="/files/3pthJ0LRIvqE9UgWE6Rw" alt=""><figcaption></figcaption></figure></div>

您仍然可以點按編輯按鈕，編輯非匿名聯絡人資訊

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

**透過編輯，您可以：**

補全與修正資料

* 修正錯誤的查詢元資料設定 ( 根據權限更新開放範圍 )
* 修改企業內來源 ID，連結正確的聯絡人資訊與會員資訊

{% hint style="danger" %}
聯絡人依賴來源 ID 進行對應，因此編輯時請確保來源 ID 與企業內部同步，否則恐會造成後續程式上與企業內部資訊同步時資料對應錯誤。
{% endhint %}

### 新增聯絡人 <a href="#add-contact" id="add-contact"></a>

新建聯絡人功能主要用於**主動建立具有預設權限的客戶檔案**，若您並未在 Web Chat 中指定權限範圍，您可以預先建立聯絡人，在客戶實際發起對話前，就完成權限配置和服務準備。

{% hint style="info" %}
欲在 Web Chat 初始化中使用 javascript 腳本指定權限範圍，請參考：[技術人員手冊：開始建構—使用 JSON 格式](https://docs.maiagent.ai/tech/authorization-integration/zhi-shi-guan-li-quan-xian-query-metadata-cha-xun-yuan-zi-liao-zong-lan/json-interfaces#webchat-chu-shi-hua-she-ding)
{% endhint %}

#### 核心功能說明 <a href="#core-features" id="core-features"></a>

透過手動新建聯絡人，系統管理員可以預先在客服系統中建立特定身份的使用者檔案，並為其配置相應的**查詢元資料權限**(Query Metadata)。當這些預建的聯絡人日後透過**指定對話平台**進行客服互動時，系統將透過**來源 ID 自動比對機制**，立即套用預先設定的權限等級，確保他們能夠存取到符合其身份的資料內容。

{% hint style="info" %}
**簡單理解：**

就像是「提前準備好客戶的權限設定」。當這個客戶第一次來訪時，系統就已經知道他可以看什麼資料、不能看什麼資料。
{% endhint %}

您可以點按新增聯絡人，進入編輯頁面加入資訊：

<div><figure><img src="/files/hDEjcvCqV9ax4fPrFSNX" alt=""><figcaption></figcaption></figure> <figure><img src="/files/qBLd7SqUy2frwAPREyeD" alt=""><figcaption></figcaption></figure></div>

頁面中，您可以加入聯絡人姓名、指定對話平台等資訊：

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

## 權限管理 <a href="#permission-management" id="permission-management"></a>

根據企業的需求，您可以使用查詢元資料限制不同的聯絡人使用文件的範圍，如：

#### 按會員等級限制 <a href="#restrict-by-membership-level" id="restrict-by-membership-level"></a>

* **VIP會員**：可查詢所有知識庫、高級FAQ、產品技術文件
* **一般會員**：僅能查詢基礎FAQ、產品使用手冊
* **訪客用戶**：只能查詢公開FAQ、基本產品介紹

#### 按部門權限區分 <a href="#restrict-by-department-permission" id="restrict-by-department-permission"></a>

* **內部員工**：可查詢內部操作手冊、系統維護文件、完整產品資料
* **經銷商**：能查詢產品規格、價格表、銷售資料
* **一般客戶**：僅限查詢使用說明、常見問題、保固資訊

#### 按產品標籤分類 <a href="#restrict-by-product-tag" id="restrict-by-product-tag"></a>

* **企業版用戶**：可查詢標籤為「企業功能」、「進階設定」的文件
* **個人版用戶**：只能查詢標籤為「基礎功能」、「個人使用」的文件
* **試用用戶**：僅能查詢標籤為「試用說明」、「入門指南」的內容

{% hint style="info" %}
欲了解查詢元資料，請參考：[知識管理權限：查詢元資料](/org/querymetadata.md)
{% endhint %}

在聯絡人中，設定查詢元資料時，系統只會授權您根據您指定的對話平台知識庫進行設定，若針對其他對話平台的知識庫設定將會出現以下警示訊息：

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

## 自動化整合 <a href="#automation-integration" id="automation-integration"></a>

對於技術團隊，MaiAgent 也提供 API 接口，能與企業現有系統無縫整合

{% hint style="info" %}
詳情請參考：[技術人員手冊—聯絡人介紹及串接](https://docs.maiagent.ai/tech/authorization-integration/contacts)
{% endhint %}

無論企業規模大小，聯絡人功能都能幫助您提供更好的客戶服務體驗，同時確保資料安全和營運效率。透過匿名與非匿名聯絡人的分類管理、來源 ID 的精確對應機制，以及靈活的建立方式，企業能夠為不同類型的用戶提供最適合的服務體驗，並在客戶互動前就做好充分準備。


---

# 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://docs.maiagent.ai/org/contact.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.