戰國策AI客服系統教學

完整的AI客服系統教學使用指南，從基礎設定到進階功能

快速導航

問題支援中心 - 故障排除

對話管理

對話狀態：已讀、封存、刪除、還原。

清空垃圾桶會永久刪除。
封存或刪除的對話，若用戶再次傳訊會自動還原。
對話刪除 30 天後自動清除。
刪除用戶會刪除其所有對話。

文字編輯器與自動訊息

支援：

連結自動轉換超連結（可加上 #sb-example 來命名）。
格式語法：
- 粗體：*文字*
- 斜體：__文字__
- 刪除線：~文字~
- 程式碼： `文字` 或文字
換行：Shift+Enter / Ctrl+Enter

合併欄位

{user_name} → 使用者姓名
{user_email} → 使用者信箱
{agent_name} → 代理姓名
{agent_email} → 代理信箱

富訊息（Rich Messages）

富消息是具有按鈕、下拉式選單或輸入框等互動功能的特殊訊息。它們允許客服人員透過使用者輸入表單向使用者要求資訊或顯示互動式內容。富消息可以使用短代碼插入聊天訊息中。短代碼接受各種參數，例如標題和描述。可用的富消息列表如下。

創建並發送：透過在管理區域的文字編輯器中插入短代碼來建立富文本訊息。使用您的資訊自訂所有參數，然後發送訊息。
顯示訊息：當使用短代碼時，使用者會看到豐富的訊息（而不是短代碼）並可以選擇或輸入所需資訊來完成表單提交。
用戶的回覆已提交：一旦用戶填寫並發送了富消息表單，就會顯示成功訊息並儲存表單資料。

富訊息（Rich Messages）

名稱	短代碼（Shortcode）	說明
卡片（Card）	`[card image="URL" header="標題" description="Lorem ipsum dolor sit amete" link="URL" link-text="購買" extra="$599" target="_blank"]`	帶有圖片、標題、描述、連結等元素的行動號召卡片。
滑動卡片（Slider）	`[slider image-1="URL" header-1="標題" description-1="Lorem ipsum dolor sit amete" link-1="URL" link-text-1="購買" extra-1="$599" image-2="URL" header-2="標題" description-2="Lorem ipsum dolor sit amete" link-2="URL" link-text-2="購買" extra-2="$599" target="_blank"]`	含有圖片、標題、描述、連結等元素的行動號召卡片輪播。最多可加入 10 張投影片。
圖片輪播（Slider images）	`[slider-images images="URL,URL,URL"]`	圖片輪播。
Chips	`[chips options="A,B,C"]`	按鈕清單。
按鈕（Buttons）	`[buttons options="A,B,C"]`	按鈕清單。
下拉選單（Select）	`[select options="A,B,C"]`	下拉式選項清單。
輸入欄位（Inputs）	`[inputs values="A,B,C" button="立即送出"]`	文字輸入欄位清單。
電子郵件（Email）	`[email name="true" last-name="true" phone="true" phone-required="false" placeholder=""]`	用於收集使用者電子郵件與電話的表單。所有屬性皆為選填。追蹤設定作為預設值；在訊息 App 可用 `required-messaging-apps="true"` 強制提供 email 與電話。支援合併欄位。
時間表（Timetable）	`[timetable]`	時間表。
文章（Articles）	`[articles link="https://board.support/articles-demo"]`	含搜尋區的文章。`link` 於 Messenger／WhatsApp／Telegram 中作為後備訊息。
清單（List）	`[list values="A,B,- C,- D,E" numeric="true"]`	文字清單。項目前加 `-` 變成內層項目。
雙欄清單（List double）	`[list values="A:X,B:Y,C:Z"]`	鍵值式標題＋內容清單。
圖文清單（List image）	`[list-image values="URL:A,URL:B,URL:C"]`	含標題與圖片的文字清單。
表格（Table）	`[table header="A,B,C" values="A:B:C,A:B:C,A:B:C"]`	表格。
單一按鈕（Button）	`[button link="https://board.support" name="點此前往" target="_blank" style="link"]`	顯示連結或開啟文章。`target="_blank"` 新視窗、`style="link"` 改樣式；若要開啟文章，`link` 需為 `#article-ID`（以文章 ID 取代）。
影片（Video）	`[video type="youtube" id="0TImic4N1ko" height="350"]`	顯示 YouTube 或 Vimeo 影片；`type`：`youtube`/`vimeo`，`id` 為影片 ID（由網址取得），`height` 為選填（px）。
圖片（Image）	`[image url="https://board.support/media/admin.png"]`	圖片。
分享（Share）	`[share fb="https://board.support/" tw="https://board.support/" li="https://board.support/" pi="https://board.support/" wa="https://board.support/"]`	社群分享按鈕。

特殊字元

若訊息包含 , : 或 "，需加上 \。
例如： \, \: \"

全域參數（Global parameters）

所有富訊息（rich messages）都支援以下參數：

參數	說明
`id="123"`	此富訊息的 ID（也用於儲存 JSON 資料）。
`title="ABC"`	富訊息標題。
`message="ABC"`	顯示在標題下方的富訊息描述。
`success="ABC"`	當使用者完成並送出富訊息後顯示的訊息；使用者輸入會附加在此訊息後。
`settings="ABC"`	額外欄位，用於可選的附加值。

內建訊息（Built-in messages）

內建訊息是由 Support Board 自動傳送的預程式訊息。可於「設定 > 訊息」找到並設定。

歡迎訊息（Welcome message）

在新訪客第一次造訪網站時傳送一則訊息。

支援文字格式化。
支援合併欄位（Merge fields）。
支援富訊息。
不會傳送到 Slack。
僅包含歡迎訊息且無回覆的對話，會自動封存。

後續訊息（Follow up message）

若在指定時間內沒有代理回覆，系統會傳送訊息向使用者索取資料（例如電子郵件）。

支援文字格式化。
支援合併欄位。
可在「後續電子郵件」欄位填寫內容，以寄送確認郵件給使用者。
若未設定延遲時間，系統會採用動態時間：若「設定 > 其他 > 上班時間」已設定且目前時間在上班時段內，或至少有一位代理在線，延遲為 15 秒；其他情況延遲為 5 秒。
後續訊息每 24 小時最多發送一次。
若使用者提供了電子郵件，且已啟用電子報功能，該電子郵件會被訂閱。
僅會傳送給沒有電子郵件的使用者。
啟用聊天機器人的「人工接管」時，後續訊息只在接管期間發送。

附件（Attachments）

此處說明檔案上傳與訊息附件的相關資訊。

會自動顯示的圖片格式：.jpg、.jpeg、.png
可上傳的附件副檔名設定於 supportboard/include/upload.php
可在安裝目錄的 config.php 新增允許的副檔名：
定義方式：define("SB_FILE_EXTENSIONS", ["exe", "abc", ...])
請將 ["exe", "abc", ...] 替換為您想允許的副檔名陣列。
關於在聊天機器人中傳送附件的教學，請點此參閱。
上傳目錄位置：
PHP 版本預設為 supportboard/uploads
WordPress 版本預設為 wp-content/uploads/sb
可在設定檔中自訂，亦支援上傳至 AWS S3。

資訊（Information）

此處提供與對話相關的各種功能資訊。

標籤（Tags）

標籤有助於更有效地組織與分群對話，詳情如下：

可於「設定 > 管理 > 標籤」管理標籤。
指派標籤的方法包含：管理後台的「設定 > 自動化 > 更多」、透過 Dialogflow 的動作、或在載入聊天的頁面插入 JS 變數 SB_DEFAULT_TAGS。
要搜尋特定標籤的對話，可在管理端對話區左上方的搜尋列輸入標籤名稱，或在左上方的篩選選單選擇標籤。只有當至少有一則對話已被指派標籤時，標籤篩選才會顯示。
勾選「Starred tag」選項可在對話區顯示星號標籤圖示，方便一鍵篩選第一個標籤（最上方的標籤永遠是星號標籤）。
可於「設定 > 管理 > 停用功能 > 標籤」停用標籤功能。

備註（Notes）

備註讓代理與管理員可在對話中新增僅內部可見的評論。

備註僅代理與管理員可見。
若您使用 OpenAI，建議啟用「備註資料擷取」選項。
可於「設定 > 管理 > 備註設定」調整備註相關設定。
可於「設定 > 管理 > 停用功能 > 備註」停用備註功能。

謄本（Transcript）

代理或管理員可將完整對話以「對話謄本檔」寄送給使用者。

在管理端對話視窗右上角點選「Transcript」按鈕即可寄送。
也可在對話封存時自動寄送：使用「設定 > 訊息與表單 > 關閉訊息」中的關閉訊息功能。
僅當使用者具備電子郵件時，才能寄送謄本。
若對話曾被翻譯，謄本中也會包含翻譯後的訊息。

使用者（USERS）

管理使用者（Manage users）

在管理端左側選單的「使用者」區域管理所有使用者。

匯入使用者（Import users）

可於「設定 > 使用者 > 匯入使用者」匯入，僅支援 CSV。可在此下載範例 CSV。
範例檔首列為標題列，其中 Height 與 Hair color 為自訂使用者欄位，可於「設定 > 使用者 > 自訂欄位」新增。

搜尋使用者（Search users）

可依姓名、姓氏、電子郵件與自訂欄位搜尋。

刪除使用者（Delete users）

開啟使用者編輯視窗後點選「Delete user」即可刪除。
若要批次刪除，先在使用者列表勾選多名使用者，再點右上角的刪除圖示。

刪除使用者後，其所有對話與訊息會被永久刪除。
對話附件也會永久刪除；若啟用 AWS S3，S3 上的檔案亦會刪除。
若被刪除的使用者再次回到網站，系統會自動建立新使用者。
訪客（visitor）會每 24 小時自動清除。

使用者類型（User types）

類型（Type）	說明（Description）
`user`	任何擁有電子郵件的使用者。
`lead`	沒有任何使用者詳細資料、會被自動註冊，且至少有一則對話的使用者。
`visitor`	尚未開始任何對話的使用者。注意：訪客會每 24 小時自動刪除。

管理代理與管理員（Manage agents and admins）

可於「使用者」區管理、建立與刪除代理與管理員。

代理權限與許可設定：在「設定 > 管理 > 代理權限」。
可在「設定 > 管理 > 主管」建立「主管（Supervisor）」。主管是具特定權限的特別代理，必須是管理員。可用逗號分隔多個管理員 ID 新增多位主管。
建立代理或管理員：到「使用者」區點右上角「Add user」。
只有代理與管理員可以登入 Support Board 的管理端。
在 WordPress 啟用外掛時，系統會以目前登入者的相同帳密自動建立一個管理員帳戶。

收集使用者資料（Collect user details）

可透過多種方式收集使用者資料（如姓名與電子郵件）：

以「註冊表單」作為「聊天前表單」（pre-chat form）。
透過「後續訊息」。
透過「聊天機器人流程」。

註冊（Registration）

註冊表單是一個聊天前表單，要求使用者在開始聊天前先輸入特定資訊。

您可以只要求最少欄位（例如只要電子郵件或姓名），將註冊表單作為簡化的聊天前表單。
僅當啟用電子郵件欄位時，才會顯示登入表單。
當使用者系統設為「WordPress」時，密碼欄位會一律顯示。
您可以透過網址參數自動讓使用者登入。

資訊（Information）

雜項（Miscellaneous）

新使用者會即時顯示在使用者清單表格中。
若要檢視線上使用者，請啟用「設定 > 使用者 > 註冊所有訪客」。
若要收到「線上使用者通知」，請同時啟用下列選項：
- 設定 > 通知 > 線上使用者通知
- 設定 > 其他 > Pusher（若您使用雲端版本，此設定會自動啟用）
- 設定 > 使用者 > 註冊所有訪客（預設已啟用）
  此功能涵蓋所有使用者類型，包括訪客與潛在客戶（leads）。同一位使用者在 24 小時內只會收到一次通知。
代理與管理員可在左下角的個人檔案面板設定自身為線上或離線。若啟用「設定 > 通知 > 離席模式」，當代理或管理員在管理端連續至少 10 分鐘無任何操作（未點擊、未移動滑鼠、未按鍵），離線狀態會自動啟用。此自動離線不適用於行動裝置。為確保此功能正常運作，應啟用 Pusher。
使用者清單表格採自動分頁，每次捲動最多載入 100 筆結果。

登入驗證 URL（Login verification URL）

此功能位於「設定 > 使用者 > 登入驗證 URL」。它允許 Support Board 對外部來源的登入進行驗證，並自動註冊與登入使用者。
Support Board 會向指定的 URL 發送請求，並將使用者在聊天登入表單輸入的電子郵件與密碼，以 URL 參數附加在該請求後方。參數名稱為 email 與 password。
範例：
https://example.com/login.php?email=example@mail.com&password=12345678

該 URL 應回傳如下的 JSON 物件：

{ "first_name": "John", "last_name": "Doe", "email": "johon@example.com", "profile_image": "https://board.support/user.svg", "department": null, "password": "", "details": { "location": [ "Location", "New York, United States" ], "country_code": [ "Country code", "America/New_York" ] } }

其中 first_name 為必填欄位。

設定（SETTINGS）

上班時間（Office hours）

您可在「設定 > 其他 > 上班時間」設定時間表。上班時間用於：

傳送離線訊息。
在非上班時間停用並隱藏聊天。
在一般上班時間停用聊天機器人、於非上班時間啟用聊天機器人。

更多資訊：

在時間表中留白的欄位被視為非上班時間。若需將整天設為非上班時間，請填入 CLOSED。
上班時間以 UTC 表示。您的 UTC 位移可於「設定 > 其他 > UTC 位移」自動產生。請先留空，然後點擊空欄位，系統會自動產生正確值。僅接受整數。若您的位移不是整數（例如 UTC -12:30 或 -12:45），請嘗試尋找替代的整數 UTC 位移；若無法找到，需手動在時間表中調整時段以修正差異。
時間表的日期與時間格式會自動比照使用者瀏覽器語系所屬國家的格式。

文章（Articles）

知識庫文章可即時提供答案，降低客服量。可自左側選單進入「Articles」。

語言與翻譯（Language and translations）

Support Board 完整支援多語，並可即時偵測使用者語言。

編輯翻譯

若要編輯聊天端與管理端語言，請至「設定 > 翻譯」。部分設定（如郵件內容）可直接在各自設定中翻譯，無須於此處調整。

聊天語言（Chat language）

Support Board 已翻譯為 41 種語言，可用多種方式設定語言：

選項一

到「設定 > 聊天」勾選「語言」並設為「多語」，系統將自動使用使用者瀏覽器語言，或其使用者資料中儲存的語言。

選項二

在載入聊天的 script URL 後加上 lang=語言代碼 強制使用該語言，例如：
https://board.support/supportboard/js/main.js?lang=es
雲端版：https://cloud.board.support/account/js/init.js?id=123456&lang=es
此方式會強制聊天一律使用指定語言，並忽略「設定 > 聊天 > 語言」。完整語言代碼列表請見維基百科 ISO 639-1。繁體中文請用 zt，簡體中文用 zh，巴西葡語用 pt。

選項二（僅限 WordPress）

到「設定 > WordPress」設定「強制語言」。此方式也會強制聊天固定語言並忽略「設定 > 聊天 > 語言」。

選項三（僅限 WordPress）

WordPress 版會使用網站的預設語言；若網站為多語站，則使用目前頁面或貼文的語言。相容 WPML、Polylang 等多語外掛。若已啟用「設定 > 聊天 > 語言」，此功能會自動停用。

管理端語言（Admin language）

設定方式：

於「設定 > 翻譯」將文字翻譯為您的語言。
設定管理端語言可採下列任一方式：
- 啟用「設定 > 管理 > 自動翻譯管理端」。系統會自動以代理個人檔案語言或其瀏覽器語言翻譯管理端。
- 在安裝目錄的 config.php 檔案末端加入：
  define('SB_ADMIN_LANG', '語言代碼');
  僅用兩碼語言代碼，例如 es，不要用 es_ES。此選項不適用雲端版。

翻譯自訂內容（Translate custom contents）

幾乎所有自訂內容皆可翻譯，例如富訊息、內建訊息、部門、聊天標頭等。新增翻譯步驟：

至「設定 > 翻譯」點「新增翻譯」。
第一欄輸入欲翻譯的英文原文（原文必須是英文；若有換行，請以 \n 代替）。
第二欄輸入翻譯內容（加入換行請用 \n）。
若已安裝人工智慧應用程式，也可使用多語翻譯功能自動將所有內容翻譯為任一語言。

新增語言（Add a new language）

透過 FTP 或檔案管理器到 supportboard\resources\languages\front。
複製 supportboard\resources\languages\front\source.json。
以目標語言代碼重新命名該檔。完整代碼列表請見 ISO 639-1。
回到「設定 > 翻譯」，新語言應會自動出現。
若要為管理端新增語言，請改到 admin 資料夾以相同步驟進行。外掛更新不會刪除您新增的語言。

其他資訊

