Freshworks Freshservice

本文說明如何將 Freshworks Freshservice 與 Google Security Operations 整合。

應用實例

與服務台整合。

Freshservice 設定

Freshservice Google Security Operations 整合功能是根據 Freshservice API 金鑰運作。

如何取得 Freshservice 帳戶的 API 金鑰

  1. 登入 Freshservice 支援入口網站
  2. 按一下入口網站右上角的帳戶個人資料相片
  3. 前往「個人資料設定」頁面
  4. 帳戶 API 金鑰會顯示在右側的變更密碼部分下方
  5. 請儲存這個 API 金鑰，設定 Google SecOps 整合時會用到。

在 Google SecOps 中設定 Freshworks Freshservice 整合

如要瞭解如何在 Google SecOps 中設定整合功能，請參閱「設定整合功能」一文。

整合參數

請使用下列參數設定整合：

參數顯示名稱 類型 預設值 是否為必要 說明
API 根層級 字串 https://yourdomain.freshservice.com 是 Freshservice 執行個體 API 根網址。
API 金鑰 密碼 不適用 是 用於整合的 Freshservice API 金鑰。
驗證 SSL 核取方塊 已勾選 否 如果啟用，整合功能會驗證根網址是否已設定有效憑證。

動作

乒乓

說明

在 Google SecOps Content Hub 頁面的整合設定頁面，使用提供的參數測試與 Freshservice 執行個體的連線能力。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 價值選項
is_success is_success=False
is_success is_success=True
案件總覽
結果類型 值 / 說明 類型
輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

  • 如果成功：「已成功使用提供的連線參數連線至 Freshservice 執行個體！」

如果發生重大錯誤 (例如憑證錯誤或連線中斷)，動作應會失敗並停止執行應對手冊：「無法連線至 Freshservice 執行個體！錯誤為 {0}".format(exception.stacktrace)

 一般

列出票證

說明

根據指定的搜尋條件，列出 Freshservice 票證。請注意，動作不適用於 Google SecOps 實體。

參數

參數顯示名稱 類型 預設值 是否為必要 說明
票券類型 DDL 全部 否 指定要退款的票券類型。
要求者 字串 不適用 否 指定要傳回的票證要求者電子郵件地址。
納入統計資料 核取方塊 已取消勾選 否 如果啟用，動作會傳回票證的其他統計資料。
搜尋過去 X 小時 整數 不適用 否 指定要搜尋票證的時間範圍。
每頁列數 整數 30 否 指定 Freshservice 分頁每頁應傳回的票證數量。
從指定頁面開始 整數 1 否 指定要從哪一頁開始傳回 Freshservice 分頁票證。
要傳回的資料列數上限 整數 30 否 指定動作應傳回的票券總數。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 價值選項
is_success is_success=False
is_success is_success=True
JSON 結果
{
    "tickets": [
        {
            "subject": "Support Needed...",
            "group_id": null,
            "department_id": null,
            "category": null,
            "sub_category": null,
            "item_category": null,
            "requester_id": 17000032840,
            "responder_id": null,
            "due_by": "2021-07-08T21:00:00Z",
            "fr_escalated": false,
            "deleted": false,
            "spam": false,
            "email_config_id": null,
            "fwd_emails": [],
            "reply_cc_emails": [],
            "cc_emails": [],
            "is_escalated": false,
            "fr_due_by": "2021-07-01T18:00:00Z",
            "id": 7,
            "priority": 1,
            "status": 2,
            "source": 2,
            "created_at": "2021-06-29T08:56:24Z",
            "updated_at": "2021-06-29T10:04:51Z",
            "to_emails": null,
            "type": "Incident",
            "description": "<div>Details about the issue...</div>",
            "description_text": "Details about the issue...",
            "custom_fields": {},
            "requester": {
                "email": "dana@example.com",
                "id": 17000032840,
                "mobile": "dana@example.com",
                "name": "Dana",
                "phone": null
            }
        }
    ]
}
案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

  • 如果找到票證 (is_success = true)：「Successfully fetched Freshservice tickets.」
  • 如果未傳回任何票券 (is_success = false)：「找不到符合所提供輸入參數的票券。」
  • 如果取得票券時發生 API 錯誤 (is_success = false)：「Failed to list tickets with the provided input parameters. 錯誤訊息：{error from the API}"

動作應失敗並停止執行應對手冊：

如果發生嚴重錯誤，例如憑證錯誤、無法連線至伺服器等：「執行『列出支援單』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

 一般
資料表

表格名稱：找到的 Freshservice 支援單

表格欄：

ID

類型

主旨

說明

要求者電子郵件地址

類別

狀態

優先順序

來源

建立日期

更新日期

截止日

已提報

已刪除

 一般

建立支援單

說明

建立 Freshservice 票證。

參數

參數顯示名稱 類型 預設值 是否為必要 說明
主旨 字串 不適用 是 指定所建立支援單的主旨欄位。
說明 字串 不適用 是 指定所建立票證的說明欄位。
要求者電子郵件地址 字串 不適用 是 為建立的支援單指定要求者電子郵件地址。
代理指派對象 字串 不適用 否 指定要指派支援單的服務專員電子郵件地址。
群組指派對象 字串 不適用 否 指定要指派票證的群組名稱。
優先順序 DDL 中 是 指定要指派給票證的優先順序。
急迫性 DDL 中 否 指定要指派給支援單的緊急程度。
影響 DDL 中 否 指定要指派給票證的影響程度。
標記 字串 不適用 否 指定要指派給支援單的標記。參數接受多個值，請以半形逗號分隔。
部門名稱 字串 不適用 否 指定要擁有或管理票證的部門名稱。
自訂欄位 JSON 不適用 否

指定 JSON 物件，其中包含要新增至票證的自訂欄位。Acton 會將新的自訂欄位附加至任何現有的支援單。格式範例：

