Compartir a través de

Integrar un servicio preconfigurado agente en ServiceNow

  • Artículo

Puede integrar agentes de servicio preconfigurados directamente en el ServiceNow Escritorio con conocimiento contextual de la plataforma subyacente. Esta integración ayuda a la aplicación a proporcionar mejores respuestas y ayuda a agilizar aún más el flujo de trabajo para sus agentes.

Requisitos previos

Antes de comenzar, debe tener los siguientes entornos y consola:

  • Una instancia de Copilot para servicio conectada a un ServiceNow entorno.
  • Un entorno de producción o un entorno de prueba de ServiceNow.

Además, para que sus representantes servicio al cliente puedan utilizar agentes en ServiceNow, debe asignarles el rol agente. Para obtener información sobre cómo este rol a agentes, consulte Asignación de roles de seguridad a usuarios.

Paso 1: Copie la URL del widget Copilot para servicio

  1. Inicie sesión en su instancia de Copilot para servicio.
  2. En el mapa del sitio, seleccione Canales y luego seleccione ServiceNow.
  3. Copie la URL que comienza después de <iframe src=. Por ejemplo, https://copilotforservice-test.azureedge.net/widget/index.html?dynamicsUrl=https://XXXXXX.crm10.dynamics.com
  4. Guarde la URL localmente, donde podrá copiarla y pegarla en un paso posterior.

Paso 2: Instale el complemento API Knowledge

  1. En su entorno de ServiceNow, seleccione Todos, busque complementos y luego seleccione Definición del sistema>Complementos.
  2. Busque API Knowledge. El sistema debería devolver el complemento de API Knowledge (Id. de aplicación: sn_km_api).
  3. Seleccione la tarjeta API de conocimiento .
  4. Seleccione Instalar y, a continuación, seleccione la versión más reciente.
  5. Seleccione Instalar ahora y espere a que se complete la instalación de la API Knowledge.

Paso 3: Instale el complemento API Openframe

  1. En su entorno de ServiceNow, seleccione Todos, busque complementos y luego seleccione Definición del sistema>Complementos.
  2. Busque Openframe. El sistema debería devolver complemento openframe (ID del complemento: com.sn_openframe).
  3. Seleccione Instalar para iniciar la instalación del complemento.
  4. Seleccione Instalar y espere a que se complete la instalación.

Paso 4: Instale el complemento de Servicio al cliente

  1. En su entorno de ServiceNow, seleccione Todos, busque complementos y luego seleccione Definición del sistema>Complementos.
  2. Busque com.sn_customerservice. El sistema debería devolver Servicio al cliente (ID del complemento: com.sn_customerservice).
  3. Seleccione Instalar para iniciar la instalación del complemento.
  4. Seleccione Instalar y espere a que se complete la instalación.

Paso 5: Agregue la secuencia de comandos de la interfaz de usuario para el navegador del área de trabajo

  1. En su entorno de ServiceNow, asegúrese de estar en el área de trabajo Global: seleccione el icono del globo en la esquina superior derecha y luego verifique que el Alcance de la aplicación esté establecido en Global.
  2. Seleccione Todos y luego busque Scripts de UI y luego seleccione IU del Sistema>Scripts de IU.
  3. Seleccione Nuevo y, a continuación, rellene el formulario de la siguiente manera:
    • Nombre de API: Copilot abre el script del espacio de trabajo marco
    • Tipo de interfaz de usuario: Portal de servicios/móvil
    • Script: Copia el contenido del siguiente script:
 (function () {
  try {
    var logMoniker = "Copilot Navigator UI script: ";

    if (!globalThis.copilotNavigationWorkspaceListenerAdded) {
      console.log(logMoniker + "loading workspace navigator....");
      var payload = {
        url: globalThis.window.location.href,
        source: "workspaceUIScript",
        sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850",
        configType: "singleFrame"
      };
      var context = {
        payload: JSON.stringify(payload),
        method: "openframe_communication"
      };
      globalThis.CustomEvent.fireAll("openframe_request", context);

      globalThis.window.navigation.addEventListener("navigate", (event) => {
        console.log(
          logMoniker +
            "Workspace PAGE NAVIGATED: " +
            "\n Old Url: " +
            globalThis.window.location.href +
            "\n New url: " +
            event.destination.url
        );

        var payload = {
          url: event.destination.url,
          source: "workspaceUIScript",
          sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850",
          configType: "singleFrame"
        };
        var context = {
          payload: JSON.stringify(payload),
          method: "openframe_communication"
        };
        globalThis.CustomEvent.fireAll("openframe_request", context);
      });

      globalThis.copilotNavigationWorkspaceListenerAdded = true;
    } else {
      console.log(logMoniker + "Workspace navigator already loaded....");
    }
  } catch (error) {
    console.error(logMoniker + "Workspace Navigator error");
    console.error(error);
  }

  function initialiseScript() {
    // do nothing
  }

  return initialiseScript;
})();