若缺少某個翻譯字串，可點「新增翻譯」補上。
若某個翻譯字串無效，請移除該字串開頭與結尾的所有空白與換行。
翻譯不儲存在資料庫，而是直接寫入翻譯檔。每次儲存會在 uploads 資料夾建立備份，外掛更新與啟用時會自動還原。
某些特殊字元（如 &）會被替換成 HTML 實體（參見 W3Schools HTML Entities）。例如 & 會成為 &。
您也可直接編輯 supportboard\resources\languages 下的語言檔補上缺字。編輯後，新的字串會出現在「設定 > 翻譯」。記得按「儲存變更」，避免在更新 Support Board 時遺失翻譯。

部門（Departments）

部門功能可將對話分配給特定部門與代理。例如可建立「Sales」部門，並將相關對話指派至該部門。

啟用步驟：

前往「設定 > 其他」新增、刪除並管理部門。儲存後重新載入頁面。
前往「使用者 > 代理」編輯某位代理，會看到部門設定欄位。
重新載入頁面即可。在「對話」區將會看到設定部門的選項。

設定

在控制台顯示：在聊天控制台顯示部門清單，並強制使用者在開始對話前選擇部門。
顯示圖片：以部門圖片取代部門顏色。
在對話清單顯示：在管理端對話清單中顯示部門顏色。
每部門僅允許一則對話：限制同一使用者在同一部門僅能開啟一則對話。
標籤：以其他文字取代複數形的「Departments」，此名稱會顯示在管理端與工單區。
單數標籤：以其他文字取代單數形的「Department」，此名稱會顯示在管理端與工單區。
控制台標題：設定聊天控制台清單的標題（預設：Departments）。

運作方式

無指派部門的代理與管理員，會看到所有部門的對話。
有指派部門的代理與管理員，只能存取該部門內的對話、使用者與代理。
當對話被指派到新部門時，會寄送電子郵件通知給該部門的所有代理。
聊天機器人可透過「問答資料設定」功能、流程動作或 Dialogflow 動作，將部門指派給目前對話。

將部門指派給對話的方式

透過「問答資料設定」。
透過「流程動作」。
透過「設定 > 其他 > 部門設定 > 在控制台顯示」（此狀況下，使用者在開始新對話前必須先選擇部門）。
透過「設定 > 自動化 > 更多」。
透過 JavaScript，在顯示聊天的頁面加入 var SB_DEFAULT_DEPARTMENT = ID;，將 ID 換成部門 ID。更多細節請參見 API。
透過 API。

佇列與路由（Queue and routing）

當啟用「設定 > 其他 > 佇列」或「設定 > 其他 > 路由」時，Support Board 會自動將使用者的對話按比例分配給所有可用代理。

僅線上代理會被視為「可用」並接收新對話；系統會在所有線上代理間按比例分配。若無代理在線，對話保持未指派，並在第一位上線的代理時自動指派給他。
管理員不參與分配；管理員始終可見所有對話。
代理需將對話封存以標記為完成；封存後會自動取得佇列中的下一則對話。凡未刪除或未封存的對話視為「進行中」。
代理可在管理端左下方，將自身狀態在「線上／離線」間切換。
代理僅能搜尋與篩選屬於自己的對話。
代理僅能檢視自己的對話，但可查看同一位使用者的所有對話。
若要允許代理檢視所有未指派對話，請啟用「設定 > 其他 > 隱藏其他代理的對話」並勾選「檢視未指派對話」。
佇列與路由功能可與部門功能搭配使用。
若啟用人工接管，僅在接管期間啟用佇列或路由。
啟用路由或佇列時，代理選單會自動啟用。

手動路由（Manual routing）

在啟用「設定 > 其他 > 隱藏其他代理的對話」後，代理僅會看到自己的對話，且可選取未指派對話。

代理選單：啟用代理選單。
離線時的路由：若對話被封存，日後使用者再發訊復聊，而原先代理離線，系統會在有其他代理在線時指派給線上代理；若無線上代理，則不指派。
檢視未指派對話：允許代理檢視未指派對話；代理一旦回覆，對話會自動指派給該代理，並即時從其他代理的管理端移除。勾選此項以啟用手動路由。

代理選單（Agents menu）

代理選單可讓您將對話指派給特定代理。它會顯示於對話區右側，且在啟用佇列或路由時自動開啟。可同時選取多則對話（請參考快捷鍵），並一次指派給某位代理。

將代理指派給對話的方式

透過「問答資料設定」。
透過「流程動作」。
透過佇列或路由功能。
啟用「設定 > 聊天 > 代理選單」。此情況下，使用者需在開始新對話前先選擇代理。
透過「設定 > 自動化 > 更多」。
透過 JavaScript，在顯示聊天的頁面加入 var SB_DEFAULT_AGENT = ID;，將 ID 換成代理 ID。更多細節請參見 API。
透過 API。

電子郵件匯入（Email piping）

電子郵件匯入可讓您同步多個電子郵件地址，將郵件直接接收於 Support Board。它也允許您、您的代理與使用者透過電子郵件回覆聊天訊息。

啟用（Activation）

前往「Settings > Notifications > Email piping」，輸入您的 POP3/IMAP 電子郵件伺服器資訊。
前往「Settings > Notifications > SMTP」，輸入您的 SMTP 電子郵件伺服器資訊。此電子郵件地址必須與電子郵件匯入伺服器所連線的同一個地址。Support Board 會以這個地址寄出所有郵件，您、代理與使用者也會回覆到這個地址。詳情請參考「Email notifications」章節。

資訊（Information）

「Settings > Notifications > SMTP > Sender email」中的寄件者電子郵件必須與電子郵件匯入伺服器所使用的地址一致。
當 Email piping 啟用時，「Notifications > User email notifications」與「Notifications > Agent email notifications」會自動啟用。當代理在 Support Board 回覆時，郵件一定會寄給使用者。
若您使用人工智慧應用程式，且啟用了「Settings > Artificial Intelligence > Human takeover」，當聊天機器人知道答案時將不會寄出任何電子郵件。
若啟用「Convert all emails」選項：
- 所有寄到您收件匣的電子郵件都會被轉換成聊天訊息；請留意這會使垃圾郵件、促銷郵件等也被錯誤轉換。
- 由代理與管理員的電子郵件地址寄出的郵件會被忽略；測試請使用其他地址。
- 直接寄到電子郵件匯入地址的每封郵件都會產生一個新的使用者對話。
- 您不能使用與電子郵件匯入相同的郵件地址來回覆。所有 Support Board 的代理與管理員都必須使用不同的電子郵件地址。
- 代理必須使用其在 Support Board 註冊的同一個電子郵件地址來透過郵件回覆。
- 只有在代理離線時才會寄送郵件給代理；若代理在線則不會寄送。
對於 Google Gmail 與 Google Workspace 郵件，您需要以 Google 應用程式密碼取代 Google 帳戶密碼，詳見 https://support.google.com/accounts/answer/185833（Create & use App Passwords）。主機請輸入 imap.gmail.com，連接埠 993。您也需要允許 Gmail 讓不太安全的應用程式存取，可於 https://myaccount.google.com/lesssecureapps 設定。若您使用自訂網域的 Google Workspace，請檢查 Admin Console > Security > Access and data control > API Controls > App access control，確保未限制第三方應用的 SMTP 存取。
Email piping 需要 php5-imap 模組（IMAP 模組）。若伺服器未安裝，可用指令 apt-get install php5-imap 安裝；若遇問題請聯繫主機/伺服器支援。
「Delimiter」選項會在所有郵件最上方加入文字：### Please type your reply above this line ###。此文字會指示 Support Board 刪除其下方所有內容，有助於去除回覆引用。若您在聊天中看到重複訊息，請啟用此選項。啟用後，您與使用者不可在郵件中使用字串 ###。
支援電子郵件附件。
為使 Email piping 正常運作，電子郵件回覆中必須包含 Support Board 收件者的名稱。例如：Support Board | SB2457-4734 <example@email.com>。主流郵件用戶端（Outlook Web、Outlook、Gmail、Yahoo Mail）在「回覆」或「全部回覆」時，預設會保留此收件者名稱。
由於電子郵件運作特性，各郵件用戶端會使用不同的代碼、分隔符與自動字串等。因此部分由郵件轉換的聊天訊息可能含有無效文字。我們正持續最佳化更多郵件用戶端；目前以下用戶端已最佳化，理論上不會產生無效文字：Outlook Web、Outlook、Gmail、Yahoo Mail。
Email piping 支援部門；若使用者的對話被指派到某部門，郵件通知只會寄給該部門的代理。
若郵件包含 reply-to 屬性，則該地址會作為主要的使用者電子郵件地址，通知也會寄往該地址。
「Filters」選項可用來過濾會被轉換成聊天訊息的郵件。新增以逗號分隔的關鍵字；若郵件內文、主旨或寄件者包含任一關鍵字，該郵件將不會被轉換為聊天訊息。

排程工作（Cron job）

Support Board 會每 60 秒嘗試透過 cron job 處理郵件，詳情見此處。
若您使用雲端版，cron job 預設已啟用，且至少每 60 分鐘執行一次。
您可透過 API 手動觸發與加速 cron job：使用 PHP 函式 sb_email_piping()，或 WEB API 函式 email-piping。
您可以建立一個 cron job 執行此 URL：[SUPPORT-BOARD-URL]/include/api.php?piping=true。使用以下指令透過命令列執行：
```
*/59 * * * * wget [SUPPORT-BOARD-URL]/include/api.php?piping=true
```
請以您的安裝 URL 取代 [SUPPORT-BOARD-URL]。取得方式如下：
- WP 或 PHP 版本：前往「Settings > Miscellaneous > Installation URL」。
- 雲端版：使用此 URL：https://cloud.board.support/script/include/api.php?piping=true&cloud=API-TOKEN，並以您的 API token 取代 API-TOKEN。
您也可以使用這個 cron job 檔案：download。cron job 指令為：
```
php -f YOUR-FILE-PATH/cron.php
```
若您手動執行 cron job，請啟用「Disable cron job」選項，以停止 Support Board 自行觸發並提升效能。

Pusher

從「Settings > Miscellaneous > Pusher」啟用 Pusher，以使用 WebSockets 取代 HTTP AJAX 請求來提供聊天功能。WebSockets 可大幅提升效能，因為不再需要重複的 AJAX 以檢查新訊息與新對話；同時也可提升聊天回應速度、上線/輸入狀態的準確性、線上使用者清單的準確性等。若您使用雲端版，該設定會自動啟用。

啟用（Activation）

造訪 https://dashboard.pusher.com/accounts/sign_up 建立新帳戶。
登入 https://dashboard.pusher.com 後，在「Channels」產品上點選「Get started」。
輸入您的應用名稱，選擇最接近您位置的叢集（cluster）。
於左側選單點「App Settings」，啟用「client events」。
於左側選單點「Keys」，複製 App ID、Key、Secret、Cluster。
前往「Settings > Miscellaneous > Pusher」，貼上 App ID、Key、Secret、Cluster。

直接訊息（Direct messages）

直接訊息允許您對單一或多位使用者，傳送單一的聊天訊息、電子郵件或簡訊。請閱讀以下說明以了解運作方式。

要傳送訊息，前往「Users」區並點選直接訊息圖示。使用者的個人檔案盒也有直接訊息按鈕。
要傳送給所有使用者，在「User IDs」欄位輸入 All。
要傳送給一群使用者，在「User IDs」欄位輸入其 ID。您可以先勾選使用者，再點直接訊息圖示以自動帶入這些 ID。
所有訊息類型都支援合併欄位（merge fields）。

直接聊天訊息（Direct chat message）

若存在使用者的進行中對話，訊息會送到該對話；否則會建立新對話。
若已啟用「Settings > Notifications > User email notifications」，所有有電子郵件的使用者都會收到郵件通知。
若已啟用「Settings > Notifications > Text message notifications > Active for users」，所有有電話號碼的使用者都會收到簡訊通知。
若已啟用「Settings > Notifications > Push notifications」，會向所有使用者發送推播。
若使用者已連結 WhatsApp、Messenger 等訊息應用，訊息也會同步傳送至這些應用。
若要只傳送給某一個訊息應用的所有使用者，請在「User IDs」輸入以下任一字串：
whatsapp, messenger, instagram, telegram, twitter, zalo, wechat, viber, line。
輸入 tickets 可只傳送給透過 Tickets 應用建立 Support Board 工單的使用者。

直接電子郵件（Direct email）

郵件標頭與簽名會自動包含於所有郵件，可在「Settings > Notifications」設定。
支援 HTML 語言。
主旨支援合併欄位。

直接簡訊（Direct text messages）

要啟用直接簡訊，請於「Settings > Notifications > Text message notifications」啟用 SMS。

直接 WhatsApp 範本訊息（Direct WhatsApp template messages）

更多詳情請點此。

自動化（Automations）

自動化可在您設定的條件被滿足時，執行多語系的自動任務。

若要刪除某條件，將其設為空白；若要停用某自動化，刪除所有條件即可。
自動化對同一位使用者僅發送一次。
若您之前用過某自動化，使用者已收到過，想再次顯示則需刪除該自動化並新建一個。
「Repeat（重複）」僅在與「date time（日期時間）」搭配時有效。
當「date time」與條件「is exactly（完全等於）」搭配時，值不可包含小時與分鐘（hh:mm）。例：25/10/2021（25/10/2021 10:30 不會生效）。
若有在「頁面載入」時執行的訊息自動化，必須啟用「Settings > Users > Register all visitors」。
城市、國家、語言自動判斷僅在同時啟用「Settings > Users > Register all visitors」與「Settings > Users > Full visitor details」時有效。
城市（Cities）條件僅在使用者詳情中的 location 設為 city, country 或 city 欄位已設定時有效。
國家（Countries）條件僅在使用者詳情中的 country_code 或 country 已設定，或 location 設為 city, country 時有效；國家名稱必須為英文。
語言（languages）條件僅在使用者詳情的 browser_language 或 language 已設定時有效。
訪客若在 24 小時或更久後再次造訪，才會被視為「Returning visitor」。
彈出視窗（pop-ups）只會在聊天關閉時出現，且會覆蓋預設的彈出視窗。若聊天已開啟，您可啟用「message fallback」以改為傳送訊息。
若您想對新使用者傳送自動訊息，可能需要啟用「Settings > Users > Register all visitors」。
聊天訊息與彈出視窗的後備訊息（popup fallback messages）只有在該對話中最後一則使用者或代理訊息超過 10 分鐘時才會傳送；此功能可避免代理與使用者對話期間出現不必要的自動訊息。
「Custom variable」條件會檢查聊天頁面上的 JavaScript 變數是否符合指定名稱與值。例如條件 example=ABC，當頁面上有 var example = "ABC"; 時即符合。可用逗號分隔多個變數。
自動化與 WhatsApp、Messenger、Instagram、Telegram、Twitter、Zalo、WeChat、Viber、Line 等訊息應用不相容。

依下列步驟完成與您的電子報服務的同步。以下情況會將使用者訂閱：註冊表單、後續訊息、訂閱訊息、email 短代碼。

Mailchimp

取得 Key：請參考 https://mailchimp.com/help/about-api-keys/
取得 List ID：請參考 https://mailchimp.com/help/find-audience-id/

Brevo

取得 Key：前往 https://account.brevo.com/advanced/api
取得 List ID：前往 https://my.brevo.com/lists

SendGrid

取得 Key：前往 https://app.sendgrid.com/settings/api_keys
取得 List ID：登入 SendGrid，點選 Marketing > Contacts（https://mc.sendgrid.com/contacts），再點入某個清單或建立新清單。URL 最末段即為清單 ID。
例：https://mc.sendgrid.com/contacts/lists/8558c1e7-3c99-4428-a68f-78df2e437f8e（清單 ID 為 8558c1e7-3c99-4428-a68f-78df2e437f8e）

Elastic Email

取得 Key：登入 Elastic Email，點右上角個人檔案選單的 Settings。點選「Create Additional API key」（https://elasticemail.com/account#/settings/new/create-api），設定名稱並選擇「Plugin」或「Full access」，或自訂權限，且確保「Contacts」權限為「View & Modify」。
List ID 即清單名稱。重要：既有清單或區隔（segment）的名稱不可包含空白字元。

Campaign Monitor

取得 Key：登入 Campaign Monitor，於右上角個人檔案選單點「Account settings」。點「API keys > Generate API key」。
取得 List ID：登入 Campaign Monitor，點上方「List and subscribers」。選擇某清單後，於左側選單點「Settings」，複製「List API ID」。

HubSpot

取得 Key：登入 HubSpot，前往「Settings > Integrations > Private apps」建立新應用。
輸入應用名稱，於「Scope」頁籤加入下列範圍：crm.lists.write, crm.lists.read, crm.objects.contacts.read, crm.objects.contacts.write。
點「Create app」並複製 token，貼到 Support Board 的 Key 欄位。
取得 List ID：登入 HubSpot，前往「Contacts > List > List details」。

Moosend

