Zendesk
Zendesk 構建軟件以改善客戶關係。 Zendesk 的產品組合中有多種產品，提供客戶服務和支援票務平台，使企業能夠從統一介面處理客戶電話、電子郵件和其他技術查詢。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | Microsoft |
| URL |
Microsoft LogicApps 支援 Microsoft Power Automate 支援 Microsoft Power Apps 支援 |
| 連接器中繼資料 | |
|---|---|
| Publisher | Microsoft |
| 網站 | https://www.zendesk.com/ |
| 隱私策略 | https://www.zendesk.com/company/customers-partners/privacy-policy/ |
已知問題與限制
- 連接器僅傳回Zendesk實體的不可部分完成屬性（即不支援清單、記錄和其他複雜型別）。 例如，
Ticket實體在 Zendesk 端具有tags由陣列表示的屬性。 Zendesk 連接器會傳回[List]此類欄位的字串。 - 連接器需要
updated_at與觸發程式搭配使用的任何資料表都存在資料行。 - Zendesk Search API 對每個查詢傳回 1000 個結果有 限制 。 這會影響某些連接器動作，如果目標資料表包含 1000 筆或更多記錄，則會失敗並顯示錯誤 （「Http 要求失敗：內容不是有效的 JSON」）：
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| 公司名稱 | 字串 | Zendesk公司名稱是網站URL的子網域部分。 例如 https://{company}.zendesk.com | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 刪除項目 |
刪除 Zendesk 項目 |
| 取得物品 |
擷取 Zendesk 專案 |
| 取得物品 |
擷取特定 Zendesk 類型的 Zendesk 專案（例如：「票證」） |
| 取得表格 |
從網站擷取Zendesk表格 |
| 建立項目 |
建立Zendesk專案 |
| 搜尋文章 |
傳回每頁預設 25 個文章數目，最多 1000 個結果。 |
| 更新項目 |
更新現有的Zendesk專案 |
刪除項目
刪除 Zendesk 項目
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料表名稱
|
table | True | string |
Zendesk 項目類型（例如：「工單」） |
|
項目索引鍵
|
id | True | string |
要刪除之項目的唯一識別碼 |
取得物品
擷取 Zendesk 專案
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料表名稱
|
table | True | string |
Zendesk 項目類型（例如：「工單」） |
|
項目索引鍵
|
id | True | string |
要擷取之項目的唯一識別碼 |
傳回
取得物品
擷取特定 Zendesk 類型的 Zendesk 專案（例如：「票證」）
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料表名稱
|
table | True | string |
Zendesk 項目類型（例如：「工單」） |
|
篩選查詢
|
$filter | string |
ODATA 篩選查詢，以限制傳回的專案 （例如 stringColumn eq 'string' OR numberColumn lt 123）。 |
|
|
訂購方式
|
$orderby | string |
ODATA orderBy 查詢，用於指定項目順序 |
|
|
略過計數
|
$skip | integer |
要略過的項目數（預設值 = 0） |
|
|
最大取得計數
|
$top | integer |
要擷取的項目數目上限 （預設值 = 512） |
|
|
選取查詢
|
$select | string |
要從項目擷取的特定欄位（預設值 = all）。 |
傳回
取得表格
建立項目
建立Zendesk專案
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料表名稱
|
table | True | string |
Zendesk 項目類型（例如：「工單」） |
|
項目
|
item | True | dynamic |
要建立的Zendesk項目 |
傳回
搜尋文章
傳回每頁預設 25 個文章數目，最多 1000 個結果。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Query
|
query | True | string |
要搜索的文章。 |
|
Locale
|
locale | string |
項目顯示的地區設定 |
|
|
品牌編號
|
brand_id | integer |
搜尋指定品牌的商品。 |
|
|
類別
|
category | integer |
將搜尋限制為此類別 ID。 |
|
|
章節
|
section | integer |
將搜尋限制為此區段識別碼 |
|
|
標籤名稱
|
label_names | string |
以逗號分隔的標籤名稱清單。 |
|
|
多品牌
|
multibrand | boolean |
如果為true，則啟用所有品牌的搜尋。 |
傳回
- 身體
- SearchResult
更新項目
更新現有的Zendesk專案
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料表名稱
|
table | True | string |
Zendesk 項目類型（例如：「工單」） |
|
項目索引鍵
|
id | True | string |
要更新之項目的唯一識別碼 |
|
項目
|
item | True | dynamic |
具有更新值的Zendesk專案 |
傳回
觸發程序
| 修改項目時 |
在Zendesk中修改專案時觸發流程 |
| 修改項目時 |
在Zendesk中修改專案時觸發流程 |
| 建立項目時 |
在Zendesk中建立專案時觸發流程 |
修改項目時
在Zendesk中修改專案時觸發流程
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料表名稱
|
table | True | string |
Zendesk 表格的名稱 |
|
篩選查詢
|
$filter | string |
ODATA 篩選查詢，以限制傳回的專案 （例如 stringColumn eq 'string' OR numberColumn lt 123）。 |
|
|
訂購方式
|
$orderby | string |
ODATA orderBy 查詢，用於指定項目順序 |
|
|
略過計數
|
$skip | integer |
要略過的項目數（預設值 = 0） |
|
|
最大取得計數
|
$top | integer |
要擷取的項目數目上限 （預設值 = 512） |
傳回
修改項目時
在Zendesk中修改專案時觸發流程
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料表名稱
|
table | True | string |
Zendesk 表格的名稱 |
|
篩選查詢
|
$filter | string |
ODATA 篩選查詢，以限制傳回的專案 （例如 stringColumn eq 'string' OR numberColumn lt 123）。 |
|
|
訂購方式
|
$orderby | string |
ODATA orderBy 查詢，用於指定項目順序 |
|
|
略過計數
|
$skip | integer |
要略過的項目數（預設值 = 0） |
|
|
最大取得計數
|
$top | integer |
要擷取的項目數目上限 （預設值 = 512） |
傳回
建立項目時
在Zendesk中建立專案時觸發流程
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料表名稱
|
table | True | string |
Zendesk 表格的名稱 |
|
篩選查詢
|
$filter | string |
ODATA 篩選查詢，以限制傳回的專案 （例如 stringColumn eq 'string' OR numberColumn lt 123）。 |
|
|
訂購方式
|
$orderby | string |
ODATA orderBy 查詢，用於指定項目順序 |
|
|
略過計數
|
$skip | integer |
要略過的項目數（預設值 = 0） |
|
|
最大取得計數
|
$top | integer |
要擷取的項目數目上限 （預設值 = 512） |
傳回
定義
Table
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
名稱
|
Name | string | |
|
顯示名稱
|
DisplayName | string |
搜尋結果
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
results
|
results | array of object | |
|
識別碼
|
results.id | integer |
自動指派的文章 ID |
|
url
|
results.url | string |
文章的 API 網址 |
|
html_url
|
results.html_url | string |
說明中心中文章的網址 |
|
author_id
|
results.author_id | integer |
作者編號 |
|
comments_disabled
|
results.comments_disabled | boolean |
如果註解已停用，則為 True;false 否則 |
|
草稿
|
results.draft | boolean |
如果目前地區設定的翻譯是草稿，則為 True |
|
晉升
|
results.promoted | boolean |
如果這篇文章被推廣，這是真的;false，否則。 預設為false |
|
位置
|
results.position | integer |
這篇文章在文章列表中的位置。 預設為 0 |
|
vote_sum
|
results.vote_sum | integer |
贊成票 （+1） 和反對票 （-1） 的總和可能是正數或負數 |
|
vote_count
|
results.vote_count | integer |
贊成票和反對票總數 |
|
section_id
|
results.section_id | integer |
本文所屬區段的 ID |
|
建立於
|
results.created_at | date-time |
條目創建時間 |
|
updated_at
|
results.updated_at | date-time |
文章最後更新時間 |
|
名稱
|
results.name | string |
文章名稱 |
|
title
|
results.title | string |
文章標題 |
|
source_locale
|
results.source_locale | string |
文章的來源 （預設） 地區設定 |
|
地區設定
|
results.locale | string |
文章顯示的地區設定 |
|
過時的
|
results.outdated | boolean |
Deprecated |
|
outdated_locales
|
results.outdated_locales | array of string |
文章被標記為過時的地區 |
|
edited_at
|
results.edited_at | date-time |
條目上次在其顯示的地區進行編輯的時間 |
|
user_segment_id
|
results.user_segment_id | integer |
使用者區段的識別碼，定義誰可以看到這篇文章 |
|
permission_group_id
|
results.permission_group_id | integer |
權限群組的識別碼，定義誰可以編輯和發佈此文章 |
|
content_tag_ids
|
results.content_tag_ids | array of string |
文章附加的內容標籤列表 |
|
label_names
|
results.label_names | array of string |
與本文相關聯的標籤名稱陣列 |
|
body
|
results.body | string |
文章的 HTML 正文 |
|
片段
|
results.snippet | string |
文章的 HTML 片段 |
|
result_type
|
results.result_type | string |
結果類型 |
表格清單
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
value
|
value | array of Table |