Se usó la API de Cloud Translation para traducir esta página.

ConnectWise

Versión de integración: 17.0

Configura la integración de ConnectWise para que funcione con Google Security Operations

Configura claves públicas y privadas en ConnectWise Manage

Para crear una integración entre ConnectWise Manage y la integración de Google SecOps con ConnectWise Manage, debes proporcionar claves de API. Las claves de API son claves públicas y privadas que ConnectWise Manage genera para la cuenta de integración.

Para crear claves de API en ConnectWise Manage, sigue estos pasos:

En ConnectWise Manage, haz clic en System > Members y selecciona un miembro existente o crea uno nuevo. Asegúrate de que el miembro que seleccionaste tenga todos los derechos necesarios para configurar la integración.
En la pantalla Member Maintenance, haz clic en la pestaña API Keys y, luego, en New Item.
En el campo Descripción, ingresa la descripción de las claves recién creadas. Por ejemplo, Integración de Google SecOps.
Haz clic en Guardar para guardar el elemento nuevo.

Las dos claves de API se generan y se muestran en los campos Clave pública y Clave privada. La clave privada solo se muestra en el momento en que se crea.

Configura la integración de ConnectWise en Google SecOps

Si quieres obtener instrucciones detalladas para configurar una integración en Google SecOps, consulta Configura integraciones.

Parámetros de integración

Usa los siguientes parámetros para configurar la integración:

Nombre visible del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
Raíz de la API	String	https://{CompanyURL}/v4_6_Release/apis/3.0/	Sí	Es la dirección de la instancia de ConnectWise.
Nombre de la empresa	String	N/A	Sí
Clave pública	String	N/A	Sí
Clave privada	String	N/A	Sí
ID de cliente	String	N/A	Sí	ID de cliente de la aplicación de ConnectWise.

Acciones

Agregar comentario al ticket

Descripción

Agrega un comentario nuevo a un ticket en ConnectWise.

Parámetros

Nombre del parámetro	Tipo	Valor predeterminado		Descripción
ID del ticket	String	N/A	Sí	Es el ID del ticket de ConnectWise. Ejemplo: 608718
Comentario	String	N/A	Sí	Es el contenido del comentario que se adjuntará a un ticket.
Interno	Casilla de verificación	Desmarcado	Sí	Si se marca, el comentario se coloca en la sección interna.

Nombre del parámetro

Tipo

Valor predeterminado

Descripción

ID del ticket

String

N/A

Sí

Es el ID del ticket de ConnectWise.

Ejemplo: 608718

Comentario

String

N/A

Sí

Es el contenido del comentario que se adjuntará a un ticket.

Interno

Casilla de verificación

Desmarcado

Sí

Si se marca, el comentario se coloca en la sección interna.

Ejecutar en

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
ticket_id	N/A	N/A

Resultado de JSON

N/A

Cerrar ticket

Descripción

Cerrar un ticket de ConnectWise

Parámetros

Nombre del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
ID del ticket	String	N/A	Sí	Es el ID del ticket de ConnectWise. Ejemplo: 608718.
Estado de cierre personalizado	String	N/A	No	Si el sistema específico usa un estado cerrado personalizado, por ejemplo, Completado.

Nombre del parámetro

Tipo

Valor predeterminado

Es obligatorio

Descripción

ID del ticket

String

N/A

Sí

Es el ID del ticket de ConnectWise.

Ejemplo: 608718.

Estado de cierre personalizado

String

N/A

Si el sistema específico usa un estado cerrado personalizado, por ejemplo, Completado.

Ejecutar en

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Resultados de la secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
ticket_id	Verdadero/Falso	ticket_id:False

Resultado de JSON

N/A

Enriquecimiento de entidades

N/A

Estadísticas

N/A

Crea un ticket de alertas

Descripción

Crea un ticket de ConnectWise para cada alerta nueva de Google SecOps.

Parámetros

Nombre del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
Empresa	String	N/A	Sí	Nombre de la empresa.
Tablero	String	N/A	Sí	Nombre del tablero.
Estado	String	N/A	Sí	Ejemplo: Sin asignar
Prioridad	String	N/A	Sí	Ejemplo: Prioridad 3: Respuesta normal
Descripción inicial	String	N/A	Sí	N/A
Nombre del propietario	String	N/A	No	Nombre del miembro de ConnectWise al que se le asignará este ticket. Ejemplo: connectwise_user_1.

Ejecutar en

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
ticket_id	N/A	N/A

Resultado de JSON

N/A

Crear ticket

Descripción

Crea un ticket de ConnectWise.

Parámetros

Nombre del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
Empresa	String	N/A	Sí	Nombre de la empresa.
Tablero	String	N/A	Sí	Nombre de la pizarra
Resumen	String	N/A	Sí	N/A
Estado	String	N/A	Sí	p.ej., Sin asignar.
Prioridad	String	N/A	Sí	Ejemplo: Prioridad 3: Respuesta normal
Nombre del propietario	String	N/A	No	Nombre del miembro de ConnectWise al que se le asignará este ticket. Ejemplo: connectwise_user_1

Ejecutar en

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
ticket_id	Verdadero/Falso	ticket_id:False

Resultado de JSON

N/A

Borrar boleto

Descripción

Borra un ticket de ConnectWise por su ID.

Parámetros

Nombre del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
ID del ticket	String	N/A	Sí	Es el ID del ticket que se borrará. Ejemplo: 607167

Nombre del parámetro

Tipo

Valor predeterminado