取得 Key：登入 Moosend，點「Settings > API key」。
取得 List ID：登入 Moosend，前往「Audience > Email lists」取得。

GetResponse

取得 List ID：登入 GetResponse，前往「Lists > Your list > Settings」（https://app.getresponse.com/lists），複製「List token」的值。
取得 Key：造訪 https://app.getresponse.com/api

ConvertKit

取得 Key：登入 ConvertKit，前往「Settings > Advanced > API secret」。
取得 List ID：登入 ConvertKit，前往「Grow > Landing Pages & Forms」。打開您的表單並複製 URL 中的數字部分。
例：https://app.convertkit.com/forms/designers/3003412/edit 的表單 ID 為 3003412。

ActiveCampaign

取得 Key：登入 ActiveCampaign，前往「Account settings > Developer」。
取得 List ID：登入 ActiveCampaign，前往左側選單「Lists」或「Contacts > Lists」。開啟清單並複製 URL 中的清單 ID。
例：https://schiocco.activehosted.com/app/contacts/?listid=1&status=1 的清單 ID 為 1。
List ID 的格式必須為：domain:list-ID。domain 是儀表板 URL 的前綴。
例：https://schiocco.activehosted.com/ 的 domain 是 schiocco，故在 Support Board 中填入 schiocco:1。

MailerLite

取得 Key：登入 MailerLite，前往左側選單「Integrations > MailerLite API」。
取得 List ID：登入 MailerLite，前往左側選單「Subscribers > Groups」。開啟某群組並從 URL 複製 Group ID（例：...group=18783408688903967...）。

Mailjet

取得 Key：造訪 https://app.mailjet.com/account/apikeys，或登入 Mailjet 後於「Account settings > Account settings」取得。
取得 List ID：登入 MailerLite（原文如此），前往「Contacts > Contacts lists > Your list」。點清單電子郵件旁的「?」圖示取得 List ID（例：1202546）。

Sendy

取得 Key：進入 Sendy 設定區並複製 API KEY。
取得 List ID：進入您的品牌，點「View all lists」並複製清單 ID。
List ID 設定還必須包含您的 Sendy 完整 URL。請以 URL|listID 的格式填入（用 | 分隔）。
例：https://example.com|TDf6o892Mx11VXGC51ui567u

SendFox

取得 Key：登入 SendFox，前往「Settings > API > Personal Access Tokens」。
取得 List ID：登入 SendFox，前往「Audience > Lists」。打開清單並從 URL 複製 ID。
例：https://sendfox.com/dashboard/lists/489151/contacts 的 List ID 為 489151。

亞馬遜網路服務 (Amazon Web Services)

此章節內容將根據附件完整填入...

通知 (NOTIFICATIONS)

若要了解通知如何運作與何時發送，請閱讀以下資訊。若您認為通知沒有作用，多半是測試方式不正確；請在尋求支援前先閱讀以下說明。

電子郵件通知

代理與使用者在收到新訊息時都可以接收電子郵件通知。

向管理員和代理程式送電子郵件通知

當使用者傳送第一則訊息時：
- 若該對話已指派至某個部門，則僅寄信給該部門的代理；
- 若該對話已指派至特定代理，則僅寄信給該代理；
- 否則，會寄信給所有目前不在線的代理。
- 後續的電子郵件只會寄給該對話中最後一位代理。
僅當該對話中的最後一位代理離線時，才會寄送電子郵件通知。
若您使用人工智慧應用程式，且已啟用「Settings > Artificial Intelligence > Human takeover」，當聊天機器人知道答案時將不會寄送任何電子郵件。
若要避免管理員收到電子郵件通知，請勾選「Settings > Notifications > Do not send email notifications to admins」。

為使用者提供電子郵件通知

當代理傳送訊息給使用者時，僅在使用者離線時才會寄送電子郵件。
只會寄送 1 封郵件；後續訊息不會再次觸發新郵件提醒。

建立電子郵件

請前往「Settings > Notifications」管理與撰寫郵件內容。可使用純文字與 HTML。換行會自動轉為 <br />。您可以在郵件中使用以下合併欄位（merge fields）；這些欄位會自動被最新資訊取代。

Merge field	Description
`{recipient_name}`	收件的使用者或代理之姓名。
`{sender_name}`	觸發此郵件通知之訊息的傳送者（使用者或代理）姓名。
`{sender_profile_image}`	觸發此郵件通知之訊息的傳送者（使用者或代理）頭像。
`{message}`	觸發此郵件通知之訊息所包含的任何附件連結。
`{attachments}`	郵件附件。
`{conversation_link}`	於管理端開啟該對話的連結。此合併欄位僅適用於寄給代理的郵件。
`{conversation_id}`	對話 ID。

計劃任務

您可以執行以下 cron job 來寄送給使用者與代理的電子郵件通知；同時也需要勾選「Settings > Notifications > Email notifications via cron job」。透過 cron job 寄信可改善通知品質：郵件會包含整段對話，且只會寄送 1 次。

建立一個 cron job 執行此 URL：[SUPPORT-BOARD-URL]/include/api.php?email-notifications=true
以命令列執行：

*/59 * * * * wget [SUPPORT-BOARD-URL]/include/api.php?email-notifications=true
以您的安裝 URL 取代 [SUPPORT-BOARD-URL]，該值可於「Settings > Miscellaneous > Installation URL」取得。
若您使用雲端版，請使用此 URL：
https://cloud.board.support/script/include/api.php?email-notifications=true&cloud=API-TOKEN
並以您的 API token 取代 API-TOKEN。
本功能屬進階用戶與伺服器相關設定，官方支援不包含此功能協助；若需要協助，歡迎聘用我們的服務。

遇到問題?

您可以在「Settings > Notifications > Send an agent email notification」寄送一封測試郵件來測試。電子郵件可能因多種原因未送達；以下列出最常見情況：

Reason	Description	Solution
Hosting problems	您的主機商電子郵件伺服器無法寄信，或雖已寄出但被郵件用戶端判定為垃圾郵件並刪除。	若「Settings > Notifications > SMTP」未設定，您的伺服器會直接寄信。請聯繫主機商詢問郵件支援，或在「Settings > Notifications > SMTP」啟用並使用您自己的 SMTP 伺服器。
SMTP problems	即使已在通知區啟用 SMTP，仍無法寄出電子郵件。	若收不到郵件，請在「Settings > Notifications > Send a user email notification」或「Send an agent email notification」發送測試郵件確認是否可行。若測試也收不到，代表您的 SMTP 伺服器無法運作。請開啟瀏覽器主控台以取得錯誤細節。由於這並非 Support Board 產品問題，官方支援不涵蓋，請聯繫您的伺服器/主機/SMTP 支援。您也可使用 sendgrid.com：30 天內免費寄送 40,000 封，之後每日 100 封永久免費。
Google Gmail	即使已在通知區啟用 SMTP，且嘗試使用 Gmail SMTP 伺服器，仍無法寄出郵件。	對於 Google Gmail 與 Google Workspace，必須以 Google 應用程式密碼取代帳戶密碼，詳見 https://support.google.com/accounts/answer/185833（Create & use App Passwords）。主機請填 `smtp.gmail.com`，連接埠填 465 或 587。若您使用自訂網域的 Google Workspace，請於 Admin Console > Security > Access and data control > API Controls > App access control 檢查，確保未限制第三方應用之 SMTP 存取。

推播通知

推播通知與桌面通知類似，但存在一些關鍵差異。桌面通知（亦稱 Web 通知）由用戶端直接要求；推播通知則由伺服器發出。最大的差別在於：推播通知即使在裝置離線或未開啟 Support Board時也能運作，且為持續性（persistent），直到手動關閉前都可見。推播通知需要外部服務：我們支援 Pusher 與 OneSignal，兩者對最多 2000 位使用者/裝置皆可免費使用。Pusher 不支援 iOS 裝置；若您使用 iOS，請使用 OneSignal。

雲端版本

雲端版的 Support Board 預設使用 OneSignal；您無法自行調整設定。對於管理端，一切皆已設定完成，您只需勾選「Settings > Notifications > Push notifications > Active for agents」，儲存並重新載入管理端。

啟動 - Pusher

前往「Settings > Notifications > Push notifications」，選擇 Pusher 作為提供者。
造訪 https://dashboard.pusher.com/accounts/sign_up 建立新帳戶。
登入 https://dashboard.pusher.com 後，選擇 Beams 產品並點 Get started。
輸入 Instance name 並建立實例（可任意命名）。
在左側選單點 Keys，複製 Instance ID 與 Primary key。
返回 Support Board 管理端，至「Settings > Notifications > Push notifications」貼上 instance ID 與 primary key。
若您使用 WordPress，必須在 WordPress 之外存取 Support Board 管理端，更多細節請點此。
完成。Pusher 不支援 iOS 裝置；若您有 iOS 裝置，請使用 OneSignal。

激活 - OneSignal

前往「Settings > Notifications > Push notifications」，選擇 OneSignal 作為提供者。
造訪 https://dashboard.onesignal.com 建立新帳戶。
前往 Settings > Platform 建立推播整合，並選擇 Web Configuration。
輸入名稱與安裝 Support Board 的網域。只輸入根網域 URL，不包含完整的管理端安裝 URL。例：若安裝 URL 為 https://www.example.com/supportboard/admin.php，請僅輸入 https://www.example.com。
若您使用 WordPress，必須在 WordPress 之外存取 Support Board 管理端，更多細節請點此。
捲動至 Advanced Push Settings - Service Worker，並輸入以下 Service Worker 值：
- Path to service worker files：從「Settings > Notifications > Push notifications > Service Worker path」取得值。
- Main service worker filename：sw.js
- Updater service worker filename：sw.js
- Service worker registration scope：從「Settings > Notifications > Push notifications > Service Worker path」取得值。
捲動至 CLICK BEHAVIOR，於 Matching Strategy 選擇 Origin: Take actions on a previous tab open to the same domain。
點 Save。
前往 Settings > Keys & IDs 複製 AppID 與 Rest API Key，貼至「Support Board > Settings > Notifications > Push notifications > App ID 與 API key」。點 Save changes。
僅 iOS 使用者：請透過 Safari 存取 Support Board 管理端，點選分享按鈕並選擇 加入主畫面（Add to Home Screen）。
重新載入 Support Board，您應會看到啟用推播通知的提示；若未看到，請點「Settings > Notifications > Push notifications > Subscribe」。

用戶啟用

在此下載 service worker 檔案。
將此檔案上傳至您的網站：https://your-site.com/service-worker.js
前往「Settings > Notifications > Push notifications > Service Worker URL」並輸入該檔案 URL（如 https://your-site.com/service-worker.js）。
完成。

資訊

Pusher 免費方案可供 1000 位同時訂閱者使用。一般來說，管理端與代理可使用免費方案；但依站點流量，對「發送給使用者」的推播可能需要付費方案。
推播通知僅適用於 完整 HTTPS 網站（開發用的 localhost 例外）。
使用者點擊通知時，會開啟使用者最後造訪的頁面，並自動開啟聊天。
桌面端必須有瀏覽器執行中（推播訊息由瀏覽器行程接收）。
啟用推播通知後，會取代桌面通知。
在 Android 與行動裝置上，桌面通知可能無法運作，此時需改用推播通知。
在桌面電腦上，若無瀏覽器執行，無法接收推播通知。
iOS（iPhone）的推播通知僅自 iOS 16.4 起可用。您需要將 Support Board 安裝為 PWA（詳情見此）。您必須使用 OneSignal；Pusher 不支援 iOS。
若推播通知已啟用但無法運作，請到 https://dashboard.onesignal.com，刪除 Audience > Users 中的所有使用者；之後重設 OneSignal 訂閱並重新訂閱。詳細步驟請見：https://documentation.onesignal.com/docs/clearing-cache-and-resetting-push-permissions。

向管理員和代理推送通知

當代理點擊通知時，會開啟管理端並自動選取正確的對話；若管理端已開啟，通知不會再開新分頁。
當使用者傳送第一則訊息時，會向所有已驗證代理發送推播；後續通知只會發給該對話中的最後一位代理。
若您使用人工智慧應用程式且已啟用「Settings > Artificial Intelligence > Human takeover」，當聊天機器人知道答案時不會發送通知。
若您使用 WordPress 版，WordPress 管理後台不支援推播；您需要直接存取 Support Board 管理端（詳見此處）。
若啟用 Routing 設定，則僅被指派該對話的代理會收到通知；管理員可見所有對話，但不會收到通知。
若啟用 Queue 或 Routing，則僅被指派該對話的代理會收到通知。在排隊等待期間由使用者送出的訊息不會觸發通知。管理員可見所有對話，但不會收到通知。
若使用者的對話被指派到某個部門，則僅該部門的代理會收到通知。
若使用者的對話未指派任何部門，則僅無部門之代理會收到通知。
僅當該對話中的最後一位代理離線時才會發送通知。
若啟用人工接管，當聊天機器人知道答案時不會發送通知。
若推播通知無法運作，請先確認您已允許通知（以 Chrome 為例：Privacy and Security > Site settings > Notifications）。若在行動裝置無法運作，也請嘗試：安裝 PWA（或移除後重裝）、重新啟動裝置。
若您使用 Chrome，想在分頁關閉時仍可接收推播，請在 Chrome > Settings > System（chrome://settings/system）啟用 Continue running background apps when Google Chrome is closed。
若推播通知無法運作，請確認對話沒有被指派到錯誤的代理或特定代理（更多細節請點此）。
若推播通知無法運作且您使用 Windows，請確認系統未封鎖通知。點開始鍵搜尋 Notifications，開啟 Turn app notifications on or off 檢查您的瀏覽器是否被封鎖。
若推播通知無法運作，請確認 Support Board 管理端沒有顯示在前景並開啟。若管理端已開啟，請最小化或改開啟其他視窗/分頁。
若推播通知無法運作，可能是系統層級封鎖：
- Windows 10+：請查看此連結。
- Mac：請查看此連結。
- 所有裝置：也請查看此連結。

桌面通知（Desktop notifications）

桌面通知

若使用者正在檢視包含聊天的頁面（瀏覽器已開啟且可見，且目前的頁面有嵌入聊天），則不會傳送桌面通知。
iPhone 與 iOS 裝置不支援桌面通知。
桌面通知僅適用於使用 HTTPS 的安全網址（非 HTTP）。您的 Support Board 管理端 URL 必須使用 HTTPS。
當推播通知（Push notifications）啟用時，會取代桌面通知。
若桌面通知無法運作，請參考「Push notifications」章節中的解決方案。

簡訊通知（Text message notifications）

代理與使用者在有新訊息時都可透過簡訊收到通知。簡訊通知由 Twilio 提供。Twilio 為付費服務，但價格低廉，且可用試用版免費測試簡訊通知。

啟用（Activation）

前往 https://www.twilio.com 建立新帳戶。
驗證您的電話號碼。
填寫表單並選擇 SMS。
進入儀表板後，點選 Get a Trial Number，再點 Choose this number。
進入 Support Board 管理端，前往 Settings > Notifications > Text message notifications，貼上 account SID、auth token、試用號碼（或您購買的號碼）。所有資訊可於 Twilio 儀表板找到。
若使用試用版，僅能發送到已驗證的號碼。前往 Twilio 儀表板，點左側 #（Phone Numbers），再點 Verified Caller IDs 並新增您的電話號碼。
若要在正式環境使用並在 Support Board 接收簡訊，您需要購買一個電話號碼。購買後前往 Phone numbers > Manage > Active numbers，點入您的號碼，並輸入 Support Board 的 URL（於 Support Board > Settings > Notifications > Text message notifications > Get configuration URL 取得）。
完成。

資訊（Information）

請確保代理與管理員在系統中都有指派電話號碼，以便將代理簡訊通知發送到正確的號碼。
所有電話號碼都必須包含國碼且以 + 開頭（例如：+15558675310）。
使用者的電話可透過註冊表單、後續訊息或 [email] 短代碼取得；也可在管理端手動輸入或透過 API 設定。
當使用者傳送第一則訊息時：
- 若對話已指派至某部門，只會向該部門的代理發送簡訊；
- 若對話已指派至特定代理，只會向該代理發送簡訊；
- 否則，會向所有目前不在線的代理發送簡訊與電子郵件。
  後續的簡訊通知只會發送給該對話中最後一位代理。
僅當該對話的最後一位代理離線時，才會發送簡訊通知。
若您使用人工智慧應用程式，且人力接管（human takeover）啟用，當聊天機器人知道答案時不會發送簡訊。
若要使用 Sender ID 功能，請在 Sender number 欄位輸入發送者名稱。

聲音通知（Sound notifications）

啟用 Settings > Notifications > Sounds 後，當有新訊息或新對話時會播放聲音。
只有在使用者或代理與頁面互動（例如在管理端或含有聊天小工具的頁面上點擊）後，瀏覽器才允許播放音訊（出於瀏覽器的安全機制）。
若聲音設定為重複播放，則只要管理端或聊天小工具頁面未開啟或已最小化，聲音就會持續重播；若頁面開啟且可見，則不會聽到聲音。