{"key1":"value1", "key2":"value2"}
要新增的檔案附件 字串 (CSV) 不適用 否 指定要與支援單一併上傳的檔案完整路徑。參數接受多個值，請以半形逗號分隔。附件總大小不得超過 15 MB。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 價值選項
is_success is_success=False
is_success is_success=True
JSON 結果
{
    "ticket": {
        "cc_emails": [],
        "fwd_emails": [],
        "reply_cc_emails": [],
        "fr_escalated": false,
        "spam": false,
        "email_config_id": null,
        "group_id": null,
        "priority": 2,
        "requester_id": 17000032840,
        "responder_id": null,
        "source": 2,
        "status": 2,
        "subject": "Support Needed 4...",
        "to_emails": null,
        "department_id": null,
        "id": 10,
        "type": "Incident",
        "due_by": "2021-07-02T18:00:00Z",
        "fr_due_by": "2021-06-30T20:00:00Z",
        "is_escalated": false,
        "description": "<div>Details about the issue...</div>",
        "description_text": "Details about the issue...",
        "category": null,
        "sub_category": null,
        "item_category": null,
        "custom_fields": {
            "test": "very_test"
        },
        "created_at": "2021-06-30T08:01:30Z",
        "updated_at": "2021-06-30T08:01:30Z",
        "tags": [
            "test"
        ],
        "attachments": []
    }
}
案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

  • 如果動作執行成功 (is_success=true)：建立新的 Freshservice 票證。

  • 如果動作因提供的參數而無法執行(is_success =false)：無法使用提供的參數建立新票證，錯誤訊息為：<error text>。

動作應失敗並停止執行應對手冊：

如果發生致命錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「執行『建立票證』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

 一般

更新支援單

說明

根據提供的動作輸入參數，更新 Freshservice 票證。請注意，如果為票證提供新標記，由於 Freshservice API 限制，動作會取代票證中的現有標記，而不是將新標記附加到現有標記。

參數

參數顯示名稱 類型 預設值 是否為必要 說明
支援單 ID 整數 不適用 是 指定要更新的票證 ID。
狀態 DDL 未變更 否 指定票證的新狀態。
主旨 字串 不適用 否 指定要更新的主旨欄位。
說明 字串 不適用 否 指定要更新的說明欄位。
要求者電子郵件地址 字串 不適用 否 指定要更新的要求者電子郵件地址。
代理指派對象 字串 不適用 否 指定要更新的代理電子郵件地址。
群組指派對象 字串 不適用 否 指定要更新的群組名稱。
優先順序 DDL 未變更 否 指定更新的優先順序。
急迫性 DDL 未變更 否 指定更新的緊急程度。
影響 DDL 未變更 否 指定要更新的影響。
標記 字串 不適用 否 指定要在票證中替換的標記。參數接受多個值，請以半形逗號分隔。請注意，由於 Freshservice API 限制，動作會取代票證中的現有標記，而不是在現有標記中附加新標記。
自訂欄位 JSON 不適用 否

指定 JSON 物件，其中包含要新增至票證的自訂欄位。Acton 會將新的自訂欄位附加至任何現有的支援單。格式範例：

{"key1":"value1", "key2":"value2"}
要新增的檔案附件 字串 (CSV) 不適用 否 指定要與支援單一併上傳的檔案完整路徑。參數接受多個值，請以半形逗號分隔。附件總大小不得超過 15 MB。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 價值選項
is_success is_success=False
is_success is_success=True
JSON 結果
{
    "ticket": {
        "cc_emails": [],
        "fwd_emails": [],
        "reply_cc_emails": [],
        "spam": false,
        "email_config_id": null,
        "fr_escalated": false,
        "group_id": 17000034192,
        "priority": 1,
        "requester_id": 17002188556,
        "responder_id": 17002188556,
        "source": 2,
        "status": 2,
        "subject": "Support Needed 9...",
        "description": "Details about the issue...",
        "description_text": "Details about the issue...",
        "category": null,
        "sub_category": null,
        "item_category": null,
        "custom_fields": {
            "test": "very_test"
        },
        "id": 12,
        "type": "Incident",
        "to_emails": null,
        "department_id": 17000016543,
        "is_escalated": false,
        "tags": [
            "test"
        ],
        "due_by": "2021-07-09T17:00:00-04:00",
        "fr_due_by": "2021-07-02T14:00:00-04:00",
        "created_at": "2021-06-30T08:36:43Z",
        "updated_at": "2021-06-30T09:39:12Z",
        "attachments": []
    }
}
案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

  • 如果動作執行成功：(is_success=true)

    • Freshservice 票證 <ticket id> 已更新。

  • 如果動作因提供的參數而無法執行(is_success =false)

    • 無法使用提供的參數更新票證 <ticket_id>，錯誤訊息：<error text>。

動作應失敗並停止執行應對手冊：

如果發生嚴重錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「執行『更新票證』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

 一般

列出票證對話

說明

根據指定的搜尋條件，列出 Freshservice 票證對話。 請注意，這項動作不適用於 Google SecOps 實體。

參數

參數顯示名稱 類型 預設值 是否為必要 說明
支援單 ID 整數 不適用 是 指定要傳回對話的票證 ID。
每頁列數 整數 30 否 指定 Freshservice 分頁每頁應傳回的票證對話數量。
從指定頁面開始 整數 1 否 指定要從哪一頁開始傳回 Freshservice 分頁的票證對話。
要傳回的資料列數上限 整數 30 否 指定動作應傳回的票證對話總數。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 價值選項
is_success is_success=False
is_success is_success=True
JSON 結果
{
    "conversations": [
        {
            "id": 17014994010,
            "user_id": 17000032840,
            "to_emails": [],
            "body": "<div>This is a test note!</div>",
            "body_text": "This is a test note!",
            "ticket_id": 12,
            "created_at": "2021-07-05T06:58:32Z",
            "updated_at": "2021-07-05T06:58:32Z",
            "incoming": false,
            "private": false,
            "support_email": null,
            "source": 2,
            "from_email": null,
            "cc_emails": [],
            "bcc_emails": null,
            "attachments": []
        },
        {
            "id": 17014993985,
            "user_id": 17000032840,
            "to_emails": [
                "dana@example.com"
            ],
            "body": "<div>We are working on this issue. Will keep you posted.</div>",
            "body_text": "We are working on this issue. Will keep you posted.",
            "ticket_id": 12,
            "created_at": "2021-07-05T06:57:27Z",
            "updated_at": "2021-07-05T06:57:27Z",
            "incoming": false,
            "private": false,
            "support_email": "helpdesk@siemplifyservicedesk.freshservice.com",
            "source": 0,
            "from_email": "helpdesk@siemplifyservicedesk.freshservice.com",
            "cc_emails": [],
            "bcc_emails": [],
            "attachments": []
        }
    ],
    "meta": {
        "count": 2
    }
}
案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

  • 如果找到票證對話 (is_success = true)：
    「已成功擷取 Freshservice 票證 <ticket id> 對話。」
  • 如果未傳回任何票證對話 (is_success = false)：
    「找不到票證 <ticket id> 的票證對話」
  • 如果找不到提供的支援單 ID (is_success = false)：
    「在 Freshservice 找不到支援單 <支援單 ID>。
  • 如果取得票證時發生 API 錯誤 (is_success = false)：「Failed to list ticket conversations with the provided input parameters. 錯誤訊息：{error from the API}"

