本頁面由 Cloud Translation API 翻譯而成。

ConnectWise

整合版本：17.0

設定 ConnectWise 整合功能，以便與 Google Security Operations 搭配使用

在 ConnectWise Manage 中設定公開和私密金鑰

如要在 ConnectWise Manage 與 Google SecOps 之間建立整合，您需要提供 API 金鑰。API 金鑰是由 ConnectWise Manage 為整合帳戶產生的公開和私密金鑰。

如要在 ConnectWise Manage 中建立 API 金鑰，請按照下列步驟操作：

在 ConnectWise Manage 中，依序點選「System」>「Members」，然後選取現有成員或建立新成員。請確認所選成員具備設定整合功能的所有必要權利。
在「Member Maintenance」(成員維護) 畫面中，按一下「API Keys」(API 金鑰) 分頁標籤，然後按一下「New Item」(新增項目)。
在「Description」(說明) 欄位中，輸入新建立金鑰的說明。例如「Google SecOps Integration」。
按一下「儲存」即可儲存新項目。

系統會產生這兩組 API 金鑰，並顯示在「公開金鑰」和「私密金鑰」欄位中。私密金鑰只會在建立時顯示。

在 Google SecOps 中設定 ConnectWise 整合

如需在 Google SecOps 中設定整合功能的詳細操作說明，請參閱「設定整合功能」。

整合參數

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

參數顯示名稱	類型	預設值	為必填項目	說明
API 根目錄	字串	https://{CompanyURL}/v4_6_Release/apis/3.0/	是	ConnectWise 執行個體的地址。
公司名稱	字串	不適用	是
公開金鑰	字串	不適用	是
私密金鑰	字串	不適用	是
用戶端 ID	字串	不適用	是	ConnectWise 應用程式的用戶端 ID。

動作

為支援單新增留言

說明

在 ConnectWise 的支援單中新增註解。

參數

參數名稱	類型	預設值		說明
支援單 ID	字串	不適用	是	ConnectWise 支援單 ID。範例：608718
註解	字串	不適用	是	要附加至支援單的留言內容。
內部	核取方塊	已取消勾選	是	如果勾選，註解會放在內部區段。

參數名稱

類型

預設值

說明

支援單 ID

字串

不適用

是

ConnectWise 支援單 ID。

範例：608718

註解

字串

不適用

是

要附加至支援單的留言內容。

內部

核取方塊

已取消勾選

是

如果勾選，註解會放在內部區段。

執行時間

這項操作會對所有實體執行。

動作執行結果

指令碼執行結果

指令碼結果名稱	價值選項	示例
ticket_id	不適用	不適用

JSON 結果

N/A

關閉支援單

說明

關閉 ConnectWise 支援單。

參數

參數名稱	類型	預設值	為必填項目	說明
支援單 ID	字串	不適用	是	ConnectWise 支援單 ID。例如：608718。
自訂結案狀態	字串	不適用	否	如果特定系統使用自訂結案狀態，例如「已完成」。

參數名稱

類型

預設值

為必填項目

說明

支援單 ID

字串

不適用

是

ConnectWise 支援單 ID。

例如：608718。

自訂結案狀態

字串

不適用

否

如果特定系統使用自訂結案狀態，例如「已完成」。

執行時間

這項操作會對所有實體執行。

動作執行結果

指令碼執行結果

指令碼結果名稱	價值選項	示例
ticket_id	True/False	ticket_id:False

JSON 結果

N/A

實體擴充

不適用

深入分析

不適用

建立快訊支援單

說明

為每則新的 Google SecOps 快訊建立 ConnectWise 支援單。

參數

參數名稱	類型	預設值	為必填項目	說明
公司	字串	不適用	是	公司名稱。
主面板	字串	不適用	是	Jamboard 名稱。
狀態	字串	不適用	是	示例：未指派
優先順序	字串	不適用	是	範例：優先順序 3 - 一般回應
初始說明	字串	不適用	是	不適用
擁有者名稱	字串	不適用	否	要將這張單指派給的 ConnectWise 成員名稱。例如：connectwise_user_1。