人工智慧 (AI)

以下設定與**人工智慧（Artificial Intelligence）**應用程式相關。

安裝（Installation）

在 Settings > Apps 內點選 Artificial Intelligence，輸入您的授權金鑰以安裝並啟用此應用。更多細節請見此處。若您使用雲端版，點選 Active 即可。

人力接管（Human takeover）

在以下情況會發生人力接管：

當真人代理回覆了使用者訊息。
當啟用 Settings > Artificial Intelligence > Human takeover 選項時：
- 聊天機器人無法理解使用者訊息時會自動觸發；
- 或由使用者主動要求聯繫真人代理而觸發。

一般資訊（General information）

啟動人力接管後，只要最後一位曾回覆該對話的真人代理仍在線，聊天機器人就會自動停用；若尚無代理回覆過該對話，聊天機器人則維持啟用。
之後聊天機器人會重新啟用，但在人力接管後 10 天內，若聊天機器人不知道答案，不會在同一段對話中傳送預設的後備訊息（fallback）。您可在 Dialogflow 的 Intent 中加入自訂 Payload："force-message": true，以強制一定傳送一則 Dialogflow 訊息。
若對話被封存或刪除，聊天機器人會完全恢復啟用。
若您使用 Slack，當聊天機器人知道答案時不會傳送任何訊息；一旦進入人力接管，該對話的所有訊息都會傳送到 Slack。
當真人代理回覆使用者時，會自動啟用人力接管。
人力接管功能相容於 OpenAI，即使 Dialogflow 聊天機器人已停用仍可運作。
若要在人力接管時完全停用聊天機器人，請勾選 Human takeover > Disable chatbot。
若人力接管已處於啟用狀態，將不會再次啟用，也不會再傳送人力接管訊息；改為傳送Fallback 訊息。

人力接管選項（Human takeover option）

當啟用 Human takeover 選項時，會有以下行為：

若啟用最佳化：僅當使用者訊息長度超過 3 個字元且至少包含兩個單詞時，才會送出請求，以避免誤觸發。
由聊天機器人正確回答的對話，會被標記為已讀並移至收件匣底部。

當使用者確認人力接管，或屬於自動接管時，會發生以下狀況：

對話被標記為未讀並移至收件匣頂端。
在人力接管後 10 天內，同一對話中的任何使用者訊息都會觸發代理通知。
若啟用代理電子郵件通知，會寄送給被指派該對話的代理；若對話指派至部門，則寄送給該部門的代理；否則寄送給所有離線代理。
若啟用推播通知，通知會寄送給被指派代理；或指派至部門時寄送給該部門代理；否則寄給所有離線代理。
若啟用簡訊通知，亦以相同規則寄送簡訊。
在同一對話中，10 天內不會再次發送人力接管請求。
**後續訊息（follow-up）與離線訊息（offline）**會啟用。
若有啟用佇列設定，則會啟用佇列或路由。

手動人力接管－僅限 Dialogflow（Manual human takeover - Dialogflow Only）

您可以建立新的 Dialogflow Intent，在 Custom Payload 回覆中加入：

{ "human-takeover": true }
手動接管會自動以電子郵件通知代理，並將對話標記為未讀。
若要手動發送人力接管請求，可使用 chips 富訊息（ID：sb-human-takeover）：

[chips id="sb-human-takeover" options="Human support,Cancel" message=""]

手動人力接管－僅限 OpenAI（Manual human takeover - OpenAI Only）

使用者可主動要求聯繫真人代理以觸發人力接管。此設定預設啟用。
此設定不相容於較舊的 OpenAI 模型（如 gpt-3.5-turbo）。

透過 Q&A 啟用人力接管（Human takeover via Q&A）

您可以在 Q&A 的 set data 與 actions 中加入「human takeover」動作，針對特定使用者訊息啟用人力接管。

OpenAI Assistant

若要在 OpenAI Assistant 啟用人力接管，請在 OpenAI functions 區域加入以下函式：

{ "name": "sb-human-takeover", "description": "I want to contact a human support agent or team member. I want human support.", "parameters": { "type": "object", "properties": {}, "required": [] } }

WhatsApp、Messenger、Telegram 與其他訊息應用

若要讓人力接管請求在 WhatsApp、Messenger、Telegram 等訊息應用中生效，請建立一個新的 Intent，設定：

輸入 Context：human-takeover
輸出 Context：留空
訓練語句（Training phrases）：新增常見的使用者確認語句（如：ok、yes）
Custom Payload 回覆：

{ "human-takeover": true }

智能回覆（Smart reply）

Smart Reply 會在對話期間即時提供快速回覆建議。啟用後，若有建議，您會在對話區域看到。

資訊（Information）

若 Dialogflow 聊天機器人啟用，Smart Reply 會優先檢查 Dialogflow 的建議；若至少有一則建議，便會立即顯示。
若 Dialogflow 未啟用，或沒有 Dialogflow 建議，則會改為提供 OpenAI 的建議。
若啟用語言偵測功能，Smart Reply 也會套用語言偵測。
若啟用多語翻譯功能，Smart Reply 也會套用多語翻譯。
要閱讀完整建議內容，請將滑鼠游標懸停在建議上 3 秒。
要還原上一則訊息，請使用快捷鍵 CTRL + Z。

建立聊天機器人的最佳化設定（Optimal configuration for the chatbot）

Support Board 提供強大工具協助您打造聊天機器人：

啟用 Artificial Intelligence > Google > Dialogflow chatbot。若您需要明確答案的泛用或特定問題，或想使用富訊息（如按鈕），Dialogflow 是最佳選擇，且可與 OpenAI 聊天機器人同時運作（兩者可並行）。更多細節見此處。
持續透過聊天機器人訓練面板改進機器人。
啟用 Artificial Intelligence > Smart Reply（更多細節見此）。
啟用以下 OpenAI 設定：Chatbot、Spelling Correction、Dialogflow spelling correction、Rewrite Message Button（更多細節見此）。
使用您自己的內容訓練 OpenAI 聊天機器人（詳見此處）。
將 Google > Dialogflow Intent detection confidence 設為 0.81。
若您的網站有來自多國的流量，建議啟用以下 Google 選項：multilingual via translation、automatic translation、language detection。
於 Settings > Users > Bot name 變更聊天機器人名稱。

問題排查（Problems?）

若 OpenAI 或 Google 無法正常運作，最常見原因如下。想了解詳情，請開啟瀏覽器開發者工具並切換到 Console，在 Support Board 聊天中傳送一則訊息，Console 便會顯示錯誤。
（Chrome：Settings > More tools > Developer tools > Console）

OpenAI 與 Google

目前處於人力接管狀態。
您也可聘請我們協助同步設定，詳見 hire us 頁面。

OpenAI

點選 Settings > Artificial Intelligence > OpenAI > Troubleshoot problems 按鈕檢查錯誤。若有錯誤，通常與您的 OpenAI 帳戶相關，請依錯誤訊息指示修正。
請確保已勾選 Settings > Artificial Intelligence > OpenAI > Chatbot。
您可能達到額度上限或帳戶有計費問題：請至 https://platform.openai.com/account/usage 檢查。
若啟用 Dialogflow 時 OpenAI 運作不正常，可能是您的 Dialogflow 缺少 Fallback Intent。請在 Intents 頁確認；若缺少，依教學重新建立。也可先停用 Dialogflow並傳送 2–3 個字的訊息，再查看瀏覽器 Console 是否有錯誤以快速判斷。
若聊天機器人完全沒有回覆，而您啟用了某些 Google 設定，請嘗試停用這些 Google 設定後再測試。
請務必閱讀一般資訊。
若訓練未如預期（例如對訓練資料相關問題不回應，且沒有顯示訓練錯誤），可能是檔案權限問題。請確認 uploads 資料夾內含 embeddings 資料夾，且該資料夾存在並含有檔案。此問題僅影響 PHP 或 WordPress 版本；若您使用雲端版可忽略本點。
若訓練未如預期（例如不回答訓練相關問題），請於 Chatbot > Training > Information > Delete all training data 刪除所有訓練資料後重新訓練。
若訓練未如預期（例如回覆被截斷或部分不正確），請嘗試多問幾次；回覆會隨互動逐漸改善。OpenAI 需要從使用者互動中學習。
若您的訓練資料來自網站，且該網站為多語系，請確保 <html> 標籤的 lang 屬性為正確語言。
刪除所有 OpenAI 設定，只保留 OpenAI key 後再試。
嘗試改用 OpenAI Assistant。
若您使用雲端版，可將 Settings > Artificial Intelligence > OpenAI > Sync mode 設為 Automatic 使用我們的 OpenAI key。若此舉能解決問題，表示問題源自您的 OpenAI 帳戶；此模式需購買額度。

Google

點選 Settings > Artificial Intelligence > Google > Troubleshoot problems 按鈕檢查錯誤。若有錯誤，通常與您的 Google 帳戶相關，請依錯誤訊息指示修正。
請確保已勾選 Settings > Artificial Intelligence > Google > Dialogflow chatbot。
若同步未成功，建議重讀文件並重新執行同步步驟。必要時可使用我們的整合服務（詳見 hire us 頁）。
您可能選擇了錯誤的 agent 位置。
請確認未使用 mega agent。
請務必閱讀一般資訊

OpenAI

以下設定與「Artificial Intelligence（人工智慧）」應用程式相關。

同步（Synchronization）

自動同步模式（Automatic sync mode）

此功能僅適用於 Support Board 的雲端版本。

自動同步模式可即用即開，不需要任何額外設定。於 Settings > Artificial Intelligence > OpenAI > Sync mode 設定。
若要啟用聊天機器人，請勾選 Settings > Artificial Intelligence > OpenAI > Chatbot。
使用此選項需要購買額度（credits）。

手動同步模式（Manual sync mode）

OpenAI（ChatGPT）整合可讓您的聊天機器人回答幾乎任何一般性問題。請依下列步驟開始使用：

至 https://platform.openai.com/ 註冊。
前往 https://platform.openai.com/api-keys 取得 API Key，並貼到 Settings > Artificial Intelligence > OpenAI > API key。若您使用雲端版，請將 Settings > Artificial Intelligence > OpenAI > Sync mode 設為 Manual。
於 Settings > Artificial Intelligence > OpenAI > Chatbot 啟用聊天機器人。

Chatbot

建立第一個聊天機器人，請依下列步驟：

完成同步流程。
啟用 Settings > Artificial Intelligence > OpenAI > Chatbot 並儲存變更。
您的聊天機器人即會啟用。「Playground」可從左側選單的🙂 Chatbot 區進入。若無法運作，請點 Settings > Artificial Intelligence > OpenAI > Troubleshoot problems 依指示排查。
如需進一步強化，請參考**訓練（training）與人力接管（human takeover）**章節。

設定（Settings）

多數 OpenAI 設定的說明請見此處。

聊天機器人模式

此功能對應 Settings > Artificial Intelligence > OpenAI > Chatbot mode，用以設定 OpenAI 回應使用者訊息時可使用的資訊範圍：

Only general questions
OpenAI 僅回覆一般性問題與同一對話中先前訊息相關的問題，不使用您提供的任何資訊。此為預設模式。
Only questions related to your sources
OpenAI 僅回覆與您提供的資訊來源相關的問題，忽略使用者訊息本身。您必須先以您的來源訓練聊天機器人。
All questions
OpenAI 會回覆：與您提供來源相關的問題、一般性問題、以及同一對話中先前訊息相關的問題。您必須先以您的來源訓練機器人。此為建議模式。
Assistant
若您使用 OpenAI Assistant，請選此模式。

助理

此功能允許您使用在 https://platform.openai.com/assistants 建立的自有 Assistants。

若使用雲端版，請將 Settings > Artificial Intelligence > OpenAI > Sync mode 設為 Manual，並使用您自己的 API key。
您可在 Settings > Artificial Intelligence > OpenAI Assistants - Department linking 新增多個 Assistant 的 ID，並在 Settings > Artificial Intelligence > OpenAI > Chatbot mode 選擇 Assistant。要啟用某個 Assistant，該 Assistant 與對話都必須被指派到某個部門。
Assistant 僅用於聊天機器人與智能回覆（smart replies）；不用於訊息改寫與其他功能。

聊天機器人

OpenAI 聊天機器人與 Dialogflow 類似，能自動回覆使用者訊息。請於 Chatbot mode 指定機器人可回應的問題類型；同時可搭配人力接管讓機器人於需要時轉交真人代理。

後備訊息

當 OpenAI 無法理解使用者問題時會傳送後備訊息（fallback）。若 Dialogflow 已啟用，則停用本後備訊息，改用 Dialogflow 的後備訊息。

提示(Prompt)

Prompt 透過提供相關資訊來指示 OpenAI 如何回覆。請參考下方示例 Prompt 以了解撰寫方式。

若您啟用人力接管，需在 Prompt 中指示 OpenAI 當無法回答時要回覆 I don't know。請務必加入以下文字：
Respond "I don't know", if not sure about the answer.

提示訊息重寫

此 Prompt 用於 Message rewrite 按鈕啟用時，指示 OpenAI 如何改寫訊息。此 Prompt 應以英文撰寫。必要時，Support Board 會自動加上：and use the user language, add greetings。

來自訓練來源的回覆可與 Prompt 功能相容並搭配使用。

拼字糾正

自動修正代理訊息中的拼字錯誤。

訓練資料語言

若您使用訓練資料且機器人為多語系，請設定預設訓練資料語言。若您的訓練資料預設為英文，可維持預設值。

智慧回覆

可在未啟用聊天機器人的情況下，單獨啟用 Smart Reply。若聊天機器人已啟用，Smart Reply 會自動使用 OpenAI。

Dialogflow 拼字糾正

當 Dialogflow 找不到合適回覆時，會檢查是否有拼字錯誤；若有，會以修正後版本再次呼叫 Dialogflow，提升準確率。此功能雖優先，但仍可與 Google 搜尋拼字校正並用。

訊息重寫按紐

在對話輸入框加入一個按鈕，一鍵改寫您的訊息，使其更友善、更專業。若先前沒有代理訊息，系統會自動加入問候語。若您的語言非英文，請至代理/管理員個人檔設定正確語言。

語音辨識

啟用後，語音訊息會被轉成文字。

即使未啟用此功能，聊天機器人的語音理解也始終啟用。
為提升效果，應知曉使用者語言；可啟用語言偵測自動判定。
文字會與音訊播放器並列顯示。
產生之文字相容翻譯功能。

影像辨識

啟用後，聊天機器人會分析與解讀使用者傳送的圖片。

僅 GPT-4 與更新版本支援。
此功能在 localhost 無法運作，需要線上伺服器或 AWS S3。

來源連結

啟用後，回覆中會自動附上來源與訓練資料的連結。若要把文章納入來源，請先於 Settings > Articles > Articles page URL 設定文章頁。

注意資料抓取

啟用後，您會在筆記面板看到一個選單，可自動擷取使用者訊息中的特定資訊。

您可調整多種 OpenAI 參數（如 temperature、logit_bias），詳見
https://platform.openai.com/docs/api-reference/completions/create

若不清楚參數含意，不要亂設，否則可能導致 OpenAI 無法運作。

Logit 偏差

Logit bias 必須為 JSON 字串，且鍵需為字串，例如：
{"2435":-100, "640":-100}

產生使用者問題

啟用後，當您開啟聊天機器人訓練面板時，OpenAI 會即時產生新的使用者問題。

使用對話進行培訓

自動以對話內容定期訓練聊天機器人。資料可於 Chatbot > Training > Conversations 檢視。
訓練透過 cron job 每 24 小時執行。僅使用使用者與代理訊息，忽略機器人訊息。詳情見此處。

情境感知

啟用後，OpenAI 會辨識使用者撰寫訊息之網頁的語境（僅包含該頁的 meta title 與 meta description）。
此選項僅支援聊天小工具，不相容於訊息通道。

訓練（Training）

可用您的網站、文字、PDF 文件等訓練聊天機器人；完成後，機器人即可回答與內容相關的問題。

以檔案訓練（Training using files）

路徑：Chatbot > Training > Files
選擇檔案並點 Train chatbot，等待訓練完成。
僅支援上傳 PDF 與 TXT。
訓練完成後，上傳檔案會被移除。

以網站訓練（Training using a website）

路徑：Chatbot > Training > Website
輸入網址並點 Train chatbot，等待訓練完成。
重新訓練相同網站前，請先刪除先前的網站訓練資料；否則僅訓練新的 URL。
可直接提供網站 URL，系統會抓取其所有子頁；但對大型網站建議使用 XML sitemap，較有效率、且較不易出錯或陷入無限連結迴圈（可用 https://www.xml-sitemaps.com 產生）。
若只想訓練部分頁面，請建立 XML sitemap 後，用文字編輯器移除不想包含的頁面；將 sitemap 上傳至伺服器或任何可線上存取的位置，然後在 Chatbot > Training > Website 填入其 URL。若 URL 超過 1000 筆，建議分割成多個檔案，逐一訓練以避免伺服器當機。
大型檔案與 XML sitemap 可用 https://tmpfiles.org 上傳。