Es obligatorio

Descripción

ID del ticket

String

N/A

Sí

Es el ID del ticket que se borrará.

Ejemplo: 607167

Ejecutar en

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
is_success	Verdadero/Falso	is_success:False

Resultado de JSON

N/A

Obtener entrada

Descripción

Obtén un ticket de ConnectWise por ID y adjunta el JSON del ticket como un archivo.

Parámetros

Nombre del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
ID del ticket	String	N/A	Sí	Recupera un ticket por ID.

Ejecutar en

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
ticket_json	N/A	N/A

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

Ping

Descripción

Prueba la conectividad.

Parámetros

N/A

Ejecutar en

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
is_success	Verdadero/Falso	is_success:False

Resultado de JSON

N/A

Actualizar entrada

Descripción

Actualiza los detalles del ticket en ConnectWise.

Parámetros

Nombre del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
Parámetro	Tipo	Valor predeterminado	Is Mandatory	Descripción
ID del ticket	String	N/A	Sí	Es el ID del ticket que se actualizará. Ejemplo: 609620
Resumen	String	N/A	No	Resumen actualizado.
Nombre del tipo	String	N/A	No	Ejemplo: Aplicación
Nombre del subtipo	String	N/A	No	Ejemplo: Adobe
Nombre del elemento	String	N/A	No	Ejemplo: Desarrollo
Estado	String	N/A	No	Es el estado nuevo del ticket. Ejemplo: `In Progress (plan of action)`

Ejecutar en

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
ticket_id	Verdadero/Falso	ticket_id:False

Resultado de JSON

N/A

Agregar archivo adjunto al ticket

Descripción

Agrega un archivo adjunto al ticket en ConnectWise.

Parámetros

Nombre de los parámetros	Tipo	Valor predeterminado	Es obligatorio	Descripción
ID del ticket	String	N/A	Sí	Especifica el ID del ticket al que se debería agregar el documento.
Archivo codificado en Base64	String	N/A	Sí	Especifica el archivo codificado en base64 que se debe agregar como adjunto.
Nombre del archivo	String	{filename}.{extension}	Sí	Especifica el nombre de archivo detrás del adjunto. Este valor también se usa como título. Nota: La acción debe proporcionar la extensión correcta para el archivo.
Mostrar en el portal de clientes	Casilla de verificación	Marcado	No	Si está habilitado, el adjunto se muestra en el portal del cliente.
Permitir solo la actualización del propietario	Casilla de verificación	Marcado	No	Si está habilitada, la acción solo permite que el propietario actualice el adjunto.

Ejecutar en

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Resultado de secuencia de comandos

Nombre del resultado de la secuencia de comandos	Opciones de valor	Ejemplo
is_success	Verdadero/Falso	is_success:False

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

Muro de casos

Tipo de resultado	Valor / Descripción	Tipo
Mensaje de salida*	La acción no debe fallar ni detener la ejecución de una guía: Si se informa el código de estado 201 (is_success=true): "Se agregó correctamente un archivo como adjunto al ticket {ticket_id} en ConnectWise". La acción debería fallar y detener la ejecución de la guía: Si se informa un error crítico: "Error al ejecutar la acción "Add Attachment To Ticket". Reason: {0}''.format(error.Stacktrace)." Si se informa el código de estado 400: "Error al ejecutar la acción "Add Attachment To Ticket". Motivo: {errors/message}."" Si se proporciona un formato de "Nombre de archivo" no válido, se mostrará el mensaje "Error al ejecutar la acción "Agregar adjunto al ticket"". Motivo: El valor de "Nombre de archivo" no sigue el formato necesario. Formato: {filename}.{extension}.""	General

Tipo de resultado

Valor / Descripción

Tipo

Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si se informa el código de estado 201 (is_success=true): "Se agregó correctamente un archivo como adjunto al ticket {ticket_id} en ConnectWise".

La acción debería fallar y detener la ejecución de la guía:

Si se informa un error crítico: "Error al ejecutar la acción "Add Attachment To Ticket". Reason: {0}''.format(error.Stacktrace)."

Si se informa el código de estado 400: "Error al ejecutar la acción "Add Attachment To Ticket". Motivo: {errors/message}.""

Si se proporciona un formato de "Nombre de archivo" no válido, se mostrará el mensaje "Error al ejecutar la acción "Agregar adjunto al ticket"". Motivo: El valor de "Nombre de archivo" no sigue el formato necesario. Formato: {filename}.{extension}.""

General

Trabajos

Sincroniza los tickets cerrados y descartados

Descripción

Sincroniza los tickets cerrados en ConnectWise y las alertas descartadas en Google SecOps.

Parámetros

Nombre del parámetro	Tipo	Valor predeterminado	Descripción
Raíz de la API	String	N/A	N/A
Nombre de la empresa	String	N/A	N/A
Clave pública de la API	String	N/A	N/A
Clave privada de la API	String	N/A	N/A
Nombre de la secuencia de comandos	String	N/A	N/A

Sincronizar comentarios

Descripción

Sincroniza los comentarios entre los casos de Google SecOps y los tickets de ConnectWise.

Parámetros

Nombre del parámetro	Tipo	Valor predeterminado	Descripción
Raíz de la API	String	https://<Nombre de host>/v4_6_Release/apis/3.0/	N/A
Nombre de la empresa	String	N/A	N/A
Clave pública de la API	String	N/A	N/A
Clave privada de la API	String	N/A	N/A
Nombre de la secuencia de comandos	String	N/A	N/A

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.