動作應失敗並停止執行應對手冊：

如果發生嚴重錯誤，例如憑證錯誤、無法連線至伺服器等：

「執行『列出票證對話』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

 一般
資料表

資料表名稱：Freshservice Ticket <ticket id> Conversations

表格欄：

ID

類型

顯示設定

使用者電子郵件地址

文字

寄件者電子郵件地址

收件者電子郵件地址

副本電子郵件地址

密件副本電子郵件

 一般

新增票證回覆

說明

回覆 Freshservice 票證。請注意，這項動作不適用於 Google SecOps 實體。

參數

參數顯示名稱 類型 預設值 是否為必要 說明
支援單 ID 整數 不適用 是 指定要傳回對話的票證 ID。
回覆文字 字串 不適用 是 指定要新增至票證的回覆文字。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 價值選項
is_success is_success=False
is_success is_success=True
JSON 結果
    "conversation": {
        "id": 17014998560,
        "user_id": 17000032840,
        "from_email": "helpdesk@siemplifyservicedesk.freshservice.com",
        "cc_emails": [],
        "bcc_emails": [],
        "body": "<div>We are working on this issue. Will keep you posted.2</div>",
        "body_text": "We are working on this issue. Will keep you posted.2",
        "ticket_id": 12,
        "to_emails": [
            "dana@example.com"
        ],
        "attachments": [],
        "created_at": "2021-07-05T09:19:02Z",
        "updated_at": "2021-07-05T09:19:02Z"
    }
}
案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

  • 如果動作執行成功：(is_success=true)

    • 支援單 <ticket id> 有新回覆。

  • 如果找不到提供的票券 ID (is_success = false)：

    • 「在 Freshservice 找不到票證 <ticket id>。

動作應失敗並停止執行應對手冊：

如果發生嚴重錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器)，或其他錯誤：「執行『新增客服單回覆』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

 一般

新增票券附註

說明

在 Freshservice 票證中新增附註。請注意，這項動作不適用於 Google SecOps 實體。

參數

參數顯示名稱 類型 預設值 是否為必要 說明
支援單 ID 整數 不適用 是 指定要傳回對話的票證 ID。
附註類型 DDL 私人 否 指定動作應新增至票證的附註類型。
附註文字 字串 不適用 是 指定要新增至票證的附註文字。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 價值選項
is_success is_success=False
is_success is_success=True
JSON 結果
{
    "conversation": {
        "id": 17014999107,
        "incoming": false,
        "private": false,
        "user_id": 17000032840,
        "support_email": null,
        "body": "<div>This is a test note2!</div>",
        "body_text": "This is a test note2!",
        "ticket_id": 12,
        "to_emails": [],
        "attachments": [],
        "created_at": "2021-07-05T09:35:28Z",
        "updated_at": "2021-07-05T09:35:28Z"
    }
}
案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

  • 如果動作執行成功：(is_success=true)

    • 已在票證 <ticket id> 中新增 <note type> 附註。

  • 如果找不到提供的票券 ID (is_success = false)：

    • 「在 Freshservice 找不到票證 <ticket id>。

動作應失敗並停止執行應對手冊：

如果發生致命錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「執行『新增票證附註』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

 一般

可列出代理程式

說明

根據指定的搜尋條件，列出 Freshservice 代理。請注意，動作不適用於 Google SecOps 實體。

參數