以「問答」訓練（Training via questions and answers）

路徑：Chatbot > Training > Q&A
可逐筆新增 Question / Answer。
更多詳情請點此。

以文章訓練（Training using articles）

新增您的文章後，點 Train chatbot；文章會自動作為訓練來源。
更多詳情請點此。

以流程訓練（Training using flows）

路徑：Chatbot > Flows
更多詳情請點此。

以對話訓練（Training using conversations）

啟用 Settings > Artificial Intelligence > OpenAI > Use conversations for training。
訓練資料會在接下來數日產生，並出現在 Chatbot > Training > Conversations。
此方法雖強大且自動化，但若真人代理或使用者訊息品質不佳，可能產生低品質訓練資料；強烈建議定期審查。多數情境不建議僅用此法；請優先使用聊天機器人訓練面板。

使用訓練面板（Training using the chatbot training panel）

完成初始訓練後，您可持續強化：從對話中挑選訊息，新增或改良 Q&A。
在對話區將游標懸停於某訊息，開啟訊息選單並選 Train chatbot。

若 Dialogflow 啟用，會在主 Agent 新增新 Intent。
若 OpenAI 啟用，會自動以新資訊訓練 OpenAI；並可於 Chatbot > Training > Questions and answers 管控所產生的 Q&A。
Services to update 可選擇要更新何種聊天機器人；當更新 Dialogflow Intent 時，會同時產生一個新的 OpenAI Q&A。
此訓練視窗不相容於 OpenAI assistants。

使用即時資訊訓練（Training using real-time information）

讓機器人回答需要即時資訊的問題（例如：「今天倫敦幾度？」）。

更多詳情請點此。

資訊（Information）

要新增訓練資料，只要再次訓練；先前資料不會遺失，僅會追加新來源。
雲端版對訓練字數有上限；PHP/WP 版本則無限制。字數上限請見此處。
Embedding 模型對訓練與處理所有使用者訊息至關重要。目前使用 text-embedding-3-small，不可停用或更換。價格資訊見 https://openai.com/pricing（**Embedding models** 區）。
於 Chatbot > Training > Information 可點 Delete all training data 移除所有既有訓練資料。
Embeddings 會以 JSON 檔儲存在 Support Board uploads 目錄，並以 password-by-filename 方式保護。

以 cron job 執行訓練（Run the training via cron job）

若使用雲端版，只要啟用 Settings > Artificial Intelligence > OpenAI > Training via cron job 即可，自動開啟 cron job；可忽略以下指示。
若要定期自動以網站內容訓練，建立一個 cron job 執行：
[SUPPORT-BOARD-URL]/include/api.php?open-ai-training=true
或使用指令：

*/59 * * * * wget [SUPPORT-BOARD-URL]/include/api.php?open-ai-training=true

以您的安裝 URL 取代 [SUPPORT-BOARD-URL]（可於 Settings > Miscellaneous > Installation URL 取得）。
使用雲端版請改用：
https://cloud.board.support/script/include/api.php?open-ai-training=true&cloud=API-TOKEN（以您的 API-TOKEN 取代）。
雲端版的 cron job 最多每 7 天執行一次。
強烈建議提供 XML sitemap 取代單一網站 URL，以利效能。
自動訓練僅限網站；不包含檔案、Q&A 與文章。重新訓練會刪除先前網站訓練資料。

多語訓練（Multilingual training）

若您的使用者為多語系，可以多種語言訓練，並限制機器人僅從使用者語言的來源擷取答案。請啟用 Settings > Artificial Intelligence > OpenAI > Multilingual Training Sources。

Files：目前僅支援單一語言。
Websites：自動偵測語言。為使 Support Board 能理解語言，<html> 必須包含 lang 屬性。
Q&A：目前僅支援單一語言。
Articles：會自動使用所有文章語言。
Conversations：若啟用自動翻譯，僅使用代理語言的訊息。

此章節內容將根據附件完整填入...

問答 (Q&A)

以下為聊天機器人訓練區「Questions and Answers」之相關資訊。新增 Q&A 可提升機器人表現，機器人會用這些資訊回覆使用者。

Question

輸入會觸發該答案的使用者訊息，可盡量加入多種變體。
例：「I'm a chatbot!」這個答案對應的問題可包含：Who are you?、What are you?、Are you a bot?。

Answer

輸入用來回覆使用者問題的文字。

函數呼叫

Function calling 可將機器人連接到外部工具/系統。機器人會呼叫您的伺服器，並將伺服器回傳資訊提供給使用者。傳送到您伺服器的資料位於請求 body，包含使用者輸入、使用者 ID、對話 ID。詳情見此處。

本功能屬進階用戶並需客製後端程式碼，官方支援不涵蓋；如需協助，歡迎聘用我們。

參數（Parameters）

URL：輸入 API endpoint 的 URL。
Headers：以逗號分隔的 key:value 標頭，如：apikey:123345, json:true。
Properties：使用者必須提供給機器人的值（如城市、追蹤編號等）。機器人會向使用者詢問；若您已知所有可能值，可填在 Allowed values 欄。

您的伺服器回應（Response from your server）

您的伺服器必須回傳JSON 陣列，包含機器人需要的值，例如：
["order_status" => "Delivered 2 hours and 25 minutes ago"]

設定數據和操作

當問題被詢問時，設定指定的使用者欄位值；您可在使用者詳情面板看到。
可使用以下合併欄位自訊息中擷取值並指派；將其包含於答案中會自動替換為實際值：{language}。
也可用來執行動作，如為對話指派部門、代理、標籤等。

此章節內容將根據附件完整填入...

流程 (Flows)

此區為聊天機器人的流程（flows）。Flows 讓您輕鬆建立由機器人驅動的對話流程，以一系列預先定義的訊息引導使用者達成目標。

Flow blocks

Start：設定流程何時啟動（每次新對話、特定訊息、或頁面載入）。若有設定條件，僅在全部條件成立時啟動。
Send message：向使用者傳送訊息。
Send button list：傳送按鈕列表。
Send video：傳送影片。
Get user details：取得使用者詳情並儲存於 Support Board；可在使用者詳情面板看到。使用預設欄位可留空描述；若使用自訂欄位則必填。
Set data：此區塊執行時，設定指定的使用者欄位；可在使用者詳情面板看到。
Actions：此區塊執行時，執行指定動作。
Conditions：建立條件分支；條件成立走 true 分支，否則走 false 分支。
Rest API：向您的伺服器傳送資料。body 必須為 JSON 陣列，且會自動包含 Support Board 的使用者詳情於 sb 鍵下。可用 save response 將回應中的特定值儲存到使用者詳情；使用 JSON dot notation。

本功能屬進階用戶並需客製後端程式碼，官方支援不涵蓋；如需協助，歡迎聘用我們。

資訊（Information）

Flows 可為多語。請於翻譯區新增訊息、按鈕文字等的翻譯；也可啟用multilingual via translation 自動翻譯。
若流程的預設語言不是英文，還需要於 Settings > Artificial Intelligence > OpenAI > Training Sources Language 設定預設語言。

資訊（Information）

此區為 AI 功能的資訊（Information）章節，提供關於人工智慧功能的重要資訊和設定說明。

AI 功能概述

Support Board 的 AI 功能包含多種智能服務，可大幅提升客服效率：

OpenAI 整合：支援 GPT 模型的智能對話
Dialogflow 整合：Google 的自然語言處理服務
智能回覆：即時回覆建議功能
人力接管：智能轉接真人客服
多語言支援：自動語言偵測和翻譯

設定要求

使用 AI 功能前，請確保：

已正確設定 OpenAI API 金鑰或 Dialogflow 憑證
伺服器支援 HTTPS 連線
已完成聊天機器人的基本訓練
設定適當的回應語言和地區

最佳實踐建議

定期更新訓練資料：保持聊天機器人的回應準確性
監控 API 使用量：避免超出配額限制
設定適當的人力接管規則：確保複雜問題能及時轉接
測試多語言功能：確保各語言版本運作正常

故障排除

如遇到 AI 功能問題，請檢查：

API 金鑰是否正確且有效
網路連線是否穩定
訓練資料是否充足
語言設定是否正確

GOOGLE

以下設定與「Artificial Intelligence（人工智慧）」應用程式相關。

同步（Synchronization）

開始使用 Google AI 服務與 Dialogflow，請依下列步驟。

自動同步模式（Automatic sync mode）

此功能僅適用於 Support Board 雲端版。

點擊 Synchronize now 並完成流程。
若要啟用 Dialogflow 聊天機器人，勾選 Settings > Artificial Intelligence > Google > Dialogflow chatbot。此外，您必須輸入聊天機器人的 Project ID 或 Agent Name（取得方式見下方步驟）。
使用此選項需要購買額度（credits）。

手動同步模式（Manual sync mode）

啟用 Support Board > Settings > Artificial Intelligence > Google > Dialogflow Chatbot，並儲存變更。
前往 console.cloud.google.com 並登入。
點左上 Select a project，選擇或建立專案（名稱可自訂）。
在頂部搜尋列輸入 Dialogflow API，進入後點 Enable 啟用。
選擇該專案，進入 Left menu > APIs and services > OAuth consent screen，選 External 並點 Create。
- App name 可任意填寫；User support email 與 Developer contact information 填您的電子郵件；點 Save and continue。
在 Data access 區塊，點 Add or remove scopes，捲到最下方 Manually add scopes 區域，輸入：

https://www.googleapis.com/auth/dialogflow, https://www.googleapis.com/auth/cloud-language, https://www.googleapis.com/auth/cloud-translation

然後點 Add to table、Update、Save and continue。
在 Audience 區塊，點 Add users，加入您的 Google 電子郵件（與目前登入相同），Save and continue 後點 PUBLISH APP。無需完成審核流程，可維持待審狀態。
前往 Left menu > APIs and services > Credentials，點 Create credentials 選 OAuth client ID。
- Application type 選 Web application；名稱任意；
- Authorised redirect URI 輸入重新導向 URL（於 Support Board > Settings > Artificial Intelligence > Google > Authorised redirect URI 取得）；點 Create。
複製 Client ID 與 Client Secret，貼到 Support Board > Settings > Artificial Intelligence > Dialogflow；儲存設定。
點 Support Board > Settings > Artificial Intelligence > Google > Synchronize；用同一個 Google 帳號登入；下一畫面點 Continue，再勾選所有 scopes 並 Continue。
複製 Refresh token，貼到 Support Board > Settings > Artificial Intelligence > Google > Refresh token。
完成！若要啟用 Dialogflow 聊天機器人，勾選 Settings > Artificial Intelligence > Google > Dialogflow chatbot，並輸入 Project ID 或 Agent Name（取得方式見下方）。注意：應用程式不需要通過 Google 審核。
若您使用 Google Workspace，至 https://admin.google.com/，點 Google Cloud Session control，將 Re-authentication policy 設為 Never require re-authentication。

對話流 (Dialogflow)

以下資訊與 Dialogflow 有關。警告！我們將在 2025 年底停止支援 Dialogflow。其全部功能將透過 OpenAI 在 Support Board 中提供。請改用 OpenAI，而非 Dialogflow。

取得 Project ID（Get Project ID）

造訪 dialogflow.cloud.google.com 登入 Dialogflow ES 主控台（必須使用同步時相同的 Google 帳號）。
點左上齒輪（聊天機器人名稱旁）開啟設定。若尚未建立聊天機器人，請依下方指引先建立。
複製 Project ID。
請在 Dialogflow 儀表板左上角選擇 US / GLOBAL。注意：本系統不支援 mega agents。

取得 Dialogflow CX Agent Name（Get Dialogflow CX Agent Name）

前往 https://dialogflow.cloud.google.com/cx/ 登入 Dialogflow CX。
選取目標代理所屬專案，進入 agents 頁（選取代理後點頂部 Agents > View all agents）。
於目標代理的選單中點 Copy name 複製名稱。
更多細節見：https://cloud.google.com/dialogflow/cx/docs/quick/api#detect-intent-drest。

位置（Location）

設定 Dialogflow agent 的位置或區域。若 agent 位置設為 global，此設定可選填。

歡迎意圖（Welcome Intent）

對新訪客觸發 Dialogflow Welcome Intent。需啟用 Settings > Messages & Forms > Welcome message。

傳送使用者詳細資料（Send the user details）

將註冊表單與電子郵件富訊息的使用者詳細資料送至 Dialogflow。

將 Intents 加入常用回覆（Add Intents to saved replies）

可將 Dialogflow Intents 納入常用回覆（Saved replies）。進入 Settings > Admin > Saved replies 管理。

建立基礎聊天機器人（Create a basic chatbot）

若您尚未建立聊天機器人，請依下列步驟建立第一個。Dialogflow 的建立與管理完全在 Dialogflow 內進行。網路上有大量教學可協助您設定 Dialogflow 機器人。

進入 Dialogflow 主控台建立 agent；Google project 請選與同步時相同的專案。
從左側選單新增 Intent 並開啟。
在 Training phrases 區填入希望機器人回覆的使用者問題，並盡量加入多種變體。
- 例如要回答公司地址，可加入：「what is your address」、「address」、「where are you」。
在 Responses 區新增文字回覆。若要加入按鈕、卡片等，可使用富訊息（rich messages）。
恭喜！您已建立第一組 Q&A。可在右側區域或於 Support Board 聊天中測試。持續新增 Intents 以擴充 Q&A。左側啟用 Small Talk 亦可匯入基礎 Q&A。

延伸資源：

chatbotslife.com/dialogflow-restaurant-bot-tutorial-1-45ce1d3c0ab5
tutorials.botsfloor.com/building-your-own-chatbot-using-dialogflow-1b6ca92b3d3f
marutitech.com/build-a-chatbot-using-dialogflow/

動作（Actions）

以下動作讓聊天機器人能代替使用者自動與網站互動。使用方式：在 Dialogflow 編輯某個 Intent，新增 Custom Payload 回覆，語法為：
{ "ACTION-NAME": ACTION-VALUE }

動作碼（Action code）｜說明（Description）

{ "human-takeover": true }｜啟動人力接管並停用聊天機器人。
{ "redirect": "URL" }｜將使用者導向指定 URL；加入 "new-window": true 可於新視窗開啟。
{ "open-article": ID }｜開啟指定 ID 的文章。
{ "transcript": true }｜產生文字檔對話紀錄並下載。設為 email 可改為寄送到使用者信箱；可加入 message: "Your message" 於郵件中附上訊息。
{ "tags": ["Tag 1", "Tag 2"] }｜為對話指派標籤。
{ "department": ID }｜變更/設定對話部門並通知代理。
{ "agent": ID }｜變更/設定對話指派代理並通知該代理。
{ "send-email": { "recipient": "active_user", "message": "", "attachments": [] } }｜寄信給目前對話的使用者或代理。附件語法：[["name","link"],["name","link"],...]。recipient 可為 active_user 或 agents。
{ "update-user": true }｜通知管理端更新本對話的使用者。可搭配其他動作即時更新管理端使用者資料。
{ "archive-chat": true }｜封存對話，若有啟用關閉訊息則一併傳送。
{ "update-user-details": { "email": "", "last_name": "", "first_name": "", "extra": { "phone": ["+123456789", "Phone"] }}}
｜更新目前對話使用者的詳細資料。可更新 first_name、last_name、email、user_type、password 等。
額外自訂欄位（如電話）請填在 extra 鍵下，語法："slug": [value, "label"]。可下載範例。上傳 Intent：至 Intents 頁面點右上三點選單 Upload Intent。以傳送訊息 "start" 開始對話。
{ "update-user-language": "$language" }｜更新使用者語言；若啟用多語聊天機器人，亦會同步更新聊天機器人語言以符合使用者要求。語言的 Dialogflow Entity 值以參數 $language 表示。

Dialogflow 實現

傳送到您 webhook URL 的 fulfillment 資料如下：

{ "responseId": "4a58fc4f...", "queryResult": { "queryText": "fullfilment", "parameters": [], "allRequiredParamsPresent": true, "fulfillmentText": "Example", "fulfillmentMessages": [ { "text": { "text": ["Response"] } } ], "outputContexts": [ { "name": "projects/schiocco...", "parameters": { "no-input": 0, "no-match": 0 } } ], "intent": { "name": "projects/schiocco...", "displayName": "Fullfilment" }, "intentDetectionConfidence": 1, "languageCode": "en" }, "originalDetectIntentRequest": { "payload": { "support_board": { "conversation_id": "3002", "user_id": "3777" } } }, "session": "projects/example/agent/sessions/3777-3002" }

其中 payload 與 session 欄位包含 Support Board 的 user ID 與 conversation ID。

Dialogflow 資訊（Dialogflow Information）

OpenAI

若 OpenAI 啟用，Dialogflow 具有優先權。只有當 Dialogflow 無法回答使用者問題時，才會呼叫 OpenAI API。

聊天機器人訓練與優化（Chatbot training and optimization）

