在線聊天
LiveChat 是一款在線客戶服務軟件，具有實時支持、幫助台軟件和網絡分析功能。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | Microsoft |
| URL | https://www.livechat.com/ |
| 連接器中繼資料 | |
|---|---|
| Publisher | Microsoft |
| 網站 | https://www.livechat.com/ |
| 隱私策略 | https://www.livechat.com/legal/privacy-policy/ |
| 類別 | 通訊 |
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| 舊有實體 ID（已棄用） | 字串 | 實體 ID（電子郵件地址）僅用於已棄用的 LiveChat API v2 操作。 | |
| 帳戶識別碼 | 字串 | 帳號 ID（GUID）顯示在 LiveChat 個人存取權杖頁面上。 新的（V2）連接器操作在 LiveChat API v3.6 中使用此值。 | 對 |
| 個人存取令牌 | securestring | 這個帳戶的完整、未編碼的個人存取令牌。 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 列表代理人（V2） |
使用 LiveChat API v3.6 回傳所有 LiveChat 授權下的代理。 個人存取令牌需要代理——all：ro 範圍。 |
| 列表代理人（已棄用）[已棄用] |
此已棄用操作回傳使用 LiveChat API v2 的代理。 建議改用 List agents （V2） |
| 列表票（已棄用）[已棄用] |
此已棄用的操作使用已退休的 LiveChat Tickets API。 |
| 取得票券（已棄用） [已棄用] |
此已棄用的操作使用已退休的 LiveChat Tickets API。 |
| 建立新代理（V2） |
使用 LiveChat API v3.6 建立代理程式。 代理人可能需要依個人存取令牌範圍及即時聊天訂閱獲得批准。 |
| 建立新工單（已棄用）[已棄用] |
此已棄用的操作使用已退休的 LiveChat Tickets API。 |
| 建立新的代理程式 （已棄用） [已棄用] |
此已棄用操作會使用 LiveChat API v2 建立代理程式。 改用「建立新代理（V2）」來取代。 |
| 更新工單（已棄用）[已棄用] |
此已棄用的操作使用已退休的 LiveChat Tickets API。 |
| 移除一個代理人（V2） |
使用 LiveChat API v3.6 移除一個代理。 移除另一個代理需要代理——all：rw 和 accounts-all：rw 作用域。 |
| 移除代理（已棄用） [已棄用] |
此已棄用操作會移除使用 LiveChat API v2 的代理程式。 改用移除代理人（V2）來代替。 |
列表代理人（V2）
使用 LiveChat API v3.6 回傳所有 LiveChat 授權下的代理。 個人存取令牌需要代理——all：ro 範圍。
傳回
LiveChat 授權中的代理人。
列表代理人（已棄用）[已棄用]
列表票（已棄用）[已棄用]
取得票券（已棄用） [已棄用]
此已棄用的操作使用已退休的 LiveChat Tickets API。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
票證 ID
|
ticketId | True | string |
票證的 ID |
傳回
建立新代理（V2）
使用 LiveChat API v3.6 建立代理程式。 代理人可能需要依個人存取令牌範圍及即時聊天訂閱獲得批准。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
代理識別碼
|
id | True | string |
代理人ID，通常是代理人的電子郵件地址。 |
|
名稱
|
name | True | string |
客服專員名稱。 |
|
角色
|
role | string |
建立比一般更高的角色需要 accounts.roles.lc--all：rw 範圍。 |
|
|
登入狀態
|
login_status | string | ||
|
職稱
|
job_title | string | ||
|
Mobile
|
mobile | string | ||
|
最大聊天次數
|
max_chats_count | integer | ||
|
等待批准
|
awaiting_approval | boolean |
將此設定為 false 需要使用 private subscription.lc：rw 範圍。 |
|
|
群組識別碼
|
id | True | integer | |
|
Priority
|
priority | True | string | |
|
Notifications
|
notifications | array of string | ||
|
電子郵件訂閱
|
email_subscriptions | array of string | ||
|
時區
|
timezone | string |
工作排班使用的時區。 |
|
|
Day
|
day | True | string | |
|
已啟用
|
enabled | True | boolean | |
|
Start
|
start | True | string | |
|
結束
|
end | True | string |
建立新工單（已棄用）[已棄用]
此已棄用的操作使用已退休的 LiveChat Tickets API。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Message
|
message | True | string | |
|
請求者的電子郵件
|
True | string | ||
|
請求者名稱
|
name | string | ||
|
主旨
|
subject | string | ||
|
受指派人ID
|
id | string | ||
|
來源類型
|
type | string |
選擇來源 |
|
|
來源網址
|
url | string |
如果來源類型是聊天視窗。 |
傳回
建立新的代理程式 （已棄用） [已棄用]
此已棄用操作會使用 LiveChat API v2 建立代理程式。 改用「建立新代理（V2）」來取代。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Email
|
login | True | string | |
|
名稱
|
name | True | string | |
|
登入狀態
|
login_status | string | ||
|
Title
|
job_title | string |
預設為：支援代理程式。 |
|
|
權限
|
permission | string | ||
|
密碼
|
password | string |
最小長度 5. |
|
|
聊天次數上限
|
max_chats_count | string |
並發聊天的限制。 |
傳回
更新工單（已棄用）[已棄用]
此已棄用的操作使用已退休的 LiveChat Tickets API。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
票證 ID
|
ticketId | True | string |
票證的 ID |
|
Message
|
message | string | ||
|
請求者的電子郵件
|
True | string | ||
|
請求者名稱
|
name | string | ||
|
主旨
|
subject | string | ||
|
受指派人ID
|
id | string |
挑選受指派人。 |
|
|
來源類型
|
type | string |
選擇一個來源。 |
|
|
來源網址
|
url | string |
如果來源類型是聊天視窗。 |
傳回
移除一個代理人（V2）
使用 LiveChat API v3.6 移除一個代理。 移除另一個代理需要代理——all：rw 和 accounts-all：rw 作用域。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
代理識別碼
|
id | True | string |
要移除的探員身份證。 |
移除代理（已棄用） [已棄用]
此已棄用操作會移除使用 LiveChat API v2 的代理程式。 改用移除代理人（V2）來代替。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Email
|
login | True | string |
客服專員的電子郵件。 |
傳回
觸發程序
| 當工單建立（棄用）[棄用] |
此已棄用的操作使用已退休的 LiveChat Tickets API。 |
| 聊天結束時（已棄用） [已棄用] |
此已棄用的操作使用 LiveChat API v2。 |
| 聊天開始時（已棄用） [已棄用] |
此已棄用的操作使用 LiveChat API v2。 |
當工單建立（棄用）[棄用]
聊天結束時（已棄用） [已棄用]
聊天開始時（已棄用） [已棄用]
定義
WebhookChat回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
agents
|
chat.agents | array of object |
agents |
|
客服專員電子郵件
|
chat.agents.login | string |
客服專員的電子郵件地址。 |
|
客服專員名稱
|
chat.agents.name | string |
代理程式的名稱。 |
|
結束時間戳記
|
chat.ended_timestamp | string |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
events
|
chat.events | array of object |
事件陣列。 |
|
活動文字
|
chat.events.text | string |
與事件相關聯的訊息。 |
|
活動 Date-Time
|
chat.events.timestamp | string |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
事件類型
|
chat.events.type | string |
事件類型。 |
|
事件使用者類型
|
chat.events.user_type | string |
使用者類型。 |
|
groups
|
chat.groups | array of integer | |
|
群組識別碼
|
chat.id | string |
群組的唯一識別碼。 |
|
Message
|
chat.messages | array of object |
訊息陣列。 |
|
客服專員 ID
|
chat.messages.agent_id | string |
與訊息相關聯的代理程式的唯一 ID。 |
|
作者姓名
|
chat.messages.author_name | string |
訊息作者的姓名.. |
|
文字
|
chat.messages.text | string |
訊息內文。 |
|
已發送 Date-Time
|
chat.messages.timestamp | string |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
使用者類型
|
chat.messages.user_type | string |
傳送訊息的使用者類型。 |
|
開始 Date-Time
|
chat.started_timestamp | string |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
tags
|
chat.tags | array of string | |
|
URL
|
chat.url | string |
聊天開始的網站 URL。 |
|
事件標識碼
|
event_unique_id | string |
與聊天相關聯之事件的唯一識別碼。 |
|
聊天前調查
|
pre_chat_survey | array of object |
聊天前調查回复的陣列。 |
|
回答
|
pre_chat_survey.answer | string |
調查答案。 |
|
調查標識碼
|
pre_chat_survey.id | string |
聊天前調查 ID。 |
|
Question
|
pre_chat_survey.label | string |
調查問題。 |
|
Email
|
visitor.email | string |
訪客的電子郵件地址。 |
|
Id
|
visitor.id | string |
訪客的唯一ID。 |
|
語言
|
visitor.language | string |
與訪客帳戶相關聯的語言。 |
|
名稱
|
visitor.name | string |
訪客的姓名。 |
|
頁面
|
visitor.page_current | string |
聊天源自的網頁。 |
WebhookTicket回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Id
|
ticket.assignee.id | string |
使用者的唯一識別碼。 |
|
名稱
|
ticket.assignee.name | string |
受讓人的名稱。 |
|
events
|
ticket.events | array of object | |
|
Id
|
ticket.events.author.id | string |
使用者的唯一識別碼。 |
|
名稱
|
ticket.events.author.name | string |
作者的名稱。 |
|
類型
|
ticket.events.author.type | string |
代理或客戶。 |
|
活動 Date-Time
|
ticket.events.date | date-time |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
是私人
|
ticket.events.is_private | boolean |
如果事件是私人的，則為 true。 |
|
Message
|
ticket.events.message | string |
事件描述。 |
|
類型
|
ticket.events.source.type | string |
聊天窗口、郵件或 lc2。 |
|
URL
|
ticket.events.source.url | string |
傳送票證的網站 URL。 |
|
事件類型
|
ticket.events.type | string |
產生票證的事件類型。 |
|
群體
|
ticket.groups | array of object |
關聯群組的詳細資料。 |
|
Id
|
ticket.groups.id | integer |
群組的唯一識別碼。 |
|
名稱
|
ticket.groups.name | string |
群組的名稱。 |
|
票證 ID
|
ticket.id | string |
票證的唯一 ID。 |
|
IP
|
ticket.requester.ip | string |
要求者的 IP 位址。 |
|
Email
|
ticket.requester.mail | string |
請求者的電子郵件地址。 |
|
名稱
|
ticket.requester.name | string |
要求者的名稱。 |
|
Id
|
ticket.source.id | string |
來源的唯一識別碼。 |
|
類型
|
ticket.source.type | string |
Lc2、郵件、facebook、agent-app-manual 或聊天窗口。 |
|
URL
|
ticket.source.url | string |
建立票證的網站 URL。 |
|
地位
|
ticket.status | string |
未解決、待處理、已解決或垃圾郵件。 |
|
主旨
|
ticket.subject | string |
票證的簡短描述。 |
|
tags
|
ticket.tags | array of string |
ListTickets回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
創建 Date-Time
|
date | date-time |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
票證 ID
|
id | string |
票證的唯一識別碼。 |
|
修改後的 Date-Time
|
modified | date-time |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
IP
|
requester.ip | string |
要求者的 IP 位址。 |
|
Email
|
requester.mail | string |
請求者的電子郵件地址。 |
|
名稱
|
requester.name | string |
要求者的全名。 |
|
Id
|
source.id | string |
來源的唯一識別碼。 |
|
類型
|
source.type | string |
來自聊天、郵件或 lc2。 |
|
URL
|
source.url | string |
建立票證的網頁。 |
|
地位
|
status | string |
未解決、待處理、已解決或垃圾郵件。 |
|
主旨
|
subject | string |
票證來源的描述。 |
票務回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Id
|
currentGroup.id | integer |
群組的唯一識別碼。 |
|
名稱
|
currentGroup.name | string |
群組的名稱。 |
|
創建 Date-Time
|
date | date-time |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
events
|
events | array of object | |
|
Id
|
events.author.id | string |
使用者的唯一識別碼。 |
|
名稱
|
events.author.name | string |
作者的名稱。 |
|
類型
|
events.author.type | string |
代理或客戶。 |
|
活動 Date-Time
|
events.date | date-time |
yyyy-MM-ddTHH：mm：ss.fffZ |
|
是私人
|
events.is_private | boolean |
如果事件是私人的，則為 true。 |
|
Message
|
events.message | string |
事件描述。 |
|
類型
|
events.source.type | string |
聊天窗口、郵件或 lc2。 |
|
URL
|
events.source.url | string |
傳送票證的網站 URL。 |
|
事件類型
|
events.type | string |
產生票證的事件類型。 |
|
群體
|
groups | array of object |
關聯群組的詳細資料。 |
|
Id
|
groups.id | integer |
群組的唯一識別碼。 |
|
名稱
|
groups.name | string |
群組的名稱。 |
|
票證 ID
|
id | string |
票證的唯一 ID。 |
|
IP
|
requester.ip | string |
要求者的 IP 位址。 |
|
Email
|
requester.mail | string |
請求者的電子郵件地址。 |
|
名稱
|
requester.name | string |
要求者的名稱。 |
|
Id
|
source.id | string |
來源的唯一識別碼。 |
|
類型
|
source.type | string |
Lc2、郵件、facebook、agent-app-manual 或聊天窗口。 |
|
URL
|
source.url | string |
建立票證的網站 URL。 |
|
地位
|
status | string |
未解決、待處理、已解決或垃圾郵件。 |
|
主旨
|
subject | string |
票證的簡短描述。 |
|
tags
|
tags | array of string |
ListAgentsV2_Response
LiveChat 授權中的代理人。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
物品
|
AgentV2 |
特工V2
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
代理識別碼
|
id | string |
代理人ID，通常是代理人的電子郵件地址。 |
|
名稱
|
name | string |
客服專員名稱。 |
|
阿凡達
|
avatar | string |
代理人頭像的網址。 |
|
角色
|
role | string |
經紀人的角色。 |
|
登入狀態
|
login_status | string |
客服人員登入狀態。 |
|
職稱
|
job_title | string |
代理人的職稱。 |
|
Mobile
|
mobile | string |
代理人的手機號碼。 |
|
最大聊天次數
|
max_chats_count | integer |
最多同時進行聊天。 |
|
已暫停
|
suspended | boolean |
代理人是否被停職。 |
|
等待批准
|
awaiting_approval | boolean |
代理人是否正在等待核准。 |
|
groups
|
groups | array of AgentGroupV2 |
分配給特工的群組。 |
代理群組V2
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
群組識別碼
|
id | integer | |
|
Priority
|
priority | string |
ListAgents_Response
所有代理的清單及其詳細資訊。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
阿凡達
|
avatar | string |
Amazon s3 上映像的路徑。 |
|
登入電子郵件
|
login | string |
客服專員的電子郵件地址。 |
|
名稱
|
name | string |
代理的名稱。 |
|
權限
|
permission | string |
所有者、管理員或正常人。 |
CreateAgent_Response
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
阿凡達
|
avatar | string |
Amazon s3 上映像的路徑。 |
|
群組陣列
|
groups | array of object |
客服專員所屬的所有群組清單。 |
|
群組識別碼
|
groups.id | integer |
群組的唯一識別碼。 |
|
群組名稱
|
groups.name | string |
群組的名稱。 |
|
職稱
|
job_title | string |
預設為支援代理程式。 |
|
Email
|
login | string |
客服專員的電子郵件地址。 |
|
登入狀態
|
login_status | string |
接受聊天或不接受聊天。 |
|
最大聊天次數
|
max_chats_count | integer |
並發聊天的限制。 |
|
名稱
|
name | string |
代理的名稱。 |
|
權限
|
permission | string |
所有者、管理員或普通 |
|
地位
|
status | string |
接受聊天，不接受聊天或離線。 |