參數顯示名稱 類型 預設值 是否為必要 說明
代理電子郵件地址 字串 不適用 否 指定要傳回代理記錄的電子郵件地址。
代理狀態 DDL 全部 否 指定要傳回的代理狀態。
納入非活躍代理 核取方塊 已取消勾選 否 如果啟用，結果會包含非使用中的代理記錄。
每頁列數 整數 30 否 指定 Freshservice 分頁每頁應傳回的代理記錄數量。
從指定頁面開始 整數 1 否 指定要從哪一頁開始傳回 Freshservice 分頁的代理記錄。
要傳回的資料列數上限 整數 30 否 指定動作應傳回的代理記錄總數。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 價值選項
is_success is_success=False
is_success is_success=True
JSON 結果
{
    "agents": [
        {
            "active": true,
            "address": null,
            "background_information": null,
            "can_see_all_tickets_from_associated_departments": false,
            "created_at": "2021-06-29T10:37:36Z",
            "custom_fields": {},
            "department_ids": [
                17000016543
            ],
            "email": "dana@example.com",
            "external_id": null,
            "first_name": "dmitry",
            "has_logged_in": false,
            "id": 17002188556,
            "job_title": null,
            "language": "en",
            "last_active_at": null,
            "last_login_at": null,
            "last_name": "s",
            "location_id": null,
            "mobile_phone_number": null,
            "occasional": true,
            "reporting_manager_id": null,
            "role_ids": [
                17000023339
            ],
            "roles": [
                {
                    "role_id": 17000023339,
                    "assignment_scope": "entire_helpdesk",
                    "groups": []
                }
            ],
            "scopes": {
                "ticket": null,
                "problem": null,
                "change": null,
                "asset": null,
                "solution": null,
                "contract": null
            },
            "scoreboard_level_id": 1,
            "signature": "<p> </p>\n",
            "time_format": "12h",
            "time_zone": "American Samoa",
            "updated_at": "2021-06-29T10:37:36Z",
            "work_phone_number": null,
            "group_ids": [
                17000034192
            ],
            "member_of": [
                17000034192
            ],
            "observer_of": []
        },
案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

  • 如果找到服務專員 (is_success = true)：「Successfully fetched Freshservice agents.」
  • 如果沒有傳回任何代理程式 (is_success = false)：「找不到符合所提供輸入參數的代理程式。」
  • 如果取得代理時發生 API 錯誤 (is_success = false)：「無法使用提供的輸入參數列出代理。錯誤訊息：{error from the API}"

動作應失敗並停止執行應對手冊：

如果發生嚴重錯誤，例如憑證錯誤、無法連線至伺服器等：

「執行『列出代理』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

 一般

表格

資料表名稱：找到的 Freshservice 代理

表格欄：

ID

電子郵件

名字

姓氏

角色

群組

部門

位置

有效

偶爾

自訂欄位

建立日期

更新日期

上次上線日期

上次登入日期

 一般

列出要求者

說明

根據指定的搜尋條件，列出在 Freshservice 註冊的要求者。請注意，這項動作不適用於 Google SecOps 實體。

參數

參數顯示名稱 類型 預設值 是否為必要 說明
要求者電子郵件地址 字串 不適用 否 指定要傳回要求者記錄的電子郵件地址。
每頁列數 整數 30 否 指定 Freshservice 分頁每頁應傳回的代理記錄數量。
從指定頁面開始 整數 1 否 指定要從哪一頁開始傳回 Freshservice 分頁的代理記錄。
要傳回的資料列數上限 整數 30 否 指定動作應傳回的代理記錄總數。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 價值選項
is_success is_success=False
is_success is_success=True
JSON 結果
{
    "requesters": [
        {
            "active": true,
            "address": null,
            "background_information": null,
            "can_see_all_tickets_from_associated_departments": false,
            "created_at": "2020-07-06T08:07:30Z",
            "custom_fields": {
                "test": null
            },
            "department_ids": [],
            "external_id": null,
            "first_name": "Dana",
            "has_logged_in": false,
            "id": 17000038164,
            "job_title": null,
            "language": "en",
            "last_name": "Doe",
            "location_id": null,
            "mobile_phone_number": null,
            "primary_email": "dana@example.com",
            "reporting_manager_id": null,
            "secondary_emails": [],
            "time_format": "12h",
            "time_zone": "Eastern Time (US & Canada)",
            "updated_at": "2020-07-06T08:07:30Z",
            "work_phone_number": null
        }
    ]
}
案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

  • 如果找到要求者 (is_success = true)：
    「Successfully fetched Freshservice registered requesters.」
  • 如果沒有傳回任何要求者 (is_success = false)：
    「找不到符合所提供輸入參數的要求者。」
  • If got an API error getting requesters (is_success = false): "Failed to list requesters with the provided input parameters. 錯誤訊息：{error from the API}"

動作應失敗並停止執行應對手冊：

如果發生嚴重錯誤，例如憑證錯誤、無法連線至伺服器等：

「執行『列出要求者』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

 一般

表格

資料表名稱：找到 Freshservice 要求者

表格欄：

ID

電子郵件

名字

姓氏

部門

位置

有效

自訂欄位

建立日期

更新日期

 一般

新建代理程式

說明

建立新的 Freshservice 代理。請注意，這項動作不適用於 Google SecOps 實體。

參數

參數顯示名稱 類型 預設值 是否為必要 說明
電子郵件 字串 不適用 是 指定要建立的代理電子郵件地址。
名字 字串 不適用 是 指定要建立的代理名字。
姓氏 字串 不適用 否 指定要建立的代理姓氏。
偶爾 核取方塊 已取消勾選 否 如果啟用，系統會建立臨時代理，否則會建立全職代理。
可查看相關部門的所有支援單 核取方塊 已取消勾選 否

如果啟用，服務專員就能查看相關聯部門的所有票證。
部門 CSV 不適用 否 指定與服務專員相關聯的部門名稱。參數接受多個值，請以半形逗號分隔。
位置 字串 不適用 否 指定與代理程式相關聯的位置名稱。
群組成員 CSV 不適用 否 指定代理應加入的群組名稱。
角色 CSV 不適用 是

指定要新增至代理的角色。參數接受多個值，請以半形逗號分隔。

範例：{"role_id":17000023338,"assignment_scope": ""}
職稱 字串 不適用 否 指定代理職稱。
自訂欄位 JSON 不適用 否

指定 JSON 物件，其中包含要新增至代理的自訂欄位。Acton 會將新的自訂欄位附加至任何現有的支援單。格式範例：

{"key1":"value1", "key2":"value2"}

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 價值選項
is_success is_success=False
is_success is_success=True
JSON 結果
{
    "agent": {
        "active": true,
        "address": null,
        "background_information": null,
        "can_see_all_tickets_from_associated_departments": false,
        "created_at": "2021-07-06T05:40:41Z",
        "custom_fields": {
            "test": "testvalue"
        },
        "department_ids": [],
        "email": "rolanda.hooch@hogwarts.edu",
        "external_id": null,
        "first_name": "Rolanda",
        "has_logged_in": false,
        "id": 17002198254,
        "job_title": "Flying Instructor",
        "language": "en",
        "last_active_at": null,
        "last_login_at": null,
        "last_name": "Hooch",
        "location_id": null,
        "mobile_phone_number": "553632",
        "occasional": true,
        "reporting_manager_id": null,
        "role_ids": [
            17000023338
        ],
        "roles": [
            {
                "role_id": 17000023338,
                "assignment_scope": "entire_helpdesk",
                "groups": []
            }
        ],
        "scopes": {
            "ticket": null,
            "problem": null,
            "change": null,
            "asset": null,
            "solution": null,
            "contract": null
        },
        "scoreboard_level_id": 1,
        "signature": null,
        "time_format": "12h",
        "time_zone": "Eastern Time (US & Canada)",
        "updated_at": "2021-07-06T05:40:41Z",
        "work_phone_number": "443532",
        "group_ids": [
            17000034192
        ],
        "member_of": [
            17000034192
        ],
        "observer_of": []
    }
}
案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

  • 如果動作執行成功：(is_success=true)

    • 已建立新的 Freshservice 代理。

  • 如果動作因提供的參數而無法執行(is_success =false)

    • 無法使用提供的參數建立新代理，錯誤訊息為：<error text>。

動作應失敗並停止執行應對手冊：

如果發生致命錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「執行『建立代理』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

 一般

更新代理程式

說明

更新現有的 Freshservice 代理。請注意，這項動作不適用於 Google SecOps 實體。

參數

參數顯示名稱 類型 預設值 是否為必要 說明
代理 ID 整數 不適用 是 指定要更新的代理 ID。
電子郵件 字串 不適用 否 指定要更新的代理電子郵件地址。
名字 字串 不適用 否 指定要更新的代理名字。
姓氏 字串 不適用 否 指定要更新的代理姓氏。
偶爾 核取方塊 已取消勾選 否 如果啟用，代理程式會更新為臨時代理程式，否則會是全職代理程式。
可查看相關部門的所有支援單 核取方塊 已取消勾選 否

如果啟用，服務專員就能查看相關聯部門的所有票證。
部門 CSV 不適用 否 指定與服務專員相關聯的部門名稱。參數接受多個值，請以半形逗號分隔。
位置 字串 不適用 否 指定與代理程式相關聯的位置名稱。
群組成員 CSV 不適用 否 指定代理應加入的群組名稱。
角色 CSV 不適用 否

指定要新增至代理的角色。參數接受多個值，請以半形逗號分隔。

範例：{"role_id":17000023338,"assignment_scope": "entire_helpdesk"}
職稱 字串 不適用 否 指定代理職稱。
自訂欄位 JSON 不適用 否

指定 JSON 物件，其中包含要新增至代理的自訂欄位。Acton 會將新的自訂欄位附加至任何現有的支援單。格式範例：

{"key1":"value1", "key2":"value2"}

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 價值選項
is_success is_success=False
is_success is_success=True
JSON 結果
{
    "agent": {
        "active": true,
        "address": null,
        "background_information": null,
        "can_see_all_tickets_from_associated_departments": false,
        "created_at": "2021-07-06T05:40:41Z",
        "custom_fields": {
            "test": "testvalue"
        },
        "department_ids": [],
        "email": "rolanda.hooch@hogwarts.edu",
        "external_id": null,
        "first_name": "Rolanda",
        "has_logged_in": false,
        "id": 17002198254,
        "job_title": "Flying Instructor",
        "language": "en",
        "last_active_at": null,
        "last_login_at": null,
        "last_name": "Hooch",
        "location_id": null,
        "mobile_phone_number": "553632",
        "occasional": true,
        "reporting_manager_id": null,
        "role_ids": [
            17000023338
        ],
        "roles": [
            {
                "role_id": 17000023338,
                "assignment_scope": "entire_helpdesk",
                "groups": []
            }
        ],
        "scopes": {
            "ticket": null,
            "problem": null,
            "change": null,
            "asset": null,
            "solution": null,
            "contract": null
        },
        "scoreboard_level_id": 1,
        "signature": null,
        "time_format": "12h",
        "time_zone": "Eastern Time (US & Canada)",
        "updated_at": "2021-07-06T05:40:41Z",
        "work_phone_number": "443532",
        "group_ids": [
            17000034192
        ],
        "member_of": [
            17000034192
        ],
        "observer_of": []
    }
}
案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

  • 如果動作執行成功：(is_success=true)

    • Freshservice 代理 <agent_id> 已更新。

  • 如果動作因提供的參數而無法執行(is_success =false)

    • 無法使用提供的參數更新 Freshservice 代理 <agent_id>，錯誤訊息：<error text>。

動作應失敗並停止執行應對手冊：

如果發生致命錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「執行『更新代理』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

 一般

停用代理

說明

停用 Freshservice 代理。請注意，這項動作不適用於 Google SecOps 實體。

參數

參數顯示名稱 類型 預設值 是否為必要 說明
代理 ID 整數 不適用 是 指定要停用的代理 ID。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 價值選項
is_success is_success=False
is_success is_success=True
JSON 結果
{
    "agent": {
        "active": false,
        "address": null,
        "background_information": null,
        "can_see_all_tickets_from_associated_departments": false,
        "created_at": "2021-07-06T05:40:41Z",
        "custom_fields": {
            "test": "testvalue3"
        },
        "department_ids": [],
        "email": "rolanda.hooch@hogwarts.edu",
        "external_id": null,
        "first_name": "Rolanda",
        "has_logged_in": false,
        "id": 17002198254,
        "job_title": "Flying Instructor",
        "language": "en",
        "last_active_at": null,
        "last_login_at": null,
        "last_name": "Hooch",
        "location_id": null,
        "mobile_phone_number": "553632",
        "occasional": true,
        "reporting_manager_id": null,
        "role_ids": [
            17000023338
        ],
        "roles": [
            {
                "role_id": 17000023338,
                "assignment_scope": "entire_helpdesk",
                "groups": []
            }
        ],
        "scopes": {
            "ticket": null,
            "problem": null,
            "change": null,
            "asset": null,
            "solution": null,
            "contract": null
        },
        "scoreboard_level_id": 2,
        "signature": "<p> </p>\n",
        "time_format": "24h",
        "time_zone": "Eastern Time (US & Canada)",
        "updated_at": "2021-07-06T06:26:59Z",
        "work_phone_number": "443532",
        "group_ids": [],
        "member_of": [],
        "observer_of": []
    }
}
案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

  • 如果動作執行成功：(is_success=true)

    • Freshservice 代理 <agent_id> 已停用。

  • 如果動作因 404 錯誤而無法執行 (is_success =false)

    • 找不到要停用的 Freshservice 代理 <agent_id>。

  • 如果動作因 403 錯誤而無法執行 (is_success =false)

    • 無法停用 Freshservice 代理 <agent_id>，可能已停用。API 回應："code": "access_denied","message": "You are not authorized to perform this action."

動作應失敗並停止執行應對手冊：

如果發生嚴重錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器) 或其他錯誤：「執行『停用代理』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

 一般

建立要求者

說明

建立新的 Freshservice 要求者。請注意，這項動作不適用於 Google SecOps 實體。

參數

參數顯示名稱 類型 預設值 是否為必要 說明
電子郵件 字串 不適用 是 指定要建立的要求者電子郵件地址。
名字 字串 不適用 是 指定要建立的要求者名字。
姓氏 字串 不適用 否 指定要建立的要求者姓氏。
可查看相關部門的所有支援單 核取方塊 已取消勾選 否

如果啟用，要求者將能查看相關聯部門的所有票證。
部門 CSV 不適用 否 指定與要求者相關聯的部門名稱。參數接受多個值，請以半形逗號分隔。
位置 字串 不適用 否 指定與要求者相關聯的地點名稱。
職稱 字串 不適用 否 指定要求者的職稱。
自訂欄位 JSON 不適用 否

指定 JSON 物件，其中包含要新增至要求者的自訂欄位。Acton 會將新的自訂欄位附加至任何現有的支援單。格式範例：

{"key1":"value1", "key2":"value2"}

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 價值選項
is_success is_success=False
is_success is_success=True
JSON 結果
{
    "requester": {
        "active": true,
        "address": null,
        "background_information": null,
        "can_see_all_tickets_from_associated_departments": false,
        "created_at": "2021-07-06T08:12:47Z",
        "custom_fields": {
            "test": "testvalue"
        },
        "department_ids": [],
        "external_id": null,
        "first_name": "Rolanda",
        "has_logged_in": false,
        "id": 17002198308,
        "job_title": "Flying Instructor",
        "language": "en",
        "last_name": "Hooch",
        "location_id": null,
        "mobile_phone_number": null,
        "primary_email": "rolanda.hooch2@hogwarts.edu",
        "reporting_manager_id": null,
        "secondary_emails": [],
        "time_format": "12h",
        "time_zone": "Eastern Time (US & Canada)",
        "updated_at": "2021-07-06T08:12:47Z",
        "work_phone_number": null
    }
}
案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

  • 如果動作執行成功：(is_success=true)

    • 已建立新的 Freshservice 要求者。

  • 如果動作因提供的參數而無法執行(is_success =false)

    • 無法使用提供的參數建立新的要求者，錯誤訊息為：<error text>。

動作應失敗並停止執行應對手冊：

如果發生嚴重錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器)，或其他錯誤：「執行『建立要求者』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

 一般