機器人需要一段時間才能穩定正確地回答所有問題。請持續新增問題變體與 Intents 來訓練，以提升表現。
代理可在管理端即時新增 Intents 與回覆、或替既有 intents 新增訓練語句：將滑鼠移至訊息上，點 Dialogflow Intent 圖示即可。
- 啟用 Settings > Artificial Intelligence > OpenAI > Generate user questions 可自動增加問題變體並改寫答案。
- 新 Intents 會包含回覆；更新既有 intents 只會新增訓練語句，不會新增回覆。
- 若使用 Dialogflow CX，回覆會加到對話中最新使用的 flow；若無則加到 start flow。
若機器人回覆落入錯誤的 intents，可至 Dialogflow Console > chatbot Settings > ML Settings，將 ML CLASSIFICATION THRESHOLD 調高（如 0.6），並檢查 Intent detection confidence。

Dialogflow Intent detection confidence

Dialogflow 對潛在匹配的 intent 會給定信心分數（0.0～1.0）。
請設定 0.1～1.0 的門檻；低於此值的回覆將不採用。
若您同時使用經自家資源訓練的 OpenAI 聊天機器人，建議將此值設為 0.81。

知識庫（Knowledge Base）

Knowledge Base 預設啟用，可讓機器人在文件（如 PDF）或網頁中搜尋答案。
建立方式請見：https://cloud.google.com/dialogflow/docs/knowledge-connectors

Dialogflow 回應（Dialogflow response）

完整的 Dialogflow JSON 回應會自動儲存於資料庫 sb_messages 的 payload 欄位。

若不符合關鍵字則略過 Intent（Ignore an Intent if it doesn't fit the provided keywords）

有時不同主題卻相似的提問會造成 Dialogflow 回錯。您可要求 Support Board 在使用者訊息未包含指定關鍵字時忽略某 Intent：
1. 進入 Dialogflow 編輯該 Intent。
2. 在每個 training phrase 中，選擇要「必要」的關鍵字，並將其連結到新或既有的 Entity。
3. 在 Actions and parameters 勾選 Required，新增 Prompt，值填 skip-intent。
4. 儲存 Intent。

多語系聊天機器人（Multilingual chatbot）

Artificial Intelligence > Google > Multilingual 功能會檢查是否存在符合使用者語言的 Dialogflow 代理，若有則自動啟用該代理。

要讓此功能運作，系統必須知道使用者語言。語言判定依序如下：

若使用者詳細資料（user detail）已設定語言，則以該值為準；
否則以使用者瀏覽器語言為準；
也可透過語言偵測（language detection）功能自動判定。

自動翻譯（Automatic translation）

自動翻譯會把使用者訊息即時翻成代理的語言，並把代理訊息即時翻成使用者的語言。啟用方式：勾選 Settings > Artificial Intelligence > Automatic translation。
若您使用雲端版且 Artificial Intelligence > Google > Sync mode 設為 Automatic，多語功能會自動運作；否則請完成下列同步與設定。Multilingual via translation 與 language detection 也需要同樣的設定步驟。

設定步驟（Setup）

以 Google 帳號登入 https://console.cloud.google.com，並選擇您的 Dialogflow Agent 所屬專案。
在頂部搜尋列輸入 cloud translation，選 Cloud Translation API 並啟用。此服務為付費（含免費額度），可能產生額外費用。
於左側選單 Billing 啟用計費帳戶並綁定有效付款方式。

說明（Information）

管理後台的使用者訊息會即時翻成代理語言。
代理訊息會即時翻成使用者語言。
代理可透過訊息選單點選 View original message 檢視原文。
代理語言判定：若代理的 user detail 有語言設定則優先；否則取瀏覽器或管理後台語言。
使用者語言判定：先看使用者的 user detail；否則取聊天語言設定；再否則取瀏覽器語言。也可用語言偵測功能。
通知內容也會被翻譯。
若要避免某段字串被翻譯，請以 ` 或 ``` 將其包住。

透過翻譯實現多語（Multilingual via translation）

Settings > Artificial Intelligence > Multilingual via translation 功能會：

將使用者訊息翻成 Dialogflow 或 OpenAI 的預設語言；
將 Dialogflow 或 OpenAI 的回覆翻回使用者語言；
也會翻譯聊天介面中的所有文字（例如：聊天機器人的富訊息、文章、註冊表單、彈出式通知等）。
為了效能與降低費用，翻譯結果會自動寫入翻譯檔快取。建議與語言偵測一起使用可獲得最佳效果。

若英文（English）是支援語言之一，英文必須是預設語言，且原始文本必須為英文。
若您使用 OpenAI + 訓練資料，請在 Settings > Artificial Intelligence > OpenAI > Training Sources Language 設定訓練資料預設語言；若訓練資料原本就是英文，可維持預設。

語言偵測（Language detection）

偵測使用者訊息的語言，並據此變更使用者語言與 Dialogflow 代理語言（若有對應），否則顯示後備訊息（fallback message）。您可在訊息中使用合併欄位 {language_name} 插入語言名稱。

使用者訊息需至少2 個單字。
語言偵測只對同一個對話的前 2 則訊息執行。
只要 OpenAI 聊天機器人運作且能回答一般問題，後備訊息就不會送出，因為 OpenAI 會始終回覆任何使用者訊息。

Google 搜尋（Google search）

Settings > Artificial Intelligence > Google search 讓聊天機器人可在 Google 上搜尋即時資訊。適用於需要最新資料的提問。

設定步驟

前往 https://programmablesearchengine.google.com/ 註冊。
建立搜尋引擎並依需求設定。若希望回覆一般問題，建議只加入您的網站與 Wikipedia，並停用「Search the entire web」。可用 Entities 功能排除不相關結果。
進入 Edit search engine > Setup > Basic，複製 Search engine ID，貼到 Support Board。
取得 API 金鑰：至 https://developers.google.com/custom-search/v1/overview 按 Get a key。

拼字更正（Spelling correction）

當 Dialogflow 找不到合適回覆時，會先檢查是否有拼字錯誤；若有，會以修正後的訊息再次查詢 Dialogflow。此功能優先度較低，但可與 OpenAI 的 Dialogflow 拼字更正同時運作。

實體（Entities）

Entities 會分析使用者訊息，辨識並擷取城市、事件、日期等實體，用來排除 Google 搜尋的不良結果。啟用方式如下：

以 Google 帳號登入 https://console.cloud.google.com，選擇您的 Dialogflow 專案。
在頂部搜尋列輸入 Cloud Natural Language API，選擇後啟用。
於 Billing 啟用計費並為該專案綁定付款方式。

說明（Information）

僅當聊天機器人不知道答案且使用者訊息長度大於 4 個字元時，才會執行 Google 搜尋。
若 Google 搜尋有結果，會自動啟用 Dialogflow context：google-search，其中包含屬性 link（搜尋結果的網址）。可用此 context 建立新 Intent，當使用者說 tell me more / I want to know more 時提供該連結。
啟用拼字更正不一定要開啟 Google 搜尋；您可以停用 Google 搜尋，只保留拼字更正。
Google 搜尋相容於 OpenAI 聊天機器人。

工單（TICKETS）

Tickets 應用可讓使用者透過與聊天不同的前台 UI 建立對話與傳送訊息。

安裝（Installation）

進入 Settings > Apps，點 Tickets，輸入授權金鑰以安裝並啟用。雲端版請點 Active。更多資訊請見「here」（原文連結）。

顯示 Tickets 區域（Display the tickets area）

PHP 版本

在頁面中加入下列腳本：

<script src="supportboard/js/min/jquery.min.js"></script> <!-- 若已載入 jQuery 可省略 -->
<script id="sbinit" src="supportboard/js/main.js?mode=tickets"></script>

同一頁不可同時載入聊天與 tickets；請移除載入聊天的腳本。
也可在任何顯示聊天的頁面插入 <script>SB_TICKETS = true;</script> 顯示 tickets 區域。
要指定 tickets 區域位置，加入 <div id="sb-tickets"></div>，tickets 會顯示在此元素內；若未加入，預設附加在 <body>。

WordPress 版本

使用短代碼 [sb-tickets]，可插入任何頁面、文章或自訂文章類型。

雲端版（CLOUD VERSION）

在頁面加入聊天嵌入碼，並在腳本 URL 後加上 &mode=tickets，例如：

<script id="chat-init" src="https://cloud.board.support/account/js/init.js?id=65895623&mode=tickets"></script>

亦可在任何顯示聊天的頁面加入 <script>SB_TICKETS = true;</script>。

說明（Information）

若 tickets 區域未顯示，請確認取消勾選 Tickets > Manual initialization，並可參考此處列出的其他可能原因（原文連結）。
tickets 區域也可用於顯示行內或全寬的聊天面板。
在管理端，tickets 與聊天對話相同；差異僅在前台 UI。
多數聊天設定與 Tickets App 相容，但儀表板設定、彈出訊息等不相容。
Tickets App 提供專用 API（詳見 API 章節）。
若要移除新使用者必填的 New ticket 表單：啟用 Settings > Messages & Forms > Welcome message。在 tickets 區域，歡迎訊息延遲會被忽略並立即送出。
只在單一頁面手動停用必填註冊：使用 JS var SB_REGISTRATION_REQUIRED = true;（設為 true 代表強制註冊）。
tickets 區域支援 Google reCaptcha v3。

以下設定與 WhatsApp 應用相關。

安裝（Installation）

進入 Settings > Apps，點 WhatsApp，輸入授權金鑰安裝並啟用。雲端版請點 Active。

WhatsApp Cloud API 設定 — 自動同步模式（Automatic sync mode）

僅適用於雲端版。

點 Synchronize now 並完成流程。
新增號碼：https://business.facebook.com/wa/manage/phone-numbers/。若同步後才新增新號碼，需再次同步；所有號碼會自動同步。若想停用指定號碼，可在 Settings > WhatsApp > Cloud API numbers 中刪除。
若再次同步同一門號卻未收到驗證簡訊/來電，可輸入最近一次收到的 PIN 也能通過。
若 Support Board 收不到傳到您 WhatsApp 號碼的訊息，請檢查：
- 點
  WhatsApp
  以下設定與 WhatsApp 應用相關。
  
  安裝（Installation）
  
  進入 Settings > Apps，點 WhatsApp，輸入授權金鑰安裝並啟用。雲端版請點 Active。
  
  WhatsApp Cloud API 設定 — 自動同步模式（Automatic sync mode）
  
  僅適用於雲端版。
  1. 點 Synchronize now 並完成流程。
  2. 新增號碼：https://business.facebook.com/wa/manage/phone-numbers/。若同步後才新增新號碼，需再次同步；所有號碼會自動同步。若想停用指定號碼，可在 Settings > WhatsApp > Cloud API numbers 中刪除。
  3. 若再次同步同一門號卻未收到驗證簡訊/來電，可輸入最近一次收到的 PIN 也能通過。
  4. 若 Support Board 收不到傳到您 WhatsApp 號碼的訊息，請檢查：
    
    點 Reconnect 並完成流程；
    
    進入 Meta Business Suite，新增付款方式。
  WhatsApp Cloud API 設定 — 手動同步模式（Manual sync mode）
  1. 至 https://developers.facebook.com 建立新帳號或登入。
  2. 建立新 App，App Type 選 Other，接著選 Business，輸入 App 名稱並選擇用於 WhatsApp 的 Business Account。
  3. 在 Support Board > Settings > WhatsApp > Cloud API settings > Secret key 輸入一組隨機字串。
    
    回到 https://developers.facebook.com/apps 選你的 App；Add product 加入 WhatsApp。
    
    在 WhatsApp > Configuration 的 Webhook URL 輸入 Support Board > Settings > WhatsApp > Cloud API > Configuration URL 提供的 URL；Verify token 輸入剛才的 Secret key。按 Verify and save。
    
    點 Webhook fields > Manage，啟用 messages。
  4. 驗證整合：於開發者後台左選單 WhatsApp > API Setup 複製 Phone number ID，貼到 Support Board > Settings > WhatsApp > Cloud API numbers > Phone number ID。
    
    在 To 欄輸入測試接收號碼（例如您個人 WhatsApp），送出測試訊息。於 WhatsApp 回覆後，應能在 Support Board 看到訊息。
    
    要由 Support Board 回覆測試號碼，複製 Temporary access token 並貼到 Support Board > Settings > WhatsApp > Cloud API numbers > Token。
  5. 啟用所有門號與上線號碼：
    
    在 Support Board > Settings > WhatsApp > Cloud API numbers > Token 填入永久存取權杖（取得方法如下）。
    
    進入 https://business.facebook.com：Settings > Business settings > Users > System Users 檢視或建立系統使用者（需為管理員）。
    
    對該使用者 Add Assets：選用於 WhatsApp API 的 App，勾 Develop App / Full control。
    
    左選單 Account > Apps：確認已指派該系統使用者且為 Full control；若無，Add user 並勾 Full control。
    
    左選單 Apps 下 Select Assets 指定 App，給 Full control。
    
    左選單 WhatsApp accounts 選與 App 連結的帳戶，Assign people 指派該系統使用者並給 Full control。
    
    回 Users > System Users 選該使用者，按 Generate New Token，App 選 WhatsApp 用的 App，Token expiration 設 Never，權限勾：whatsapp_business_management, whatsapp_business_messaging, business_management，按 Generate Token 並保存。把此 Token 貼入 Support Board > Settings > WhatsApp > Cloud API numbers > Token。
  6. 新增更多門號：到開發者後台 WhatsApp > API Setup 按 Add phone number 依指示操作。
  7. 啟用後複製 Phone number ID，貼到 Support Board > Settings > WhatsApp > Cloud API numbers > Phone number ID。
  8. 若門號狀態為 pending，到 WhatsApp > API Setup 點 Generate access token。
  注意：若將現用的 WhatsApp Business 號碼接入 Support Board，之後無法再搭配 WhatsApp Business App 使用；如需遷移，請依官方指引操作。
  
  360dialog 帳號設定
  1. 造訪 https://www.360dialog.com/ 建立帳號。
  2. 於左側 WhatsApp Accounts 產生 API key，貼到 Support Board > Settings > WhatsApp > 360dialog settings。
  3. 點 Support Board > Settings > WhatsApp > 360dialog settings > Synchronize now。
  4. 完成後，Support Board 應能接收 WhatsApp 訊息並回覆。
  可使用免費 sandbox 測試（https://docs.360dialog.com/whatsapp-api/whatsapp-api/sandbox），但部分功能受限（如媒體附件）。
  
  Twilio 帳號設定
  1. 前往 https://www.twilio.com 建立帳號。
  2. 驗證您的電話號碼。
  3. 完成表單並選擇 WhatsApp, Alerts & Notifications, With no code at all, 3rd party integrations。
  4. 從 Twilio 主控台複製 ACCOUNT SID 與 AUTH TOKEN，貼到 Support Board > Settings > WhatsApp > Twilio settings 並儲存。
  5. 設定免費測試：左選單 Messaging > Settings > WhatsApp sandbox settings，在 WHEN A MESSAGE COMES IN 與 STATUS CALLBACK URL 填入 Support Board > Settings > WhatsApp > Twilio settings > Get configuration URL 提供的 URL。
    
    注意：localhost 不支援；需公開網址與正式伺服器。
  6. 左選單 Messaging > Try it out > Send a WhatsApp message，依指示傳送含代碼的訊息至提供的 WhatsApp 號碼，完成設定。
  7. 完成後，Support Board 應可收發 sandbox 訊息。
  對外上線需再完成：
  - 升級帳戶並啟用計費。
  - 購買 Twilio 號碼做為官方 WhatsApp Business 號碼（不可使用既有的 WhatsApp Business 號碼；需使用 Twilio 號碼）。
  - 主控台 Messaging > Services 建立 Messaging Service，點 Add Senders 選 WhatsApp Number 並加入購買的 Twilio 號碼。複製 Service SID，貼入 Support Board > Settings > WhatsApp > Twilio settings > Sender。
  非官方 WhatsApp API
  
  Support Board 只支援官方 WhatsApp Cloud API、360dialog 或 Twilio。
  不支援非官方 API，但您仍可透過 Support Board API 與 Webhooks 自行整合：https://board.support/docs/api/web。
  請注意此作法需要開發能力，且官方整合具備更完整功能（聊天機器人、自動訊息、人力接管、WhatsApp 富訊息、附件等）；雖然基本收發文字訊息不難，但要達到穩定完善仍較複雜。
  blockquote style="background-color: #fff3cd; border-left: 4px solid #ffc107; padding: 15px; margin: 15px 0;">
  注意：若將現用的 WhatsApp Business 號碼接入 Support Board，之後無法再搭配 WhatsApp Business App 使用；如需遷移，請依官方指引操作。
  
  360dialog 帳號設定
  1. 造訪 https://www.360dialog.com/ 建立帳號。
  2. 於左側 WhatsApp Accounts 產生 API key，貼到 Support Board > Settings > WhatsApp > 360dialog settings。
  3. 點 Support Board > Settings > WhatsApp > 360dialog settings > Synchronize now。
  4. 完成後，Support Board 應能接收 WhatsApp 訊息並回覆。
  Twilio 帳號設定
  1. 前往 https://www.twilio.com 建立帳號。
  2. 驗證您的電話號碼。
  3. 完成表單並選擇 WhatsApp, Alerts & Notifications, With no code at all, 3rd party integrations。
  4. 從 Twilio 主控台複製 ACCOUNT SID 與 AUTH TOKEN，貼到 Support Board > Settings > WhatsApp > Twilio settings 並儲存。

