Esta página foi traduzida pela API Cloud Translation.

ConnectWise

Versão de integração: 17.0

Configure a integração do ConnectWise para funcionar com o Google Security Operations

Configure chaves públicas e privadas no ConnectWise Manage

Para criar uma integração entre o ConnectWise Manage e o Google SecOps, tem de fornecer chaves da API. As chaves de API são chaves públicas e privadas geradas pelo ConnectWise Manage para a conta de integração.

Para criar chaves da API no ConnectWise Manage:

No ConnectWise Manage, clique em System > Members e selecione um membro existente ou crie um novo. Certifique-se de que o membro que selecionou tem todos os direitos necessários para configurar a integração.
No ecrã Member Maintenance, clique no separador Chaves da API e, de seguida, clique em Novo item.
No campo Descrição, introduza a descrição das chaves criadas recentemente. Por exemplo, Integração do Google SecOps.
Clique em Guardar para guardar o novo item.

As duas chaves da API são geradas e apresentadas nos campos Chave pública e Chave privada. A chave privada é apresentada apenas no momento da criação.

Configure a integração do ConnectWise no Google SecOps

Para obter instruções detalhadas sobre como configurar uma integração no Google SecOps, consulte o artigo Configure integrações.

Parâmetros de integração

Use os seguintes parâmetros para configurar a integração:

Nome a apresentar do parâmetro	Tipo	Valor predefinido	É obrigatório	Descrição
Raiz da API	String	https://{CompanyURL}/v4_6_Release/apis/3.0/	Sim	Endereço da instância do ConnectWise.
Nome da empresa	String	N/A	Sim
Chave pública	String	N/A	Sim
Chave privada	String	N/A	Sim
ID do cliente	String	N/A	Sim	ID de cliente da aplicação ConnectWise.

Ações

Adicionar comentário ao pedido

Descrição

Adicione um novo comentário a um pedido de apoio técnico no ConnectWise.

Parâmetros

Nome do parâmetro	Tipo	Valor predefinido		Descrição
ID do pedido	String	N/A	Sim	ID do pedido do ConnectWise. Exemplo: 608718
Comentário	String	N/A	Sim	Conteúdo do comentário a anexar a um pedido.
Internos	Caixa de verificação	Desmarcado	Sim	Se estiver selecionada, coloca o comentário na secção interna.

Nome do parâmetro

Tipo

Valor predefinido

Descrição

ID do pedido

String

N/A

Sim

ID do pedido do ConnectWise.

Exemplo: 608718

Comentário

String

N/A

Sim

Conteúdo do comentário a anexar a um pedido.

Internos

Caixa de verificação

Desmarcado

Sim

Se estiver selecionada, coloca o comentário na secção interna.

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
ticket_id	N/A	N/A

Resultado JSON

N/A

Fechar pedido

Descrição

Feche um pedido do ConnectWise.

Parâmetros

Nome do parâmetro	Tipo	Valor predefinido	É obrigatório	Descrição
ID do pedido	String	N/A	Sim	ID do pedido do ConnectWise. Exemplo: 608718.
Estado de encerramento personalizado	String	N/A	Não	Se o sistema específico usar um estado fechado personalizado, por exemplo, Concluído.

Nome do parâmetro

Tipo

Valor predefinido

É obrigatório

Descrição

ID do pedido

String

N/A

Sim

ID do pedido do ConnectWise.

Exemplo: 608718.

Estado de encerramento personalizado

String

N/A

Não

Se o sistema específico usar um estado fechado personalizado, por exemplo, Concluído.

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Resultados do script

Nome do resultado do script	Opções de valor	Exemplo
ticket_id	Verdadeiro/Falso	ticket_id:False

Resultado JSON

N/A

Enriquecimento de entidades

N/A

Estatísticas

N/A

Crie um pedido de alertas

Descrição

Crie um pedido de apoio técnico do ConnectWise para cada novo alerta do Google SecOps.

Parâmetros

Nome do parâmetro	Tipo	Valor predefinido	É obrigatório	Descrição
Empresa	String	N/A	Sim	Nome da empresa.
Tabuleiro	String	N/A	Sim	Nome do quadro.
Estado	String	N/A	Sim	Exemplo: Unassigned
Prioridade	String	N/A	Sim	Exemplo: prioridade 3 – resposta normal
Descrição inicial	String	N/A	Sim	N/A
Nome do proprietário	String	N/A	Não	Nome do membro do ConnectWise ao qual atribuir este pedido. Exemplo: connectwise_user_1.

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
ticket_id	N/A	N/A

Resultado JSON

N/A

Criar pedido

Descrição

Crie um pedido do ConnectWise.

Parâmetros

Nome do parâmetro	Tipo	Valor predefinido	É obrigatório	Descrição
Empresa	String	N/A	Sim	Nome da empresa.
Tabuleiro	String	N/A	Sim	Nome do quadro
Resumo	String	N/A	Sim	N/A
Estado	String	N/A	Sim	Por exemplo, não atribuído.
Prioridade	String	N/A	Sim	Exemplo: prioridade 3 – resposta normal
Nome do proprietário	String	N/A	Não	Nome do membro do ConnectWise ao qual atribuir este pedido. Exemplo: connectwise_user_1

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
ticket_id	Verdadeiro/Falso	ticket_id:False

Resultado JSON

N/A

Elimine o pedido

Descrição

Elimine um pedido do ConnectWise pelo ID.

Parâmetros

Nome do parâmetro	Tipo	Valor predefinido	É obrigatório	Descrição
ID do pedido	String	N/A	Sim	O ID do pedido a eliminar. Exemplo: 607167

Nome do parâmetro

Tipo

Valor predefinido