執行時間

這項操作會對所有實體執行。

動作執行結果

指令碼執行結果

指令碼結果名稱	價值選項	示例
ticket_id	不適用	不適用

JSON 結果

N/A

建立支援單

說明

建立 ConnectWise 支援單。

參數

參數名稱	類型	預設值	為必填項目	說明
公司	字串	不適用	是	公司名稱。
主面板	字串	不適用	是	Jamboard 名稱
摘要	字串	不適用	是	不適用
狀態	字串	不適用	是	例如「未指派」。
優先順序	字串	不適用	是	範例：優先順序 3 - 一般回應
擁有者名稱	字串	不適用	否	要將這張單指派給的 ConnectWise 成員名稱。範例：connectwise_user_1

執行時間

這項操作會對所有實體執行。

動作執行結果

指令碼執行結果

指令碼結果名稱	價值選項	示例
ticket_id	True/False	ticket_id:False

JSON 結果

N/A

刪除票卡

說明

依 ID 刪除 ConnectWise 支援單。

參數

參數名稱	類型	預設值	為必填項目	說明
支援單 ID	字串	不適用	是	要刪除的票券 ID。範例：607167

參數名稱

類型

預設值

為必填項目

說明

支援單 ID

字串

不適用

是

要刪除的票券 ID。

範例：607167

執行時間

這項操作會對所有實體執行。

動作執行結果

指令碼執行結果

指令碼結果名稱	價值選項	示例
is_success	True/False	is_success:False

JSON 結果

N/A

取得門票

說明

依 ID 取得 ConnectWise 支援單，並將支援單 JSON 檔案附加為檔案。

參數

參數名稱	類型	預設值	為必填項目	說明
支援單 ID	字串	不適用	是	依 ID 擷取票證。

執行時間

這項操作會對所有實體執行。

動作執行結果

指令碼執行結果

指令碼結果名稱	價值選項	示例
ticket_json	不適用	不適用

JSON 結果