更新要求者

說明

更新現有的 Freshservice 要求者。請注意，這項動作不適用於 Google SecOps 實體。

參數

參數顯示名稱 類型 預設值 是否為必要 說明
要求者 ID 整數 不適用 是 請指定要更新的要求者 ID。
電子郵件 字串 不適用 否 指定要更新的要求者電子郵件地址。
名字 字串 不適用 否 指定要更新的要求者名字。
姓氏 字串 不適用 否 指定要更新的要求者姓氏。
可查看相關部門的所有支援單 核取方塊 已取消勾選 否

如果啟用，要求者將能查看相關聯部門的所有票證。
部門 CSV 不適用 否 指定與要求者相關聯的部門名稱。參數接受多個值，請以半形逗號分隔。
位置 字串 不適用 否 指定與要求者相關聯的地點名稱。
職稱 字串 不適用 否 指定要求者的職稱。
自訂欄位 JSON 不適用 否

指定 JSON 物件，其中包含要新增至要求者的自訂欄位。Acton 會將新的自訂欄位附加至任何現有的支援單。格式範例：

{"key1":"value1", "key2":"value2"}

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 價值選項
is_success is_success=False
is_success is_success=True
JSON 結果
{
    "agent": {
        "active": true,
        "address": null,
        "background_information": null,
        "can_see_all_tickets_from_associated_departments": false,
        "created_at": "2021-07-06T05:40:41Z",
        "custom_fields": {
            "test": "testvalue"
        },
        "department_ids": [],
        "email": "rolanda.hooch@hogwarts.edu",
        "external_id": null,
        "first_name": "Rolanda",
        "has_logged_in": false,
        "id": 17002198254,
        "job_title": "Flying Instructor",
        "language": "en",
        "last_active_at": null,
        "last_login_at": null,
        "last_name": "Hooch",
        "location_id": null,
        "mobile_phone_number": "553632",
        "occasional": true,
        "reporting_manager_id": null,
        "role_ids": [
            17000023338
        ],
        "roles": [
            {
                "role_id": 17000023338,
                "assignment_scope": "entire_helpdesk",
                "groups": []
            }
        ],
        "scopes": {
            "ticket": null,
            "problem": null,
            "change": null,
            "asset": null,
            "solution": null,
            "contract": null
        },
        "scoreboard_level_id": 1,
        "signature": null,
        "time_format": "12h",
        "time_zone": "Eastern Time (US & Canada)",
        "updated_at": "2021-07-06T05:40:41Z",
        "work_phone_number": "443532",
        "group_ids": [
            17000034192
        ],
        "member_of": [
            17000034192
        ],
        "observer_of": []
    }
}
案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

  • 如果動作執行成功：(is_success=true)

    • Freshservice 請求者 <requester_id> 已更新。

  • 如果動作因提供的參數而無法執行(is_success =false)

    • 無法使用提供的參數更新 Freshservice 要求者 <requester_id>，錯誤訊息：<error text>。