Paso 6: agregue el script de interfaz de usuario para el navegador de interfaz de usuario clásico

  1. En su entorno de ServiceNow, asegúrese de estar en el área de trabajo Global: seleccione el icono del globo en la esquina superior derecha y luego verifique que el Alcance de la aplicación esté establecido en Global.
  2. Seleccione Todos y luego busque Scripts de UI y luego seleccione IU del Sistema>Scripts de IU.
  3. Seleccione Nuevo y, a continuación, rellene el formulario de la siguiente manera:
    • Nombre de API: Copilot abre el script marco Escritorio
    • Tipo de interfaz de usuario: Escritorio
    • Seleccione la casilla de verificación Global.
    • Script: Copia el contenido del siguiente script:
 (function () {
  try {
    var logMoniker = "Copilot Navigator UI script: ";
    if (
      !window.parent.navigationListenerAdded &&
      !window.copilotNavigationClassicListenerAdded
    ) {
      console.log(logMoniker + "loading desktop navigator....");
      var payload = {
        url: window.location.href,
        source: "classicUIScript",
        sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850",
        configType: "singleFrame"
      };
      var context = {
        payload: JSON.stringify(payload),
        method: "openframe_communication"
      };
      CustomEvent.fireAll("openframe_request", context);

      window.navigation.addEventListener("navigate", (event) => {
        console.log(
          logMoniker +
            "desktop PAGE NAVIGATED: " +
            "\n Old Url: " +
            window.location.href +
            "\n New url: " +
            event.destination.url
        );

        var payload = {
          url: event.destination.url,
          source: "classicUIScript",
          sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850",
          configType: "singleFrame"
        };
        var context = {
          payload: JSON.stringify(payload),
          method: "openframe_communication"
        };
        CustomEvent.fireAll("openframe_request", context);
      });

      window.copilotNavigationClassicListenerAdded = true;
    } else {
      console.log(logMoniker + "Skipping desktop navigator load....");
    }
  } catch (error) {
    console.log(logMoniker + "Classic UI navigator error");
    console.log(error);
  }
})();