{
  "773256":
   {
     "customerUpdatedFlag": false,
     "estimatedTimeCost": 0.0,
     "recordType": "ServiceTicket",
     "siteName": "Main",
     "billTime": "NoDefault",
     "site":
       {
         "_info":
           {
             "site_href": "",
             "mobileGuid": "c5e7be2e-af3b-461f-a637-1b3e7e24bdc6"
           },
         "id": 23188, "name": "Main"
        },
     "currency":
       {
         "symbol": "$",
         "isoCode": "USD",
         "_info": {
                   "currency_href": ""
                   },
         "name": "US Dollars", "id": 7
        },
     "estimatedProductCost": 0.0,
     "estimatedExpenseRevenue": 0.0,
     "contactName": "user name",
     "addressLine1": "110 Fifth Avenue ",
     "billingMethod": "ActualRates",
     "id": 773256,
     "impact": "Medium",
     "city": "New York",
     "billProducts": "NoDefault",
     "businessUnitId": 20,
     "zip": "10011",
     "estimatedExpenseCost": 0.0,
     "mobileGuid": "f7b5a0eb-6038-4e14-a661-05c393917841",
     "closedFlag": false,
     "enteredBy": "Siemplify",
     "priority":
        {
          "sort": 6,
          "_info":
             {
               "image_href": "",
               "priority_href": ""
             },
          "id": 4,
          "name": "Priority 3 - Normal Response"
         },
     "source":
         {
           "_info":
             {
                "source_href": ""
              },
           "id": 2,
           "name": "Customer Phone Call"
          },
      "automaticEmailCcFlag": false,
      "board":
         {
           "_info":
             {
                "board_href": ""
             },
          "id": 70,
          "name": "Siemplify - T&M"
          },
     "customFields":
        [{
           "numberOfDecimals": 0,
           "caption": "2nd Shift",
           "type": "Checkbox",
           "id": 20,
           "entryMethod": "EntryField"
         },
         {
            "numberOfDecimals": 0,
            "caption": "3rd Shift",
            "type": "Checkbox",
            "id": 21,
            "entryMethod": "EntryField"
           },
          {
            "numberOfDecimals": 0,
            "caption": "Huddle Rvw",
            "type": "Checkbox",
            "id": 22,
            "entryMethod": "EntryField"
           }],
     "contactEmailAddress": "john_doe@example.com",
     "Status":
          {
            "_info": {"status_href": ""},
            "id": 1351,
            "name": "Unassigned"
           },
     "contactPhoneNumber": "(800) 555‑0175",
     "dateResponded": "2019-01-17T09:21:03Z",
     "isInSla": false,
     "company":
           {
             "_info":
                 {"mobileGuid": "42fcabed-a0f6-4171-bd7a-ca563ba45f7c",
                  "company_href": ""},
             "identifier": "Siemplify",
             "id": 18304,
             "name": "Siemplify"
           },
     "automaticEmailContactFlag": false,
     "hasChildTicket": false,
     "billExpenses": "NoDefault",
     "estimatedTimeRevenue": 0.0,
     "locationId": 119,
     "estimatedProductRevenue": 0.0,
     "automaticEmailResourceFlag": false,
     "dateEntered": "2019-01-17T09:21:03Z",
     "approved": true,
     "severity": "Medium",
     "resolveMinutes": 0,
     "serviceLocation":
           {
              "_info":
                   {"location_href": ""},
              "id": 6,
              "name": "Remote"
            },
     "resPlanMinutes": 0,
     "stateIdentifier": "NY",
     "dateResplan": "2019-01-17T09:21:03Z",
     "subBillingMethod": "ActualRates",
     "Country":
           {
              "_info":
                   {"country_href": ""},
              "id": 1,
              "name": "United States"
            },
     "respondMinutes": 0,
     "allowAllClientsPortalView": false,
     "hasMergedChildTicketFlag": false,
     "summary": "TikcetApiTest",
     "contact":
           {
             "_info":
                  {"contact_href": "",
                   "mobileGuid": "c86377ec-7726-4057-aca2-e992b550140f"
                  },
            "id": 59249,
            "name": "user name"
            },
     "team":
           {
             "_info":
                  {"team_href": ""},
             "id": 78,
             "name": "Siemplify"
           },
     "addressLine2": "5th Floor",
     "_info":
           {
             "configurations_href": "",
             "tasks_href": "",
             "updatedBy": "Siemplify",
             "expenseEntries_href": "",
             "lastUpdated": "2019-01-17T09:21:03Z",
             "products_href": "",
             "activities_href": "",
             "Timeentries_href":"",
             "notes_href": "",
             "documents_href": "",
             "scheduleentries_href": ""
            }
     }
}

乒乓

說明

測試連線。

參數

不適用

執行時間

這項操作會對所有實體執行。

動作執行結果

指令碼執行結果

指令碼結果名稱	價值選項	示例
is_success	True/False	is_success:False

JSON 結果

N/A

更新票券

說明

在 ConnectWise 中更新支援單詳細資料。

參數

參數名稱	類型	預設值	為必填項目	說明
參數	類型	預設值	是否為必要項目	說明
支援單 ID	字串	不適用	是	要更新的票證 ID。範例：609620
摘要	字串	不適用	否	更新後的摘要。
類型名稱	字串	不適用	否	範例：應用程式
子類型名稱	字串	不適用	否	示例：Adobe
項目名稱	字串	不適用	否	範例：開發
狀態	字串	不適用	否	新支援單狀態。範例：`In Progress (plan of action)`

執行時間

這項操作會對所有實體執行。

動作執行結果

指令碼執行結果

指令碼結果名稱	價值選項	示例
ticket_id	True/False	ticket_id:False

JSON 結果

N/A

在工單中新增附件

說明

在 ConnectWise 中將附件新增至支援單。

參數