範本（Templates）

WhatsApp 範本訊息的設定與使用。

注意：WhatsApp 範本功能需要特定的設定和審核流程，請參考官方文檔進行配置。

WhatsApp 流程

關於 WhatsApp Flows 的更多資訊請「click here」（原文連結）。

內建 Flows（Built-in flows）

Support Board 會自動產生並發送以下 flow。若需重建，點 Settings > WhatsApp > Clear flows。

Registraton（原文拼字如是）— 當新使用者首次傳訊至 WhatsApp 號碼，且 Settings > Users > Require registration 啟用時發送。
Follow-up — 當 Settings > Messages & Forms > Follow-up message 啟用且使用者沒有 Email時發送。

發送自訂 Flows（Send custom flows）

使用合併欄位：

{wa_flow id="123" header="" body="" button=""}

將 123 換成 flow ID，並為 header / body / button 填入文字。

WhatsApp 商店（WhatsApp shop）

若要在 WhatsApp 中顯示商店的產品，請使用以下合併欄位（merge fields）。

合併欄位	說明
`{catalog id="123" product_id="123" body="" footer=""}`	顯示單一產品。將 `id` 換成目錄（catalog）ID，`product_id` 換成產品 ID。屬性 `body` 與 `footer` 為可選。
`{catalog id="123" product_id_1_1="123" product_id_1_2="123" product_id_2_1="123" section_1="" section_2="" header="" body="" footer=""}`	顯示多個產品。將 `id` 換成目錄 ID。以區塊（sections）分組新增產品，使用屬性 `product_id_[A]_[B]`，其中 [A] 為區塊索引（自 1 起算），[B] 為該區塊內產品索引（每個區塊自 1 起算）。每個區塊都必須同時新增 `section_[A]=""` 屬性。屬性 `header` 與 `body` 為必填，`footer` 為可選。

當使用者送出訂單時，訂單資訊會送至 Settings > WhatsApp > Order webhook 中指定的 URL。該 URL 頁面應處理訂單，並透過 PHP API 函式 sb_whatsapp_send_message() 回覆使用者訊息。
要將商店連接到 WooCommerce 請點此。

MESSENGER

以下設定與 Messenger 應用程式相關。

安裝（Installation）

在 Settings > Apps 點選 Messenger，輸入授權金鑰以安裝並啟用。雲端版請點 Active。更多資訊請見此處。

自動同步模式（Automatic sync mode）

完成同步時，至少選擇 1 個 Facebook 專頁，並將回傳的資訊填入 Settings > Messenger > Facebook pages。
完成！所有發送到你所選 Facebook 專頁與 Instagram 帳號的訊息，將出現在 Support Board 管理端的對話區。請注意只會同步新的訊息，舊訊息不會匯入。

手動同步模式（Manual sync mode）

於 https://developers.facebook.com/ 建立新帳戶或登入現有帳戶。
建立新 App，App type 選 Other，再選 Business。輸入 App 名稱，並略過選擇任何 Business portfolios。
左側選單 Add product → 選 Messenger。
Configure webhooks 區塊點 Configure。
從 Settings > Messenger > Messenger and Instagram settings > Get configuration URL 取得 Callback URL。
將 Settings > Messenger > Messenger and Instagram settings > Secret key 的值設為 Verification Token 並儲存，接著用它來驗證 webhook。
在 Webhook Fields 勾選：inbox_labels, message_deliveries, message_echoes, message_reactions, message_reads, messages, messaging_account_linking, messaging_handovers, messaging_optins, messaging_policy_enforcement, messaging_postbacks, messaging_referrals。
在 Generate access tokens 區塊點 Connect。選擇要同步的專頁並完成流程。
在 Webhook Subscription 欄點 Add Subscriptions，選 messages, messaging_postbacks, messaging_optins, message_reads, message_echoes。
在 Tokens 欄點 Generate 產生 access token，貼到 Settings > Messenger > Facebook pages。
複製 Page ID 與 Page Name，貼到 Settings > Messenger > Facebook pages。
針對所有專頁重複上述步驟。儲存設定，即可。最後一步：將 App 切換為 Live mode。

若也要同步 Instagram：

左側選單 Messenger > Instagram settings。
Configure webhooks 區塊點 Configure，重複與 Messenger 相同步驟。
Webhook Subscription 區塊點 Add Subscriptions，選：messages, messaging_postbacks, messaging_optins, messaging_seen。
在 Settings > Messenger > Facebook pages > Instagram ID 輸入你的 Instagram ID。取得方式：瀏覽器開啟
https://graph.facebook.com/FACEBOOK-PAGE-ID/?access_token=ACCESS-TOKEN&fields=instagram_business_account
將 FACEBOOK-PAGE-ID 與 ACCESS-TOKEN 分別替換為已連結 Instagram 的 Facebook 專頁之 Page ID 與該專頁的 access token。
儲存設定即可。最後，將 App 切換為 Live mode。

你的 App 必須在 Live mode。要上線，必須提交並通過 Meta 審核。審核文案可參考「this」（原文連結）。此流程不在支援範圍；如需協助，可聘請我們。

Instagram

將 Instagram 連結到你的 Facebook 專頁與 Support Board：

進入你的 Facebook 專頁設定：左側 Instagram（https://www.facebook.com/YOUR-PAGE-SLUG/settings/）。
點 Connect account 並完成設定。
重新同步 Messenger 與 Support Board 即完成。僅會同步新訊息；舊訊息不會匯入。

資訊（Information）

若收不到 Instagram 訊息：
- 請在行動版 Instagram App 啟用 Settings > Privacy > Messages & Forms > Connected tools - Allow access。
- Instagram 帳號需為商業（business）帳號，不可是專業（professional）帳號。
- 至 Meta Business Suite：選你的帳戶 → Users > People，在 Instagram account 下點 Manage 並啟用所有權限。
若收不到 Facebook Messenger 訊息：確認 Facebook 專頁未啟用自動回覆（如歡迎訊息）。
若遇到重複訊息或聊天機器人與 Instagram 訊息互相循環的情形，可能是兩個 Support Board 安裝或雲端帳號同時同步到同一 Instagram 帳號。請至另一個 Support Board 管理端 Settings > Messenger > Facebook pages，移除 Instagram ID 並儲存。也可嘗試點 Unsubscribe。
Unsubscribe 會移除你所有 Facebook 專頁的 webhook 訂閱，用於停止接收某專頁的訊息。
每個 Support Board 使用者只有 1 個 Facebook 對話與 1 個 Instagram 對話。
Support Board 的富訊息會在可行時自動轉為 Facebook 的富訊息；部分元素可能被移除或更改。按鈕、chips 與下拉最多支援三個選項，且只在 Instagram 行動 App支援。
只有私訊會進入團隊收件匣；貼在牆上的公開訊息不會進入。
當有人傳訊至你的 Facebook 專頁或 Instagram 帳號，該使用者會在 Support Board 被標示為 lead；你只能看到其 Facebook/Instagram 的名稱與頭像。
Messenger 對話與訊息支援佇列與路由。
聊天機器人與人力接管皆受支援。
受支援的 AI 功能：語言偵測、拼字更正、透過翻譯的多語、Google 搜尋。
若啟用聊天機器人，需停用 Facebook Messenger 上的任何自動回覆（例如歡迎訊息）。
Follow-up message 受支援，但無論代理是否回覆，訊息都會送出。
Offline message 受支援，但不會傳送時間表。
僅能同步一個 Facebook 帳號；若要連結多個帳號下的專頁，Support Board 同步用的該帳號必須是所有其他專頁的管理員。
使用 Instagram 與 Facebook Messenger 的此整合不需額外費用。
若訊息超過 1000 字元，因字元限制，只會傳送前 1000 字元。
僅同步同步後的新訊息；舊訊息不會匯入。
使用者資料刪除申請（僅雲端版）：點 Settings > Messenger > Unsubscribe，再至此處刪除你的帳號。

TWITTER

此章節內容將根據附件完整填入...

VIBER

以下設定與 Viber 應用相關。

安裝（Installation）

在 Settings > Apps 點 Viber，輸入授權金鑰安裝並啟用。雲端版點 Active。更多資訊請見此處。
於 https://partners.viber.com/account/create-bot-account 建立 bot。
複製 token，貼到 Support Board > Viber > Token，點 Synchronize now。網站必須 HTTPS；HTTP 不支援。
完成！所有傳給你的 Viber bot 的訊息將出現在 Support Board 管理端。

SLACK

以下設定與 Slack 應用相關。

安裝（Installation）

於 Settings > Apps 點 Slack，輸入授權金鑰安裝並啟用。雲端版點 Active。更多資訊請見此處。
安裝後至 Settings > Slack，點 Synchronize now，依指示操作。

有問題嗎？（Having Problems?）

Slack 同步可能失敗，常見原因與解法如下：

問題描述	解決方案
能在 Slack 收到訊息，但無法從 Slack 回覆到 Support Board	瀏覽 `/<your_site>/supportboard/apps/slack/post.php`。此外在 Workspace Settings > Permissions 必須允許任何人建立公開頻道。若仍有問題，請洽 Slack 支援：https://api.slack.com/support。
Slack 同步未生效	確認你在同步時選擇的是公開頻道。若不是，請重新同步並選擇公開頻道（建議 #general）。

手動封存頻道（Manually archive channels）

開啟要封存的 Slack 頻道。
右上角點齒輪 → Additional options。
點右上資訊（info）圖示 → More → Additional options... → Archive this channel。

部門連結（Department linking）

若啟用 Settings > Slack > Department linking：

當 Support Board 中的對話被指派到某部門時，系統會在該部門對應的 Slack 頻道送出新訊息，通知 Slack 使用者有新對話開始，並邀請他們加入該使用者的專屬 Slack 頻道。
完整對話僅能在該使用者專屬頻道中查看。

取得 ID：

部門 ID：Settings > Miscellaneous > departments。
頻道 ID：按 Get channel IDs 取得。

使用者欄位（User fields）

Settings > Slack > User fields 可設定當新使用者首次傳訊時，推送到主頻道的訊息中要包含哪些使用者資料欄位。可加入自訂 user detail 的 slug，或以下預設：
browser, browser_language, location, email, user_type, token, creation_time, country_code, current_url, os, city, address, postal_code, phone, birthdate, company, timezone, website。預設為：email, browser, browser_language, location。

資訊（Information）

當新使用者首次傳訊時，會在同步時選擇的主頻道或與部門連結的頻道收到一則包含使用者詳情與加入其專屬頻道按鈕的 Slack 訊息。同步所用的 Slack 帳號會自動加入該使用者頻道；其他成員需透過按鈕手動加入。
當 Settings > Slack > Agent linking 啟用且對話被指派到某部門時，只有該部門的代理會收到訊息；若對話被指派給單一代理，則只有該代理會收到訊息。
Slack 可免費使用；僅大型公司可能需要付費方案，詳情見官方。
推播通知可與 Slack 相容；代理若透過 Slack 回覆，會向使用者發送推播通知。
若使用 Dialogflow，當聊天機器人知道答案時，不會將訊息送往 Slack；一旦啟動人力接管，該對話之後的訊息會送到 Slack。
Slack App 與Email piping與訊息應用相容。
刪除或離開頻道不支援；僅支援封存。
當在 Support Board 封存對話時，連結的 Slack 頻道也會封存。
透過 Slack 回覆使用者，若使用者同時被Email 或簡訊通知，系統會回送 Slack 訊息提醒你。
可用 Slack 指令 /archive 從 Slack 端封存對話。

LINE

以下設定與 LINE 應用相關。

安裝（Installation）

在 Settings > Apps 點 LINE，輸入授權金鑰安裝並啟用。雲端版點 Active。更多資訊請見此處。
於 https://developers.line.biz/console/ 登入或建立帳戶。
建立新 Provider 與 Messaging API channel，channel type 選 Messaging API。
在 channel Basic settings 複製 Channel secret，貼到 Support Board > Settings > Line > Synchronization > Channel secret。
在 channel Messaging API 產生 Channel access token (long-lived)，複製並貼到 Support Board > Settings > Line > Synchronization > Access token。
將 Webhook URL 設為 Support Board > Settings > Line > Synchronization > Webhook URL 提供的 URL，並點 Verify。
啟用 Use webhook。
用 LINE App 掃描 QR Code 與你的 channel 對話。
停用 Auto-reply messages。
完成！所有傳給你的 LINE bot 的訊息將出現在 Support Board 管理端。

WECHAT

以下設定與 WeChat（微信） 應用相關。

安裝（Installation）

在 Settings > Apps 點 WeChat，輸入授權金鑰安裝並啟用。雲端版點 Active。更多資訊請見此處。
造訪 https://mp.weixin.qq.com/cgi-bin/readtemplate?t=register/step1_tmpl&lang=en_US 註冊服務號（Service account）。
註冊後進入公眾平台左側 Settings and development > WeChat verification 完成認證（需數週、費用 USD 99；中國境內主體 CNY 300）。
左側 Settings and development > Basic configuration 複製 Developer ID(App ID) 與 Developer Password(App Secret)，貼到 Support Board > Settings > WeChat。
同頁 Basic configuration 完成伺服器配置（服务器配置(已启用)）：
- Server Address(URL) 輸入 Support Board > Settings > WeChat > Synchronization > Get configuration URL 提供的 URL；
- Token 可輸入任意值，但需同時在 Support Board > Settings > WeChat > Token 輸入相同值。
完成！所有傳至你的 WeChat 帳號的訊息將出現在 Support Board 管理端。

ZALO

以下設定與 Zalo 應用相關。

安裝（Installation）

在 Settings > Apps 點 Zalo，輸入授權金鑰安裝並啟用。雲端版點 Active。更多資訊請見此處。
於 https://developers.zalo.me/ 註冊並建立新 App，填入必要資訊並儲存。
複製該 App 的 Application ID 與 Application secret key，貼到 Support Board > Settings > Synchronization > Zalo。
左側 Webhooks 設定 URL（從 Support Board > Settings > Zalo > Synchronization > Webhook URL 取得）。
左側 Webhooks 複製 OA Secret Key，貼到 Support Board > Settings > Zalo > Synchronization > OA secret key。
左側 Webhooks 啟用以下 webhook 事件：
user_send_location, user_send_image, user_send_link, user_send_text, user_send_sticker, user_send_gif, user_received_message, user_seen_message, oa_send_text, oa_send_image, oa_send_list, oa_send_gif, user_send_audio, user_send_video, user_send_file, user_reacted_message, user_received_message
左側 Official Account > OA Management 連結你的 Official Account。
上方 Tools > API Explorer（或 https://developers.zalo.me/tools/explorer/），Access token type 選 OA Access Token → Get Access Token → 選你的 OA。複製 Refresh token 並貼到 Support Board > Settings > Zalo > Synchronization > Refresh token。更多資訊見官方文件。
左側 Role 新增一位測試用戶為 admin。你將使用該帳號向 OA 傳訊以測試整合。
左側 Sign up to use API > Official AccountAPI 啟用 User Management 並提交審核（Submit for review）。
完成！所有傳至你的 Zalo Official Account 的訊息將出現在 Support Board 管理端。

Zendesk

以下設定與 Zendesk 應用相關。

安裝（Installation）

在 Settings > Apps 點 Zendesk，輸入授權金鑰安裝並啟用。雲端版點 Active。更多資訊請見此處。
Domain：取自你的 Zendesk 管理端 URL 的網域首段，例如 https://domain.zendesk.com/，若你的 URL 是 https://supportboard.zendesk.com/agent/get-started/ticketing-system/ticketing-intro，則網域為 supportboard。
API key：左側 Admin > Channels > API > Settings，點 Add API token。
Email：填你的 Zendesk 帳號 Email。

PERFEX CRM（Perfex）

以下設定與 Perfex 應用相關。

安裝（Installation）

安裝分兩步：

在 Settings > Apps 點 Perfex，輸入授權金鑰安裝並啟用。更多資訊請見此處。雲端版不相容 Perfex。
安裝後到 Settings > Perfex 輸入 資料庫資訊與 Perfex URL。這些資訊可於 Perfex 安裝目錄下 application/config/app-config.php 取得。若不確定 Perfex 前綴可留空，預設為 tbl。
進入 Perfex 管理端 → Setups > Modules，上傳 module.zip 安裝 Support Board 模組。安裝後至 Setups > Support Board 輸入 Support Board 外掛 URL（Settings > Miscellaneous > Installation URL 取得；WordPress 版格式如 https://example.com/wp-content/plugins/supportboard/supportboard）。
若要在 Perfex 管理端內嵌顯示 Support Board：Support Board 必須與 Perfex 安裝於同網域與同檔案系統。若有問題或更改 Perfex DB 設定，請確認 supportboard/config.php 使用正確的 Perfex DB 設定。在 Support Board 後台更新設定不會自動更新 config.php。