Paso 7: agregar scripts de cliente para vincular tablas

  1. En su entorno de ServiceNow, asegúrese de estar en el área de trabajo Global: seleccione el icono del globo en la esquina superior derecha y luego verifique que el Alcance de la aplicación esté establecido en Global.
  2. Seleccione Todos y luego busque Scripts de cliente y luego seleccione Definición del sistema>Scripts de cliente.
  3. Seleccione Nuevo y, a continuación, rellene el formulario de la siguiente manera:
    • Nombre: Copilot abre el script de la tabla de incidentes marco
    • Tabla Incidente [incidente]
    • Tipo de interfaz de usuario: Escritorio
    • Tipo onLoad
    • Script: Copia el contenido del siguiente script:
 function onLoad() {
  try {
    var tableName = g_form.getTableName();
    var id = g_form.getUniqueValue();
    var payload = {
      recordId: id,
      objectType: tableName,
      source: "classicClientScript",
      sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850",
      configType: "singleFrame"
    };
    var context = {
      payload: JSON.stringify(payload),
      method: "openframe_communication"
    };
    CustomEvent.fireAll("openframe_request", context);
  } catch (error) {
    console.log(
      "Copilot Navigator UI script: CopilotClassicClientScriptCase navigator error"
    );
    console.log(error);
  }
}
  1. Seleccione Nuevo nuevamente y luego complete el formulario de la siguiente manera:
    • Nombre: Copilot abre el script de la tabla de correo electrónico marco
    • Tabla: Correo electrónico [sys_email]
    • Tipo de interfaz de usuario: Escritorio
    • Tipo onLoad
    • Script: Copia el contenido del siguiente script.
  function onLoad() {
  try {
    var tableName = g_form.getTableName();
    var id = g_form.getUniqueValue();
    var payload = {
      recordId: id,
      objectType: tableName,
      source: "classicClientScript",
      sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850",
      configType: "singleFrame"
    };
    var context = {
      payload: JSON.stringify(payload),
      method: "openframe_communication"
    };
    CustomEvent.fireAll("openframe_request", context);
  } catch (error) {
    console.log(
      "Copilot Navigator UI script: CopilotClassicClientScriptCase navigator error"
    );
    console.log(error);
  }
}
  1. Seleccione Nuevo nuevamente y luego complete el formulario de la siguiente manera:
    • Nombre: Copilot abre el script de la tabla de casos marco
    • Tabla: Caso [sn_customerservice_case]
    • Tipo de interfaz de usuario: Escritorio
    • Tipo onLoad
    • Script: Copia el contenido del siguiente script.
  function onLoad() {
  try {
    var tableName = g_form.getTableName();
    var id = g_form.getUniqueValue();
    var payload = {
      recordId: id,
      objectType: tableName,
      source: "classicClientScript",
      sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850",
      configType: "singleFrame"
    };
    var context = {
      payload: JSON.stringify(payload),
      method: "openframe_communication"
    };
    CustomEvent.fireAll("openframe_request", context);
  } catch (error) {
    console.log(
      "Copilot Navigator UI script: CopilotClassicClientScriptCase navigator error"
    );
    console.log(error);
  }
}
  1. Seleccione Nuevo nuevamente y luego complete el formulario de la siguiente manera:
    • Nombre: Copilot abre el script de la tabla de correo electrónico marco
    • Tabla: Correo electrónico [sys_email]
    • Tipo de interfaz de usuario: Escritorio
    • Tipo onLoad
    • Script: Copia el contenido del siguiente script:
 function onLoad() {
  try {
    var tableName = g_form.getTableName();
    var id = g_form.getUniqueValue();
    var payload = {
      recordId: id,
      objectType: tableName,
      source: "classicClientScript",
      sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850",
      configType: "singleFrame"
    };
    var context = {
      payload: JSON.stringify(payload),
      method: "openframe_communication"
    };
    CustomEvent.fireAll("openframe_request", context);
  } catch (error) {
    console.log(
      "Copilot Navigator UI script: CopilotClassicClientScriptCase navigator error"
    );
    console.log(error);
  }
}

Paso 8: Configurar un widget en ServiceNow

  1. En su entorno de ServiceNow, seleccione Todos, busque OpenFrame y luego seleccione OpenFrame>Configuraciones.
  2. En la esquina superior derecha, haga clic en Nuevo.
  3. Escriba Microsoft Copilot para el nombre y el título.
  4. Escriba 450 para el ancho y 600 para el alto.
  5. Seleccione los Grupos de usuarios para los que desea habilitar Copilot para servicio.
  6. Seleccione el ícono de candado al lado del campo URL para desbloquearlo y luego pegue la URL del widget Copilot para servicio que guardó anteriormente desde la página de administración de Copilot para servicio.
  7. Seleccione Enviar.
  8. Actualice la página. El widget Copilot para servicio debería estar disponible en la barra de navegación superior para el ícono que seleccionó.
  9. Antes de abrir Copilot para servicio, asegúrese de haber permitido desde su página las ventanas emergentes de ServiceNow.