Freshworks Freshservice

整合版本：14.0

應用實例

與服務台整合。

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 Security Operations Marketplace 分頁的整合設定頁面中，使用提供的參數測試與 Freshservice 執行個體的連線。

執行時間

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

動作執行結果

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

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

  • 如果成功：「Successfully connected to the Freshservice instance with the provided connection parameters!」(已使用提供的連線參數，成功連線至 Freshservice 執行個體！)

動作應會失敗並停止劇本執行：如果發生重大錯誤，例如憑證錯誤或連線中斷：「Failed to connect to the Freshservice instance! Error is {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.」(已成功擷取 Freshservice 支援單。)
  • 如果未傳回任何票券 (is_success = false)：「No tickets were found for the provided input parameters.」(找不到符合所提供輸入參數的票券)。
  • 如果取得票證時發生 API 錯誤 (is_success = false)：「無法使用提供的輸入參數列出票證。錯誤為：{error from the API}」

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

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

 一般
資料表

表格名稱：Freshservice Tickets Found

資料表資料欄：

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)：
    「Successfully fetched Freshservice ticket <ticket id> conversations.」
  • 如果未傳回任何支援單對話 (is_success = false)：
    「No ticket conversations were found for the ticket<ticket id >」(找不到支援單<支援單 ID> 的對話)
  • 如果找不到提供的支援單 ID (is_success = false)：
    「Ticket <ticket id> was not found in Freshservice.
  • 如果取得票證時發生 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)：

    • 支援單 <支援單 ID> 已新增回覆。

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

    • 「在 Freshservice 中找不到工單 <工單 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)：

    • 已將新的 <note type>附註新增至工單 <ticket id>。

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

    • 「在 Freshservice 中找不到工單 <工單 ID>。

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

如果發生嚴重錯誤、SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「Error executing action "Add a Ticket Note". 原因：{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.」(已成功擷取 Freshservice 代理商)。
  • 如果沒有傳回任何代理程式 (is_success = false)：「找不到符合所提供輸入參數的代理程式。」
  • 如果取得代理程式時發生 API 錯誤 (is_success = false)：「Failed to list agents with the provided input parameters. 錯誤為：{error from the API}」

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

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

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

 一般

表格

表格名稱：Freshservice Agents Found

資料表資料欄：

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.」(已成功擷取 Freshservice 註冊要求者)。
  • 如果沒有傳回任何要求者 (is_success = false)：
    「No requesters were found for the provided input parameters.」
  • 如果取得要求者時發生 API 錯誤 (is_success = false)：「無法使用提供的輸入參數列出要求者。錯誤為：{error from the API}」

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

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

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

 一般

表格

表格名稱：Freshservice Requester Found

資料表資料欄：

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>。

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

如果發生致命錯誤或 SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「執行『更新要求者』動作時發生錯誤。原因：{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)：
    「Successfully fetched Freshservice ticket<ticket id > time entries.」(已成功擷取 Freshservice 票證<票證 ID> 的時間記錄。)
  • 如果未傳回任何票證時間項目 (is_success = false)：
    「找不到票證 <票證 ID> 的任何票證時間項目」
  • 如果找不到提供的支援單 ID (is_success = false)：
    「Ticket <ticket id> was not found in Freshservice.
  • 如果系統找不到所提供代理商電子郵件的代理商 ID (is_success = false)：
    「Agent <agent_email> was not found in Freshservice.
  • 如果擷取票證時間記錄時發生 API 錯誤 (is_success = false)：「Failed to list ticket time entries with the provided input parameters. 錯誤為：{error from the API}」

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

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

「執行動作『List Ticket Time Entries』時發生錯誤。原因：{0}''.format(error.Stacktrace)

 一般
資料表

資料表名稱：Freshservice 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)：

    • 已將新的時間記錄新增至支援單 <支援單 ID>。

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

    • 「在 Freshservice 中找不到工單 <工單 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 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「Error executing action "Update Ticket Time Entry". 原因：{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)：

    • 「Provided ticket id <ticket_id> or time entry id <time_entry id> was not found in Freshservice

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

如果發生嚴重錯誤或 SDK 錯誤 (例如憑證錯誤、無法連線至伺服器等)：「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 Security Operations SOAR 警報已關閉，請關閉 Freshservice 中的案件。

參數

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

Freshservice Sync Tickets Conversations Job

說明

在 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 專業人員尋求答案。