動作應失敗並停止執行應對手冊：

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Update Requester". 原因：{0}''.format(error.Stacktrace)

 一般

停用要求者

說明

停用 Freshservice 要求者。請注意，這項動作不適用於 Google SecOps 實體。

參數

參數顯示名稱 類型 預設值 是否為必要 說明
要求者 ID 整數 不適用 是 指定要停用的要求者 ID。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 價值選項
is_success is_success=False
is_success is_success=True
案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

  • 如果動作執行成功：(is_success=true)

    • Freshservice 要求者 <requester_id> 已停用。

  • 如果動作因 404 錯誤而無法執行 (is_success =false)

    • 找不到要停用的 Freshservice 要求者 <requester_id>。

  • 如果動作因 405 錯誤而無法執行 (is_success =false)

    • 無法停用 Freshservice 請求者 <requester_id>，可能已停用？API 回應：「message」：「DELETE method is not allowed. 必須是下列其中一種方法：GET」

動作應失敗並停止執行應對手冊：

如果發生致命錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「執行『停用要求者』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

 一般

列出票證時間項目

說明

根據指定的搜尋條件，列出 Freshservice 票證時間項目。 請注意，這項動作不適用於 Google SecOps 實體。

參數

參數顯示名稱 類型 預設值 是否為必要 說明
支援單 ID 整數 不適用 是 指定要傳回時間項目的票證 ID。
代理電子郵件地址 字串 不適用 是 指定服務專員電子郵件地址，列出對應的票證時間項目。
每頁列數 整數 30 否 指定 Freshservice 分頁每頁應傳回的票證時間項目數量。
從指定頁面開始 整數 1 否 指定要從哪一頁開始傳回 Freshservice 分頁的票證時間項目。
要傳回的資料列數上限 整數 30 否 指定動作應傳回的票證時間項目總數。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 價值選項
is_success is_success=False
is_success is_success=True
JSON 結果
{
   "time_entries": [
       {
           "id": 17000399635,
           "created_at": "2021-07-08T06:26:47Z",
           "updated_at": "2021-07-08T06:26:47Z",
           "start_time": "2021-07-08T06:26:47Z",
           "timer_running": false,
           "billable": true,
           "time_spent": "01:00",
           "executed_at": "2021-07-08T06:26:47Z",
           "task_id": null,
           "note": "test_entry2",
           "agent_id": 17002188556,
           "custom_fields": {}
       }
   ]
}
案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

  • 如果找到票證時間項目 (is_success = true)：
    「已成功擷取 Freshservice 票證 <ticket id> 時間項目。」
  • 如果未傳回任何票證時間項目 (is_success = false)：
    「找不到票證 <ticket id> 的時間項目」
  • 如果找不到提供的支援單 ID (is_success = false)：
    「在 Freshservice 找不到支援單 <支援單 ID>。
  • 如果找不到與所提供代理電子郵件地址相關聯的代理 ID (is_success = false)：
    "Agent <agent_email> was not found in Freshservice.
  • 如果取得票證時間項目時發生 API 錯誤 (is_success = false)：「無法使用提供的輸入參數列出票證時間項目。錯誤訊息：{error from the API}"