參數名稱	類型	預設值	為必填項目	說明
支援單 ID	字串	不適用	是	指定要新增文件的工單 ID。
Base64 編碼檔案	字串	不適用	是	指定要以附件形式新增的 base64 編碼檔案。
檔案名稱	字串	{filename}.{extension}	是	在附件後方指定檔案名稱。這個值也會做為標題。注意：動作必須提供正確的檔案副檔名。
在客戶入口網站中顯示	核取方塊	已勾選	否	啟用後，附件就會顯示在客戶入口網站中。
僅允許擁有者更新	核取方塊	已勾選	否	啟用後，只有擁有者可以更新附件。

執行時間

這項操作會對所有實體執行。

動作執行結果

指令碼執行結果

指令碼結果名稱	價值選項	示例
is_success	True/False	is_success:False

JSON 結果

{
    "id": 280,
    "title": "QWEqqqq",
    "fileName": "s.json",
    "serverFileName": "24e7db8d-41b5-4bd0-9db3-a60d46143afe.json",
    "owner": "Admin1",
    "linkFlag": false,
    "imageFlag": false,
    "publicFlag": false,
    "htmlTemplateFlag": false,
    "readOnlyFlag": true,
    "size": 22131,
    "urlFlag": false,
    "guid": "b9fc3fc6-f368-40bb-bc06-233f4d6a299c",
    "_info": {
        "lastUpdated": "2022-05-10T14:02:23Z",
        "updatedBy": "Admin1"
    }
}

案件總覽

結果類型	值 / 說明	類型
輸出訊息*	動作不應失敗，也不應停止執行應對手冊：如果系統回報 201 狀態碼 (is_success=true)：「Successfully added a file as attachment to ticket {ticket_id} in ConnectWise.」(已成功將檔案附加至 ConnectWise 中的案件 {ticket_id}。) 動作應會失敗並停止執行應對手冊：如果系統回報重大錯誤：「Error executing action "Add Attachment To Ticket"」。原因：{0}''.format(error.Stacktrace)." 如果系統回報 400 狀態代碼：「Error executing action "Add Attachment To Ticket". 原因：{errors/message}。如果提供的「檔案名稱」格式無效：「執行動作『將附件新增至工單』時發生錯誤。原因：「Filename」值不符合必要格式。格式：{filename}.{extension}.''	一般

結果類型

值 / 說明

類型

輸出訊息*

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

如果系統回報 201 狀態碼 (is_success=true)： 「Successfully added a file as attachment to ticket {ticket_id} in ConnectWise.」(已成功將檔案附加至 ConnectWise 中的案件 {ticket_id}。)

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

如果系統回報重大錯誤： 「Error executing action "Add Attachment To Ticket"」。原因：{0}''.format(error.Stacktrace)."

如果系統回報 400 狀態代碼：「Error executing action "Add Attachment To Ticket". 原因：{errors/message}。

如果提供的「檔案名稱」格式無效：「執行動作『將附件新增至工單』時發生錯誤。原因：「Filename」值不符合必要格式。格式：{filename}.{extension}.''

一般

工作

同步處理已結案和已關閉的支援單

說明

同步處理 ConnectWise 中已結案的支援單，以及 Google SecOps 中已解除的快訊。

參數

參數名稱	類型	預設值	說明
API 根層級	字串	不適用	不適用
公司名稱	字串	不適用	不適用
API 公開金鑰	字串	不適用	不適用
API 私密金鑰	字串	不適用	不適用
指令碼名稱	字串	不適用	不適用

同步處理留言

說明

在 Google SecOps 案件和 ConnectWise 支援單之間同步處理留言。

參數

參數名稱	類型	預設值	說明
API 根層級	字串	https://<主機名稱>/v4_6_Release/apis/3.0/	不適用
公司名稱	字串	不適用	不適用
API 公開金鑰	字串	不適用	不適用
API 私密金鑰	字串	不適用	不適用
指令碼名稱	字串	不適用	不適用

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