WHMCS

以下設定與 WHMCS 應用相關。

安裝（Installation）

此流程包含兩個安裝：WHMCS 外掛（add-on）與 Support Board App。

App 安裝

在 Settings > Apps 點 WHMCS，輸入授權金鑰安裝並啟用。更多資訊請見此處。雲端版不相容 WHMCS。
安裝後至 Settings > WHMCS 輸入 資料庫資訊與 WHMCS URL。

WHMCS 外掛安裝

下載 addon.zip（此處下載），將其中的 supportboard 資料夾複製到 WHMCS 安裝路徑的 /modules/addons/。
進入 Configuration > System Settings > Addon Modules，找到 Support Board 模組並 Activate（更多資訊：https://docs.whmcs.com/8-13/addon-modules/addon-modules/）。
點 Configure 並輸入 Support Board 外掛 URL。

如何更新（How to update）

在 Support Board 更新 WHMCS App 很簡單，你可以啟用自動更新或手動更新（詳情見此處）。
更新 WHMCS 外掛：下載最新版 addon.zip（https://board.support/docs/files/whmcs/addon.zip），並手動覆蓋 WHMCS 安裝路徑中的 /modules/addons/supportboard/。
若有問題，或已變更 WHMCS DB 設定，請確認 supportboard/config.php 使用正確的 WHMCS DB 設定。在 Support Board 後台更新設定不會自動更新 config.php。

OpenCart

以下設定與 OpenCart 應用相關。

安裝（Installation）

在 Settings > Apps 點 Martfury 並輸入授權金鑰安裝啟用。（原文如此）雲端版點 Active。更多資訊請見此處。
安裝後至 Settings > OpenCart 輸入 OpenCart 詳細資訊。
- 取得 Username 與 API key：在 OpenCart 管理端 System > Users > API，可見預設使用者 Default，編輯以產生 API key，並將 Status 設為 enable。接著將你的 IP 加入允許清單。
以檔案管理器或 FTP 編輯 OpenCart 安裝路徑的 catalog/controller/common/header.php，在 $data 變數中加入以下鍵值（key-value）：

$data['supportboard'] = $this->customer->getFirstName() ? 'var SB_DEFAULT_USER = { first_name: "' . $this->customer->getFirstName() . '", last_name: "' . $this->customer->getLastName() . '", email: "' . $this->customer->getEmail() . '", extra: { opencart_id: ["' . $this->customer->getId() . '|' . (isset($_COOKIE['OCSESSID']) ? $_COOKIE['OCSESSID'] : '') . '", "Open Cart ID"], phone: ["' . $this->customer->getTelephone() . '", "Phone"], opencart_store: ["' . $this->config->get('config_name') . '", "OpenCart Store"], opencart_store_url: ["' . $_SERVER['HTTP_HOST'] . '", "OpenCart Store URL"] } };' : '';

編輯 /catalog/view/theme/default/template/common/header.twig，在 <head> 中加入
<script>{{ supportboard }}</script>
若非使用預設佈景，路徑可能不同。
進入 OpenCart Extensions，點右上 Update。
下載 sb.php 檔並上傳到 catalog/controller/api。

Active eCommerce

以下設定與 Active eCommerce 應用相關。

安裝（Installation）

此流程包含兩個安裝：Support Board App 與 Active eCommerce 端安裝。

App 安裝

在 Settings > Apps 點 Active eCommerce，輸入授權金鑰安裝並啟用。更多資訊請見此處。雲端版不相容 Active eCommerce。
安裝後至 Settings > Active eCommerce 輸入資料庫資訊、Active eCommerce URL 與其他設定。
Secret key 位於 Active eCommerce 根目錄的 .env，複製 APP_KEY。
若有問題，請確認 supportboard/config.php 使用正確的 Active eCommerce DB 設定。

在 Active eCommerce 中安裝

編輯 Active eCommerce 路徑 \resources\views\frontend\inc\footer.blade.php，在 <footer 開頭標籤之後插入以下程式碼。將 [YOUR-SITE] 換成你的 Support Board 安裝 URL（Settings > Miscellaneous > Installation URL 取得）：

<script src="https://[YOUR-SITE]/js/min/jquery.min.js"></script>
<script id="sbinit" src="https://[YOUR-SITE]/js/main.js"></script>
@php
$sb_code = '';
$sb_cart = false;
if (Auth::check() && !isAdmin()) $sb_code = 'var SB_AECOMMERCE_ACTIVE_USER = '. Auth::user()->id. ';';
if (isset($detailedProduct)) $sb_code.= 'var SB_DEFAULT_AGENT = "aecommerce-'. $detailedProduct->user->id. '";';
if (auth()->user() != null) $sb_cart = \App\Models\Cart::where('user_id', Auth::user()->id)->get();
else {
    $temp_user_id = Session()->get('temp_user_id');
    if ($temp_user_id) {
        $sb_cart = \App\Models\Cart::where('temp_user_id', $temp_user_id)->get();
    }
}
if ($sb_cart && count($sb_cart) > 0) {
    $sb_code.= 'var SB_AECOMMERCE_CART = [';
    foreach ($sb_cart as $key => $item) {
        $sb_code.= '["'. $item['product_id']. '", "'. $item['price']. '", "'. $item['quantity']. '"],';
    }
    $sb_code = substr($sb_code, 0, -1). '];';
}
if ($sb_code != '') echo '<script>'. $sb_code. '</script>';
@endphp

如何更新（How to update）

在 Support Board 更新 Active eCommerce App 很簡單，你可以啟用自動更新或手動更新（詳情見此處）。
若更新 Active eCommerce，本檔案 footer.blade.php 中的上述程式碼需重新插入。

賣家聊天（Sellers chat）

若要限制賣家只看見使用者在其產品頁所發起的對話：啟用 Settings > Miscellaneous > Hide conversations of other agents，接著按 Settings > Active eCommerce > Import vendors。完成後，賣家會被註冊到 Support Board，並可登入管理端。
管理員始終可以查看所有代理（賣家）的對話。

Martfury

以下設定與 Martfury 應用相關。

安裝（Installation）

在 Settings > Apps 點 Martfury，輸入授權金鑰安裝並啟用。更多資訊請見此處。雲端版不相容 Martfury。
安裝後至 Settings > Martfury 輸入資料庫資訊、Martfury URL 與 Secret key。可從 Martfury 根目錄的 .env 檔取得。
在 Settings > Martfury > Martfury path 設定 Martfury 路徑。方法：將提供的檔案上傳至 Martfury 根目錄的 /public/，上傳後透過瀏覽器開啟（例：https://shop.com/public/path.php）取得。
在 Martfury 後台 Admin > Appearance > Custom JS > Footer JS 內插入 Support Board（PHP 版）嵌入碼；不要再引入 jQuery。
若有問題，請確認 supportboard/config.php 使用正確的 Martfury DB 設定。

如何更新（How to update）

在 Support Board 更新 Martfury App 可啟用自動更新或手動更新（詳情見此處）。

賣家聊天（Sellers chat）

若要讓商店僅能看到使用者從其商品頁發起的對話，請依下列步驟：

勾選 Settings > Martfury > Private chat、Settings > Chat > Disable dashboard、Settings > Chat > Allow only one conversation。
在 Settings > Martfury > Import vendors 匯入所有供應商。
在 Settings > Martfury > Private chat linking 將各供應商連到正確的商店。供應商 ID 可在 Users > Agents and Admins 取得。

WORDPRESS

以下設定與 WordPress 版 Support Board 相關。

使用者同步（User synchronization）

在 Settings > WordPress 的 Users system 選擇 WordPress 後，WordPress 使用者會自動與 Support Board 同步。啟用後，前台聊天會自動辨識已登入的 WordPress 使用者，並以相同的姓名、姓氏、Email、密碼建立 Support Board 帳戶。
同時，聊天登入表單會辨識每個 WordPress 使用者的 Email 與密碼；在 Support Board 登入時，也會自動登入 WordPress。
若要在使用者於 Support Board 註冊時建立 WordPress 使用者：啟用 Settings > WordPress > WordPress registration，並在註冊表單中包含密碼與Email欄位（必填）。若已登入 WordPress，則會自動登入。

WOOCOMMERCE

以下設定與 WooCommerce（限 WordPress 版 Support Board）應用相關。

安裝（Installation）

在 Settings > Apps 點 WooCommerce，輸入授權金鑰安裝並啟用。更多資訊請見此處。雲端與PHP 版本不相容 WooCommerce App。

聊天機器人（Chatbot）

快速開始（Getting started）

要在 WooCommerce 中使用聊天機器人，只需啟用它（詳情點此）。啟用後，機器人會自動回答與你商店相關的問題。

內建問答範例（Built-in chatbot Q&A）

OpenAI 聊天機器人能回答以下類型問題（舉例）：

Do you sell any shoes for less than $299?
Show me your bags
Do you have anything for women in promotion?
What are the best shoes of 2020?
Add Abstract Print to the cart
Remove Abstract Print from the cart
What's the status of my order?
What is the price of the Abstract Print?
Display the products in my cart!
Do you ship in Australia?
Where do you ship?

多語（Multilingual）

多語功能相容 WPML 與 Polylang。
啟用：Settings > WordPress > Multilingual plugin 選擇 WPML 或 Polylang。
若要支援 WooCommerce 產品屬性的多語：WPML 需 WooCommerce Multilingual Plugin；Polylang 需 Polylang for WooCommerce Plugin。

使用者同步

新使用者會自動同步。若要手動同步既有使用者，前往 Settings > WordPress > Synchronize users 並點擊 Import users。

雲端版本

資訊 (Information)

當你的點數用完且未啟用自動儲值時，你會收到電子郵件通知。最多會寄送兩封通知。啟用自動儲值可避免點數用盡。
啟用自動儲值後，當點數低於 1 時會自動儲值。

Information（資訊）

你可以在 https://cloud.board.support/account/?tab=installation 找到你的 API token。
你可以在 Settings > Admin > Switch accounts 新增帳號，以免登出再登入即可切換帳號。
雲端版本託管於我們的 Amazon AWS 伺服器。
若你在存取雲端版本時遇到白畫面，請在 URL 後加上參數 reset-login 後重新開啟。例如：https://cloud.board.support/?reset-login。

其他

本節包含未在上述列出的其他功能說明。

漸進式 Web 應用

Support Board 的管理後台是 PWA，這代表你可以在桌機、Mac、iPhone 或行動裝置上安裝並像完整的應用程式一樣使用。注意：此功能對 Google Chrome 與 Safari 最佳化。PWA 在所有版本的 Support Board 上皆受支援。

桌面安裝

進入你的管理後台（例如 https://www.your-site.com/supportboard/admin.php 或 https://cloud.board.support），然後點擊 Chrome 瀏覽器網址列右上角的 + 圖示。若你使用 WordPress 版，請見下方資訊。

鍵盤快速鍵

管理後台的鍵盤快速鍵在 PC 與 MAC 上皆可用，如下：

Shortcut（快捷鍵）	Description（說明）
`ENTER` 或 `SPACE`	確認或關閉對話框；相當於按下 OK。
`ESC` 或 `CANCEL`	取消對話框並關閉。
`SHIFT + ENTER` 或 `CTRL + ENTER`	在訊息中加入換行。僅適用於管理端編輯器。
`ESC`	關閉燈箱。
`CANCEL`	在管理端對話區，封存對話或刪除對話。
`CTRL + 上/下方向鍵`	在管理端對話清單中於各對話間導覽。
`CTRL + 右/左方向鍵`	在管理端使用者區於使用者間導覽。
`CTRL + V`	從剪貼簿貼上圖片並以訊息發送。
`CTRL + 滑鼠左鍵`	在管理端對話清單中選取多個對話，按住 CTRL 並逐一點擊即可。之後可對所有選取的對話進行批次操作，如封存、刪除、標記為已讀或未讀等。

Zapier

Zapier 應用程式 — 僅雲端版

若你使用雲端版本，請使用位於 https://zapier.com/apps/support-board/integrations 的 Zapier 應用程式。

手動整合 — 所有版本

依下列步驟將 Zapier 與 Support Board 整合。整合基於 Support Board 的 Webhooks；每個 webhook 對應一個 Zapier 觸發器，因此你可使用 15+ 個 Zapier 觸發器。更多細節請參閱 webhooks 頁面。若你使用 PHP 或 WordPress 版本，僅能使用手動整合。

前往 https://developer.zapier.com/ 並登入或註冊新帳號。
點擊 Start a Zapier Integration 建立新整合，或造訪 https://developer.zapier.com/app/new。填寫所有必填欄位（例如名稱與描述）後點擊 Create；你可輸入任意文字，但請記住應用程式名稱，稍後會需要用到。
從左側選單點選 Triggers，然後 Add Trigger。
填寫所有必填欄位（例如 key 與描述），並點擊 Save And Continue；你可輸入任意文字。
上方點擊 API Configuration，將 Trigger Type 設為 REST Hook，然後點擊 Save。
返回觸發器的 Settings 區域，或前往 https://zapier.com/app/zaps，點擊 Create a Zap。
輸入並搜尋你剛建立的應用程式名稱並點擊它。在 Trigger Event 選擇你的觸發器並點擊 continue。
複製 Webhook URL，點擊 Continue，然後進入 Support Board 管理後台，在 Settings > Miscellaneous > Webhooks > URL 貼上該網址，啟用 webhooks，儲存設定並重新載入 Support Board。
執行會觸發 webhook 的操作（例如傳送訊息或建立新使用者），接著返回 Zapier 點擊 Test Trigger，你應該會看到 Support Board 的 webhook 資料。點擊 Continue。
點擊右側按鈕 Filters，設定僅在某變數存在時才觸發整合的篩選條件。你需要此篩選，因為 Support Board 會將所有 webhooks 傳送給所有 zaps。範例：若你的 zap 要整合 Support Board 的訊息，則需設定僅在變數 message 存在時才繼續。
點擊 Continue，或點擊 + 並加入你的整合流程。
若要同時使用多個 zaps 與 webhooks，你需要更新 Settings > Miscellaneous > Webhooks > URL 並加入新的 zap ID（以逗號分隔）。例如：若你有兩個 zaps，其 URL 分別為 https://hooks.zapier.com/hooks/catch/10352851/bbad21f/ 與 https://hooks.zapier.com/hooks/catch/10352851/aaaa66t/，則該欄位應填入 https://hooks.zapier.com/hooks/catch/10352851/bbad21f,aaaa66t/。

戰國策AI客服系統教學

快速導航

對話管理

文字編輯器與自動訊息

合併欄位

富訊息（Rich Messages）

富訊息（Rich Messages）

特殊字元

全域參數（Global parameters）

內建訊息（Built-in messages）

歡迎訊息（Welcome message）

後續訊息（Follow up message）

附件（Attachments）

資訊（Information）

標籤（Tags）

備註（Notes）

謄本（Transcript）

使用者（USERS）

管理使用者（Manage users）

匯入使用者（Import users）

搜尋使用者（Search users）

刪除使用者（Delete users）

使用者類型（User types）

管理代理與管理員（Manage agents and admins）

收集使用者資料（Collect user details）

註冊（Registration）

資訊（Information）

雜項（Miscellaneous）

登入驗證 URL（Login verification URL）

設定（SETTINGS）

上班時間（Office hours）

文章（Articles）

語言與翻譯（Language and translations）

編輯翻譯

聊天語言（Chat language）

管理端語言（Admin language）

翻譯自訂內容（Translate custom contents）

新增語言（Add a new language）

其他資訊

部門（Departments）

設定

運作方式

將部門指派給對話的方式

佇列與路由（Queue and routing）

更多資訊（僅佇列）

更多資訊（僅路由）

手動路由（Manual routing）

代理選單（Agents menu）

將代理指派給對話的方式

電子郵件匯入（Email piping）

啟用（Activation）

資訊（Information）

排程工作（Cron job）

Pusher

啟用（Activation）

直接訊息（Direct messages）

直接聊天訊息（Direct chat message）

直接電子郵件（Direct email）

直接簡訊（Direct text messages）

直接 WhatsApp 範本訊息（Direct WhatsApp template messages）

自動化（Automations）

電子報（Newsletter）

Mailchimp

取得 Key：請參考 https://mailchimp.com/help/about-api-keys/

Brevo

SendGrid

Elastic Email

Campaign Monitor

取得 Key：登入 Campaign Monitor，於右上角個人檔案選單點「Account settings」。點「API keys > Generate API key」。

HubSpot

Moosend

GetResponse

ConvertKit

ActiveCampaign

MailerLite

Mailjet

Sendy

SendFox

亞馬遜網路服務 (Amazon Web Services)

更多設定（More settings）