Zendesk
整合版本：8.0
設定 Zendesk，以便與 Google Security Operations 搭配使用
管理員會產生 API 權杖，請按照下列步驟操作：
前往 Zendesk 介面的側欄，按一下「管理」圖示，然後依序選取「管道」>「API」。
- 按一下「設定」分頁標籤，然後啟用權杖存取權。
- 按一下「有效 API 權杖」右側的 + 按鈕。
- 視需要輸入「API 權杖說明」。
- 複製權杖，以便稍後使用，並將權杖貼到安全位置。視窗關閉後，系統不會再次顯示完整權杖。
- 按一下「儲存」即可返回 API 頁面。
在 Google SecOps 中設定 Zendesk 整合
如需在 Google SecOps 中設定整合功能的詳細操作說明，請參閱「設定整合功能」。
動作
為支援單新增留言
說明
在現有支援單中新增留言。
參數
| 參數 | 類型 | 預設值 | 說明 |
|---|---|---|---|
| 支援單 ID | 字串 | 不適用 | 票券號碼。 |
| 留言內容 | 字串 | 不適用 | 不適用 |
| 作者姓名 | 字串 | 不適用 | 不適用 |
| 內部注意事項 | 布林值 | 不適用 | 不適用 |
用途
不適用
執行時間
這項操作會對所有實體執行。
動作執行結果
實體擴充
不適用
深入分析
不適用
指令碼執行結果
| 指令碼結果名稱 | 價值選項 | 示例 |
|---|---|---|
| is_success | True/False | is_success:False |
JSON 結果
N/A
在票證上套用巨集
說明
將巨集套用至支援單。
參數
| 參數 | 類型 | 預設值 | 說明 |
|---|---|---|---|
| 支援單 ID | 字串 | 不適用 | 票券號碼。 |
| 巨集標題 | 字串 | 不適用 | 不適用 |
用途
不適用
執行時間
這項操作會對所有實體執行。
動作執行結果
實體擴充
不適用
深入分析
不適用
指令碼執行結果
| 指令碼結果名稱 | 價值選項 | 示例 |
|---|---|---|
| is_applied | True/False | is_applied:False |
JSON 結果
N/A
建立支援單
說明
建立具有特定屬性的支援單。
已知限制
Zendesk API 不支援含有 Unicode 字元的電子郵件。這會影響「Email CC」參數。動作會直接忽略這些項目
參數
| 參數 | 類型 | 預設值 | 說明 |
|---|---|---|---|
| 主旨 | 字串 | 不適用 | 不適用 |
| 說明 | 字串 | 不適用 | 不適用 |
| 已指派的使用者 | 字串 | 不適用 | 使用者全名。 |
| 指派群組 | 字串 | 不適用 | 群組名稱。 |
| 優先順序 | 字串 | 不適用 | 優先順序為「緊急」、「高」、「一般」或「低」。 |
| 票證類型 | 字串 | 不適用 | 優先順序為「緊急」、「高」、「一般」或「低」。 |
| 標記 | 字串 | 不適用 | 不適用 |
| 內部注意事項 | 核取方塊 | 未勾選 | 指定留言應為公開或內部留言。取消勾選表示公開，勾選表示僅限內部 |
| 電子郵件副本 | CSV | 不適用 | 請以半形逗號分隔的清單形式指定電子郵件地址，這些地址也會收到工單建立通知。注意：最多可新增 48 個電子郵件副本收件者。這是 Zendesk 的限制。 |
| 驗證電子郵件副本 | 布林值 | 已勾選 | 如果啟用，動作會嘗試檢查「電子郵件副本」參數中提供的電子郵件地址是否為現有使用者。如果至少有一位使用者不存在，動作就會失敗。如果停用這項參數，動作就不會執行這項檢查。 |
用途
不適用
執行時間
這項操作會對所有實體執行。
動作執行結果
實體擴充
不適用
深入分析
不適用
指令碼執行結果
| 指令碼結果名稱 | 價值選項 | 示例 |
|---|---|---|
| ticket_id | 不適用 | 不適用 |
JSON 結果
N/A
案件總覽
| 結果類型 | 值/說明 | 類型 |
|---|---|---|
| 輸出訊息* | 如果啟用「驗證電子郵件副本」，且系統找不到至少一封電子郵件 (失敗)：執行動作「{動作名稱}」時發生錯誤。原因：找不到下列電子郵件地址的使用者：{entity.identifier}。請檢查拼字或停用「Validate Email CCs」參數。 如果至少有一個輸入內容不是有效的電子郵件地址： 執行「{動作名稱}」動作時發生錯誤。原因：找不到下列電子郵件地址的使用者：{entity.identifier}。請檢查拼字或停用「Validate Email CCs」參數。 |
一般 |
取得票券詳細資料
說明
依支援單 ID 取得支援單詳細資料、註解和附件。
參數
| 參數 | 類型 | 預設值 | 說明 |
|---|---|---|---|
| 支援單 ID | 字串 | 不適用 | 票證 ID。 |
用途
不適用
執行時間
這項操作會對所有實體執行。
動作執行結果
實體擴充
不適用
深入分析
不適用
指令碼執行結果
| 指令碼結果名稱 | 價值選項 | 示例 |
|---|---|---|
| ticket_details | 不適用 | 不適用 |
JSON 結果
{
"Details":
{
"ticket":
{
"follower_ids": [],
"via":
{
"source":
{"to": {},
"from": {},
"rel": "None"},
"channel": "web"
},
"updated_at": "2019-02-03T10:08:00Z",
"submitter_id": 360638872459,
"assignee_id": 360638872459,
"brand_id": 360000159559,
"id": 2,
"custom_fields": [],
"satisfaction_rating": "None",
"sharing_agreement_ids": [],
"allow_attachments": "True",
"collaborator_ids": [],
"priority": "high",
"subject": "Test",
"type": "incident",
"status": "open",
"description": "Test Test Test",
"tags": ["test"],
"forum_topic_id": "None",
"organization_id": 360018882419,
"due_at": "None",
"is_public": "True",
"requester_id": 360638872459,
"followup_ids": [],
"recipient": "None",
"problem_id": "None",
"url": "https://siemplifyhelp.zendesk.com/api/v2/tickets/2.json", "fields": [],
"created_at": "2019-02-03T10:08:00Z",
"raw_subject": "Test",
"email_cc_ids": [],
"allow_channelback": "False",
"has_incidents": "False",
"group_id": 360000361099,
"external_id": "None"
}
},
"Comments":
[{
"body": "Test Test Test",
"plain_body": "Test Test Test",
"via":
{
"source":
{"to": {},
"from": {},
"rel": "None"},
"channel": "web"
},
"attachments":
[{
"thumbnails": [],
"url": "https://siemplifyhelp.zendesk.com/api/v2/attachments/360701661660.json",
"file_name": "Siemplify 10 2018-12-11 (1).lic",
"content_url": "https://siemplifyhelp.zendesk.com/attachments/token/GeO6Xbc5I009xGRKLwWd7u7Qv/?name=Siemplify+10+2018-12-11+%281%29.lic",
"height": "None",
"width": "None",
"mapped_content_url": "https://siemplifyhelp.zendesk.com/attachments/token/GeO6Xbc5I009xGRKLwWd7u7Qv/?name=Siemplify+10+2018-12-11+%281%29.lic",
"content_type": "application/unknown",
"inline": "False",
"id": 360701661660,
"size": 1272
}],
"audit_id": 393260420939,
"created_at": "2019-02-03T10:08:00Z",
"id": 393260420979,
"author_id": 360638872459,
"html_body": "<div> Test Test Test < br >< /div>",
"type": "Comment",
"public": "True",
"metadata":
{
"system":
{
"latitude": 32.066599999999994,
"client": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/71.0.3578.98 Safari/537.36",
"ip_address": "1.1.1.1",
"location": "Tel Aviv, 05, Israel",
"longitude": 34.764999999999986
},
"custom": {}
}
}],
"Attachments": [{"test.txt": ""}]
}
乒乓
說明
測試連線。
參數
不適用
用途
不適用
執行時間
這項操作會對所有實體執行。
動作執行結果
實體擴充
不適用
深入分析
不適用
指令碼執行結果
| 指令碼結果名稱 | 價值選項 | 示例 |
|---|---|---|
| is_connected | True/False | is_connected:False |
JSON 結果
N/A
搜尋票券
說明
依關鍵字搜尋票證。
參數
| 參數 | 類型 | 預設值 | 說明 |
|---|---|---|---|
| 搜尋查詢 | 字串 | 不適用 | 查詢內容 (例如：type:ticket status:pending)。 |
用途
不適用
執行時間
這項操作會對所有實體執行。
動作執行結果
實體擴充
不適用
深入分析
不適用
指令碼執行結果
| 指令碼結果名稱 | 價值選項 | 示例 |
|---|---|---|
| results_count | 不適用 | 不適用 |
JSON 結果
N/A
更新票券
說明
更新現有支援單的詳細資料
參數
| 參數 | 類型 | 預設值 | 說明 |
|---|---|---|---|
| 支援單 ID | 字串 | 不適用 | 票券號碼。 |
| 主旨 | 字串 | 不適用 | 服務單的主旨。 |
| 已指派的使用者 | 字串 | 不適用 | 使用者全名。 |
| 指派群組 | 字串 | 不適用 | 群組名稱。 |
| 優先順序 | 字串 | 不適用 | 優先順序為「緊急」、「高」、「一般」或「低」。 |
| 票證類型 | 字串 | 不適用 | 票證類型為下列其中一種：問題、事件、疑問或工作。 |
| 標記 | 字串 | 不適用 | 要新增至票證的標記。 |
| 狀態 | 字串 | 不適用 | 狀態會是下列其中一種：新、開啟、待處理、暫緩、已解決或已結案。 |
| 其他意見 | 字串 | 不適用 | 如要為案件新增註解，請在此指定要新增為註解的文字。 |
| 內部注意事項 | 核取方塊 | 未勾選 | 指定留言應為公開或內部留言。取消勾選表示公開，勾選表示僅限內部 |
用途
不適用
執行時間
這項操作會對所有實體執行。
動作執行結果
實體擴充
不適用
深入分析
不適用
指令碼執行結果
| 指令碼結果名稱 | 價值選項 | 示例 |
|---|---|---|
| is_updated | True/False | is_updated:False |
JSON 結果
N/A
還有其他問題嗎？向社群成員和 Google SecOps 專業人員尋求答案。