É obrigatório

Descrição

ID do pedido

String

N/A

Sim

O ID do pedido a eliminar.

Exemplo: 607167

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_success	Verdadeiro/Falso	is_success:False

Resultado JSON

N/A

Comprar bilhete

Descrição

Obtenha um pedido do ConnectWise por ID e anexe o JSON do pedido como um ficheiro.

Parâmetros

Nome do parâmetro	Tipo	Valor predefinido	É obrigatório	Descrição
ID do pedido	String	N/A	Sim	Obter um pedido por ID.

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
ticket_json	N/A	N/A

Resultado 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": ""
            }
     }
}

Tchim-tchim

Descrição

Testar conetividade.

Parâmetros

N/A

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_success	Verdadeiro/Falso	is_success:False

Resultado JSON

N/A

Atualizar bilhete

Descrição

Atualize os detalhes do pedido no ConnectWise.

Parâmetros

Nome do parâmetro	Tipo	Valor predefinido	É obrigatório	Descrição
Parâmetro	Tipo	Valor predefinido	É obrigatório	Descrição
ID do pedido	String	N/A	Sim	O ID do pedido a atualizar. Exemplo: 609620
Resumo	String	N/A	Não	Resumo atualizado.
Introduza o nome	String	N/A	Não	Exemplo: aplicação
Nome do subtipo	String	N/A	Não	Exemplo: Adobe
Nome do item	String	N/A	Não	Exemplo: Desenvolvimento
Estado	String	N/A	Não	Novo estado do pedido. Exemplo: `In Progress (plan of action)`

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
ticket_id	Verdadeiro/Falso	ticket_id:False

Resultado JSON

N/A

Adicione um anexo ao pedido

Descrição

Adicione um anexo ao registo no ConnectWise.

Parâmetros

Nome dos parâmetros	Tipo	Valor predefinido	É obrigatório	Descrição
ID do pedido	String	N/A	Sim	Especifique o ID do pedido ao qual o documento tem de ser adicionado.
Ficheiro codificado em Base64	String	N/A	Sim	Especifique o ficheiro codificado em base64 que tem de ser adicionado como anexo.
Nome do ficheiro	String	{filename}.{extension}	Sim	Especifique o nome do ficheiro atrás do anexo. Este valor também é usado como título. Nota: a ação tem de fornecer a extensão correta para o ficheiro.
Apresentação no portal do cliente	Caixa de verificação	Marcado	Não	Se estiver ativada, o anexo é apresentado no portal do cliente.
Permitir atualização apenas do proprietário	Caixa de verificação	Marcado	Não	Se estiver ativada, a ação só permite que o proprietário atualize o anexo.

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_success	Verdadeiro/Falso	is_success:False

Resultado 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"
    }
}

Case Wall

Tipo de resultado	Valor / descrição	Tipo
Mensagem de saída*	A ação não deve falhar nem parar a execução de um guia interativo: Se for comunicado o código de estado 201 (is_success=true): "Successfully added a file as attachment to ticket {ticket_id} in ConnectWise." (Foi adicionado um ficheiro com êxito como anexo ao pedido {ticket_id} no ConnectWise.) A ação deve falhar e parar a execução de um guia interativo: Se for comunicado um erro crítico: "Erro ao executar a ação "Adicionar anexo ao pedido". Motivo: {0}''.format(error.Stacktrace)." Se for comunicado o código de estado 400: "Erro ao executar a ação "Adicionar anexo ao registo". Motivo: {errors/message}.'' Se for fornecido um formato de "Nome do ficheiro" inválido: "Erro ao executar a ação "Adicionar anexo ao pedido". Motivo: o valor "Filename" não segue o formato necessário. Formato: {filename}.{extension}.''	Geral

Tipo de resultado

Valor / descrição

Tipo

Mensagem de saída*

A ação não deve falhar nem parar a execução de um guia interativo:

Se for comunicado o código de estado 201 (is_success=true): "Successfully added a file as attachment to ticket {ticket_id} in ConnectWise." (Foi adicionado um ficheiro com êxito como anexo ao pedido {ticket_id} no ConnectWise.)

A ação deve falhar e parar a execução de um guia interativo:

Se for comunicado um erro crítico: "Erro ao executar a ação "Adicionar anexo ao pedido". Motivo: {0}''.format(error.Stacktrace)."

Se for comunicado o código de estado 400: "Erro ao executar a ação "Adicionar anexo ao registo". Motivo: {errors/message}.''

Se for fornecido um formato de "Nome do ficheiro" inválido: "Erro ao executar a ação "Adicionar anexo ao pedido". Motivo: o valor "Filename" não segue o formato necessário. Formato: {filename}.{extension}.''

Geral

Empregos

Sincronize pedidos fechados e ignorados

Descrição

Sincronize pedidos de apoio técnico fechados no ConnectWise e alertas ignorados no Google SecOps.

Parâmetros

Nome do parâmetro	Tipo	Valor predefinido	Descrição
Raiz da API	String	N/A	N/A
Nome da empresa	String	N/A	N/A
Chave pública da API	String	N/A	N/A
Chave privada da API	String	N/A	N/A
Nome do script	String	N/A	N/A

Sincronize os comentários

Descrição

Sincronize comentários entre registos do Google SecOps e pedidos do ConnectWise.

Parâmetros

Nome do parâmetro	Tipo	Valor predefinido	Descrição
Raiz da API	String	https://<Host Name>/v4_6_Release/apis/3.0/	N/A
Nome da empresa	String	N/A	N/A
Chave pública da API	String	N/A	N/A
Chave privada da API	String	N/A	N/A
Nome do script	String	N/A	N/A

Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais da Google SecOps.