動作應失敗並停止執行應對手冊：

如果發生嚴重錯誤，例如憑證錯誤、無法連線至伺服器等：

執行「列出票證時間項目」動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

 一般
資料表

資料表名稱：Freshservice Ticket <ticket id> Time Entries

表格欄：

時間項目 ID

代理電子郵件地址

注意事項

計費

停留時間

工作 ID

自訂欄位

計時中

建立時間

更新時間

開始時間

執行時間

 一般

新增票證時間項目

說明

在 Freshservice 票證中新增時間項目。請注意，這項動作不適用於 Google SecOps 實體。

參數

參數顯示名稱 類型 預設值 是否為必要 說明
支援單 ID 整數 不適用 是 指定要新增時間項目的票證 ID。
代理電子郵件地址 字串 不適用 是 指定要新增票證時間項目的服務專員電子郵件地址。
注意事項 字串 不適用 否 指定要新增至票證時間項目的附註。
停留時間 字串 不適用 是 指定支援單時間項目花費的時間。格式：{hh:mm}
計費 核取方塊 否 否 啟用後，系統會將票證時間項目標示為可計費。
自訂欄位 JSON 不適用 否

指定 JSON 物件，其中包含要新增至票證時間項目的自訂欄位。Acton 會將新的自訂欄位附加至任何現有的支援單。格式範例：

{"key1":"value1", "key2":"value2"}

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 價值選項
is_success is_success=False
is_success is_success=True
JSON 結果
{
   "time_entry": {
       "id": 17000405061,
       "created_at": "2021-07-10T18:22:18Z",
       "updated_at": "2021-07-10T18:22:18Z",
       "start_time": "2021-07-10T18:22:18Z",
       "timer_running": false,
       "billable": true,
       "time_spent": "01:00",
       "executed_at": "2021-07-10T18:22:18Z",
       "task_id": null,
       "note": "test_entry3",
       "agent_id": 17002188556,
       "custom_fields": {
           "test": "very_test"
       }
   }
}
案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

  • 如果動作執行成功：(is_success=true)

    • 已在票證 <ticket id> 中新增時間項目。

  • 如果找不到提供的票券 ID (is_success = false)：

    • 「在 Freshservice 找不到票證 <ticket id>。

  • 如果找不到提供的服務專員電子郵件地址 (is_success = false)：

    • 「在 Freshservice 找不到電子郵件地址為 <agent_email> 的服務專員。

  • 如果提供的時間格式有誤 (is_success = false)：

    • 「指定的時間長度值 <time_spent> 格式不正確，應為『hh:mm』格式。

動作應失敗並停止執行應對手冊：

如果發生致命錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「執行『新增票證時間項目』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

 一般

更新票證時間項目

說明

更新 Freshservice 票證的時間項目。請注意，這項動作不適用於 Google SecOps 實體

參數

參數顯示名稱 類型 預設值 是否為必要 說明
支援單 ID 整數 不適用 是 指定要更新時間項目的票證 ID。
時間項目 ID 整數 不適用 是 指定要更新的時間項目 ID。
代理電子郵件地址 字串 不適用 否 指定要變更支援單時間項目的服務專員電子郵件地址。
注意事項 字串 不適用 否 指定票證時間項目的附註。
停留時間 字串 不適用 否 指定支援單時間項目花費的時間。格式：{hh:mm}
計費 核取方塊 False (未勾選) 否 啟用後，系統會將票證時間項目標示為可計費。
自訂欄位 JSON 不適用 否

指定 JSON 物件，其中包含要新增至票證時間項目的自訂欄位。Acton 會將新的自訂欄位附加至任何現有的支援單。格式範例：

{"key1":"value1", "key2":"value2"}

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 價值選項
is_success is_success=False
is_success is_success=True
JSON 結果
{
    "time_entry": {
        "id": 17000405061,
        "created_at": "2021-07-10T18:22:18Z",
        "updated_at": "2021-07-10T18:30:54Z",
        "start_time": "2021-07-10T18:22:18Z",
        "timer_running": false,
        "billable": false,
        "time_spent": "03:30",
        "executed_at": "2021-07-10T18:22:18Z",
        "task_id": null,
        "note": "test_entry_updated",
        "agent_id": 17002188556,
        "custom_fields": {
            "test": "very_test2"
        }
    }
}
案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

  • 如果動作執行成功：(is_success=true)

    • 已更新支援單 <ticket id> 的時間項目 <time_entry_id>。

  • 如果找不到提供的票證 ID 或時間項目 ID (is_success = false)：

    • 在 Freshservice 找不到提供的票證 ID <ticket_id> 或時間項目 ID <time_entry id>。

  • 如果找不到提供的服務專員電子郵件地址 (is_success = false)：

    • 「在 Freshservice 找不到電子郵件地址為 <agent_email> 的服務專員。

  • 如果提供的時間格式有誤 (is_success = false)：

    • 「指定的時間長度值 <time_spent> 格式不正確，應為『hh:mm』格式。

