Esta página se ha traducido con Cloud Translation API.

ConnectWise

Versión de integración: 17.0

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

Configurar claves públicas y privadas en ConnectWise Manage

Para crear una integración entre ConnectWise Manage y Google SecOps, debe proporcionar claves de API. Las claves de API son claves públicas y privadas que genera ConnectWise Manage 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 (Sistema > Miembros) y selecciona un miembro o crea uno. Asegúrate de que el miembro que has seleccionado tiene todos los derechos necesarios para configurar la integración.
En la pantalla Mantenimiento de miembros, haga clic en la pestaña Claves de API y, a continuación, en Nuevo elemento.
En el campo Description (Descripción), introduce la descripción de las claves que acabas de crear. Por ejemplo, Integración de Google SecOps.
Haga clic en Guardar para guardar el nuevo elemento.

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.

Configurar la integración de ConnectWise en Google SecOps

Para obtener instrucciones detalladas sobre cómo configurar una integración en Google SecOps, consulta Configurar 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	Cadena	https://{CompanyURL}/v4_6_Release/apis/3.0/	Sí	Dirección de la instancia de ConnectWise.
Nombre de la empresa	Cadena	N/A	Sí
Clave pública	Cadena	N/A	Sí
Clave privada	Cadena	N/A	Sí
ID de cliente	Cadena	N/A	Sí	ID de cliente de la aplicación ConnectWise.

Acciones

Añadir comentario a la entrada

Descripción

Añade un comentario a una incidencia en ConnectWise.

Parámetros

Nombre del parámetro	Tipo	Valor predeterminado		Descripción
ID de incidencia	Cadena	N/A	Sí	ID de incidencia de ConnectWise. Ejemplo: 608718
Comentario	Cadena	N/A	Sí	Contenido del comentario que se adjuntará a la incidencia.
Interno	Casilla	Desmarcada	Sí	Si está marcada, coloca el comentario en la sección interna.

Nombre del parámetro

Tipo

Valor predeterminado

Descripción

ID de incidencia

Cadena

N/A

Sí

ID de incidencia de ConnectWise.

Ejemplo: 608718

Comentario

Cadena

N/A

Sí

Contenido del comentario que se adjuntará a la incidencia.

Interno

Casilla

Desmarcada

Sí

Si está marcada, coloca el comentario en la sección interna.

Fecha de ejecución

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 incidencia

Descripción

Cerrar una incidencia de ConnectWise.

Parámetros

Nombre del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
ID de incidencia	Cadena	N/A	Sí	ID de incidencia de ConnectWise. Ejemplo: 608718.
Estado de cierre personalizado	Cadena	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 de incidencia

Cadena

N/A

Sí

ID de incidencia de ConnectWise.

Ejemplo: 608718.

Estado de cierre personalizado

Cadena

N/A

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

Fecha de ejecución

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Resultados 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

Enriquecimiento de entidades

N/A

Estadísticas

N/A

Crear incidencia de alertas

Descripción

Crea una incidencia de ConnectWise por cada alerta nueva de Google SecOps.

Parámetros

Nombre del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
Empresa	Cadena	N/A	Sí	Nombre de la empresa.
Tablero	Cadena	N/A	Sí	Nombre de la pizarra.
Estado	Cadena	N/A	Sí	Ejemplo: Sin asignar
Prioridad	Cadena	N/A	Sí	Ejemplo: Prioridad 3 - Respuesta normal
Descripción inicial	Cadena	N/A	Sí	N/A
Nombre del propietario	Cadena	N/A	No	Nombre del miembro de ConnectWise al que se asignará esta incidencia. Por ejemplo: connectwise_user_1.

Fecha de ejecución

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 incidencia

Descripción

Crea una incidencia de ConnectWise.

Parámetros

Nombre del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
Empresa	Cadena	N/A	Sí	Nombre de la empresa.
Tablero	Cadena	N/A	Sí	Nombre de la pizarra
Resumen	Cadena	N/A	Sí	N/A
Estado	Cadena	N/A	Sí	Por ejemplo, "Sin asignar".
Prioridad	Cadena	N/A	Sí	Ejemplo: Prioridad 3 - Respuesta normal
Nombre del propietario	Cadena	N/A	No	Nombre del miembro de ConnectWise al que se asignará esta incidencia. Ejemplo: connectwise_user_1

Fecha de ejecución

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

Eliminar billete

Descripción

Elimina un ticket de ConnectWise por su ID.

Parámetros

Nombre del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
ID de incidencia	Cadena	N/A	Sí	ID de la incidencia que se va a eliminar. Ejemplo: 607167