動作應失敗並停止執行應對手冊：

如果發生嚴重錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器) 或其他錯誤：「執行『更新票證時間項目』動作時發生錯誤。原因：{0}''.format(error.Stacktrace)

 一般

刪除票證時間項目

說明

刪除 Freshservice 票證的時間項目。請注意，這項動作不適用於 Google SecOps 實體。

參數

參數顯示名稱 類型 預設值 是否為必要 說明
支援單 ID 整數 不適用 是 指定要刪除時間項目的票證 ID。
時間項目 ID 整數 不適用 是 指定要刪除的時間項目 ID。

執行日期

這項動作不會對實體執行。

動作執行結果

指令碼執行結果
指令碼執行結果名稱 價值選項
is_success is_success=False
is_success is_success=True
案件總覽
結果類型 值/說明 類型
輸出訊息*

動作不應失敗，也不應停止執行應對手冊：

  • 如果動作執行成功：(is_success=true)

    • 已刪除票證 <ticket id> 的時間項目 <time_entry_id>。

  • 如果找不到提供的票證 ID 或時間項目 ID (is_success = false)：

    • 在 Freshservice 找不到提供的票證 ID <ticket_id> 或時間項目 ID <time_entry id>

動作應失敗並停止執行應對手冊：

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Delete Ticket Time Entry". 原因：{0}''.format(error.Stacktrace)

 一般

連接器

Freshservice 支援單連接器

說明

連接器可用來擷取 Freshservice 票證，並據此建立 Google SecOps 警示。連接器許可清單可用於僅擷取特定類型的票證，例如事件或服務要求。

在 Google SecOps 中設定 Freshservice Tickets 連接器

如要瞭解如何在 Google SecOps 中設定連接器，請參閱「設定連接器」一文。

連接器參數

使用下列參數設定連接器：

參數顯示名稱 類型 預設值 為必填項目 說明
產品欄位名稱 字串 Freshworks Freshservice 是
事件欄位名稱 字串 "type" 是
環境欄位名稱 字串 "" 否 否
環境規則運算式模式 字串 .* 否 否
API 根層級 字串

https://yourdomain.freshservice.com

 是 Freshservice 執行個體 API 根網址。
API 金鑰 密碼 不適用 是 用於整合的 Freshservice API 金鑰。
驗證 SSL 核取方塊 已勾選 否 如果啟用，整合功能會嘗試驗證根網址是否已設定有效憑證。
偏移時間 (以小時為單位) 整數 24 是 擷取 X 小時前的票證。
每個週期最多可獲得的彩券數 整數 30 是 連接器執行一次應處理的票證數量。
擷取優先順序下限 字串 中 否 要擷取至 Google SecOps 的最低票證優先順序，例如「低」或「中」。可能的值：低、中、高、緊急
要擷取的票券狀態 CSV 開放、不開放 否 要擷取至 Google SecOps 的票證狀態。參數接受多個值，請以半形逗號分隔。可能的值：Open、Pending、Resolved、Closed
將許可清單當做黑名單使用 核取方塊 已取消勾選 是 如果啟用，許可清單會當做黑名單使用。

連接器規則

Proxy 支援

連接器支援 Proxy。

工作

Freshservice 同步處理支援單關閉工作

說明

如果對應的 Google SecOps 警示已關閉，則關閉 Freshservice 中的票證。

參數

參數顯示名稱 類型 預設值 是否為必要 說明
API 根層級 字串 https://yourdomain.freshservice.com 是 Freshservice 執行個體 API 根網址。
API 金鑰 密碼 不適用 是 用於整合的 Freshservice API 金鑰。
驗證 SSL 核取方塊 已勾選 否 如果啟用，整合功能會嘗試驗證根網址是否已設定有效憑證。
偏移時間 (以小時為單位) 整數 24 是 同步處理 X 小時前關閉的票證。
預設支援單說明 字串 Siemplify Freshservice Sync Tickets Closure Job 已關閉支援單。 是 如果票證沒有說明，請指定要新增至票證的說明，以便在 Freshservice 中關閉票證，因為 Freshservice 必須填寫說明欄位。

Freshservice 同步處理支援單對話工作

說明

在 Google SecOps 警告案件和對應的 Freshservice 票證之間，同步處理對話 (包括回覆和附註)。同步機制可雙向運作，也就是 Google SecOps → Freshservice 和 Freshservice → Google SecOps。

參數

參數顯示名稱 類型 預設值 是否為必要 說明
API 根層級 字串 https://yourdomain.freshservice.com 是 Freshservice 執行個體 API 根網址。
API 金鑰 密碼 不適用 是 用於整合的 Freshservice API 金鑰。
驗證 SSL 核取方塊 已勾選 否 如果啟用，整合功能會嘗試驗證根網址是否已設定有效憑證。
偏移時間 (以小時為單位) 整數 24 是 同步處理 X 小時前的票證對話
Siemplify 註解前置字串 字串 SIEMPLIFY： 是 同步處理工作會將這個前置字元，新增至為 Freshservice 票證建立的註解。
Freshservice 註解前置字串 字串 Freshservice 留言同步處理工作： 是 同步處理工作會將這個前置字串，新增至 Google SecOps 警告的案件註解。
要同步的對話類型 CSV 回覆、附註 是 指定工作應同步的 Freshservice 對話類型。參數接受多個值，請以半形逗號分隔。
要擷取私人筆記嗎？ 核取方塊 未勾選核取方塊 (false) 否 啟用後，系統會擷取相關 Freshservice 支援單的公開和私人附註。
將 Siemplify 的註解同步為 X 字串 私人附註 是 指定工作應使用的對話類型，以便從 Google SecOps 新增註解。可能的值：私人附註、公開附註、回覆。

還有其他問題嗎？向社群成員和 Google SecOps 專家尋求解答。