Nombre del parámetro

Tipo

Valor predeterminado

Es obligatorio

Descripción

ID de incidencia

Cadena

N/A

Sí

ID de la incidencia que se va a eliminar.

Ejemplo: 607167

Fecha de ejecución

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

Comprar entrada

Descripción

Obtiene 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 de incidencia	Cadena	N/A	Sí	Obtener una incidencia por ID.

Fecha de ejecución

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 de conectividad.

Parámetros

N/A

Fecha de ejecución

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 de la incidencia en ConnectWise.

Parámetros

Nombre del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
Parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
ID de incidencia	Cadena	N/A	Sí	El ID del ticket que se va a actualizar. Ejemplo: 609620
Resumen	Cadena	N/A	No	Resumen actualizado.
Escribe un nombre	Cadena	N/A	No	Ejemplo: Aplicación
Nombre de subtipo	Cadena	N/A	No	Ejemplo: Adobe
Nombre del elemento	Cadena	N/A	No	Ejemplo: Desarrollo
Estado	Cadena	N/A	No	Nuevo estado de la incidencia. Ejemplo: `In Progress (plan of action)`

Fecha de ejecución

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

Añadir archivo adjunto a la incidencia

Descripción

Añade un archivo adjunto a la incidencia en ConnectWise.

Parámetros

Nombre del parámetro	Tipo	Valor predeterminado	Es obligatorio	Descripción
ID de incidencia	Cadena	N/A	Sí	Especifica el ID de la incidencia a la que se debe añadir el documento.
Archivo codificado en Base64	Cadena	N/A	Sí	Especifica el archivo codificado en Base64 que se debe añadir como archivo adjunto.
Nombre del archivo	Cadena	{filename}.{extension}	Sí	Especifica el nombre del archivo adjunto. Este valor también se usa como título. Nota: La acción debe proporcionar la extensión correcta del archivo.
Mostrar en el portal para clientes	Casilla	Marcada	No	Si se habilita, el archivo adjunto se muestra en el portal para clientes.
Permitir que solo el propietario actualice	Casilla	Marcada	No	Si está habilitada, la acción solo permite que el propietario actualice el archivo adjunto.

Fecha de ejecución

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

Panel 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 devuelve el código de estado 201 (is_success=true): "Se ha añadido correctamente un archivo como adjunto a la incidencia {ticket_id} en ConnectWise." La acción debería fallar y detener la ejecución de la guía: Si se informa de un error crítico: "Error al ejecutar la acción "Añadir archivo adjunto a la incidencia". Motivo: {0}''.format(error.Stacktrace)." Si se devuelve el código de estado 400: "Error al ejecutar la acción "Añadir archivo adjunto a la incidencia". Motivo: {errors/message}.'' Si se proporciona un formato de "Nombre de archivo" no válido: "Error al ejecutar la acción "Añadir archivo adjunto a la incidencia". Motivo: el valor de "Filename" 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 devuelve el código de estado 201 (is_success=true): "Se ha añadido correctamente un archivo como adjunto a la incidencia {ticket_id} en ConnectWise."

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

Si se informa de un error crítico: "Error al ejecutar la acción "Añadir archivo adjunto a la incidencia". Motivo: {0}''.format(error.Stacktrace)."

Si se devuelve el código de estado 400: "Error al ejecutar la acción "Añadir archivo adjunto a la incidencia". Motivo: {errors/message}.''

Si se proporciona un formato de "Nombre de archivo" no válido: "Error al ejecutar la acción "Añadir archivo adjunto a la incidencia". Motivo: el valor de "Filename" no sigue el formato necesario. Formato: {filename}.{extension}.''

General

Empleo

Sincronizar incidencias cerradas y rechazadas

Descripción

Sincroniza las incidencias cerradas 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	Cadena	N/A	N/A
Nombre de la empresa	Cadena	N/A	N/A
Clave pública de la API	Cadena	N/A	N/A
Clave privada de la API	Cadena	N/A	N/A
Nombre del script	Cadena	N/A	N/A

Sincronizar comentarios

Descripción

Sincronizar 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	Cadena	https://<Nombre de host>/v4_6_Release/apis/3.0/	N/A
Nombre de la empresa	Cadena	N/A	N/A
Clave pública de la API	Cadena	N/A	N/A
Clave privada de la API	Cadena	N/A	N/A
Nombre del script	Cadena	N/A	N/A

¿Necesitas más ayuda? Recibe respuestas de los miembros de la comunidad y de los profesionales de Google SecOps.