Compartir a través de


Conector de Microsoft 365 Copilot del Centro de ayuda de Zendesk (versión preliminar)

El conector de Microsoft 365 Copilot del Centro de ayuda de Zendesk permite a su organización indexar artículos del Centro de ayuda de Zendesk (también conocido como Guía de Zendesk). Después de configurar el conector, los usuarios finales pueden buscar estos artículos en Zendesk en Microsoft Copilot y desde cualquier cliente de Microsoft Search.

Este artículo está destinado a administradores de Microsoft 365 o a cualquier persona que configure, ejecute y supervise un conector copilot del Centro de ayuda de Zendesk.

Nota:

El conector Zendesk Help Copilot está en versión preliminar pública. Si desea obtener acceso para probarlo, debe habilitar el anillo de versión dirigida para su cuenta de Administración.

Capacidades

  • Artículos del Centro de ayuda de Índices
  • Permitir que los usuarios finales hagan preguntas relacionadas con las consultas de soporte técnico o la información del producto en Copilot.
    • ¿Cuál es la política de devolución de prendas de vestir?
    • ¿Cuáles son las especificaciones del producto para el portátil Surface?
    • ¿Cómo puedo actualizar mi suscripción?
  • Use la búsqueda semántica en Copilot para permitir a los usuarios encontrar contenido relevante basado en palabras clave, preferencias personales y conexiones sociales.

Limitaciones

  • No indexa las publicaciones y los temas de zendesk Guide Community.
  • No indexa los datos adjuntos.

Requisitos previos

  • Debe ser el administrador de búsqueda del inquilino de Microsoft 365 de su organización.
  • Dirección URL de la instancia de Zendesk: para conectarse a los datos del Centro de ayuda de Zendesk, necesita la dirección URL de la instancia del Centro de ayuda de Zendesk de su organización. La dirección URL de la instancia del Centro de ayuda de Zendesk de su organización suele ser similar https://<your-organization-domain>.zendesk.coma . Si aún no tiene una instancia, consulte el artículo para obtener información sobre cómo crear una instancia de prueba.
  • Cuenta de servicio: para conectarse al Centro de ayuda de Zendesk y permitir que copilot onnector actualice los artículos de conocimientos con regularidad, necesita una cuenta de servicio con permisos de lectura concedidos a la cuenta de servicio. La cuenta de servicio debe tener el rol "Administración", "Agente" o "Agente ligero". El rol "Colaborador" no permite leer permisos en Zendesk.

Introducción

1. Nombre para mostrar

Se usa un nombre para mostrar para identificar cada cita en Copilot, lo que ayuda a los usuarios a reconocer fácilmente el archivo o elemento asociado. El nombre para mostrar también significa contenido de confianza. El nombre para mostrar también se usa como filtro de origen de contenido. Hay un valor predeterminado para este campo, pero puede personalizarlo para un nombre que los usuarios de su organización reconozcan.

2. Dirección URL de Zendesk

Para conectarse a los datos de Zendesk, necesita la dirección URL de la instancia de Zendesk de su organización. La dirección URL de la instancia de Zendesk de su organización suele ser similar https://<your-organization-domain>.zendesk.coma .

3. Tipo de autenticación

Zendesk OAuth

Para usar Zendesk OAuth para la autenticación, siga estos pasos.

Un administrador de Zendesk debe crear un cliente de OAuth en el Centro de Administración de Zendesk. Para más información, consulte Administración del acceso a zendesk API en la documentación de Zendesk.

En la tabla siguiente se proporcionan instrucciones sobre cómo rellenar el formulario de creación de cliente de OAuth:

Campo Descripción Valor recomendado
Nombre de cliente Valor único que identifica la aplicación para la que necesita acceso de OAuth. Búsqueda de Microsoft
Descripción (Opcional) Una breve descripción del cliente de OAuth Usar una descripción adecuada
Empresa Nombre de la empresa Uso de un valor adecuado
Logotipo Archivo que contiene la imagen del logotipo de la aplicación. Cualquier logotipo adecuado o usar el valor predeterminado.
Tipo de cliente Elección entre el cliente de Oauth confidencial y público Confidencial
Dirección URL de redireccionamiento Dirección URL de devolución de llamada necesaria a la que redirige el servidor de autorización. Para M365 Enterprise: https:// gcs.office.com/v1.0/admin/oauth/callback,
Para M365 Government: https:// gcsgcc.office.com/v1.0/admin/oauth/callback

Escriba el identificador de cliente (identificador único) y el secreto para conectarse a la instancia. Después de conectarse, use una credencial de cuenta de Zendesk para autenticar el permiso para rastrear.

4. Lanzamiento a audiencia limitada

Implemente esta conexión en una base de usuarios limitada si desea validarla en Copilot y en otras superficies de búsqueda antes de expandir el lanzamiento a una audiencia más amplia. Para más información sobre el lanzamiento limitado, haga clic aquí.

En este momento, está listo para crear la conexión para el Centro de ayuda de Zendesk. Puede hacer clic en el botón "Crear" para publicar los artículos de conexión e índice desde su cuenta de Zendesk.

Para otras configuraciones, como permisos de acceso, esquema y frecuencia de rastreo, tenemos valores predeterminados basados en lo que funciona mejor con los datos de Zendesk.

Usuarios Descripción
Permisos de acceso Solo las personas con acceso al contenido en el origen de datos.
Identidades de mapa Identidades de origen de datos asignadas mediante identificadores de Microsoft Entra.
Contenido Descripción
Administrar propiedades Para comprobar las propiedades predeterminadas y su esquema, consulte el contenido.
Sincronizar Descripción
Rastreo incremental Frecuencia: Cada 15 minutos
Rastreo completo Frecuencia: todos los días

Si desea editar cualquiera de estos valores, debe elegir la opción "Configuración personalizada".

Configuración personalizada

La configuración personalizada es para aquellos administradores que quieren editar los valores predeterminados de la configuración enumerada en la tabla anterior. Una vez que haga clic en la opción Configuración personalizada , verá tres pestañas más: Usuarios, Contenido y Sincronización.

Usuarios

Captura de pantalla que muestra la pestaña Usuarios donde puede configurar permisos de acceso y reglas de asignación de usuarios.

Permisos de acceso

El conector copilot del centro de ayuda de Zendesk admite permisos de búsqueda visibles para todos o solo para las personas con acceso a este origen de datos. Si elige Todos, los datos indexados aparecerán en los resultados de búsqueda de todos los usuarios. Si elige Solo las personas con acceso a este origen de datos, los datos indexados aparecerán en los resultados de búsqueda de los usuarios que tengan acceso a ellos.

Asignación de identidades

El método predeterminado para asignar las identidades del origen de datos con Microsoft Entra ID consiste en comprobar si el identificador de correo electrónico de los usuarios de Zendesk es el mismo que userprincipalname (UPN) o correo de los usuarios de Microsoft Entra. Si cree que la asignación predeterminada no funcionaría para su organización, puede proporcionar una fórmula de asignación personalizada. Para más información sobre la asignación de identidades no Microsoft Entra ID, consulte Asignación de identidades que no son de Azure AD.

Para identificar qué opción es adecuada para su organización:

  1. Elija la opción Microsoft Entra ID si el identificador de Email de los usuarios de Zendesk es el mismo que userprincipalName (UPN) o correo electrónico de los usuarios de Microsoft Entra ID.
  2. Elija la opción No Microsoft Entra ID si el identificador de Email de los usuarios de Zendesk es diferente de UserPrincipalName (UPN) y Email de los usuarios de Microsoft Entra ID.

Contenido

Captura de pantalla que muestra la pestaña Contenido donde puede configurar las propiedades y el esquema.

Administrar propiedades

Aquí puede agregar o quitar las propiedades disponibles del Centro de ayuda de Zendesk, asignar un esquema a la propiedad (definir si una propiedad se puede buscar, consultar, recuperar o refinar), cambiar la etiqueta semántica y agregar un alias a la propiedad. Las propiedades seleccionadas de forma predeterminada se enumeran a continuación.

Source (propiedad) Etiqueta Descripción Esquema
AuthorId Asigne un nombre a todas las personas que participaron o colaboraron en el elemento del origen de datos. Consulta, recuperación
Cuerpo Contenido El cuerpo principal del artículo Búsqueda
CategoryId Consulta, recuperación
CategoryName Consulta, recuperación
CommentsDisabled
ContentTagIds Consulta, recuperación y búsqueda
CreatedDate Fecha y hora de creación Fecha y hora en que se creó el elemento en el origen de datos Consulta, recuperación
Borrador
EndDate Consulta, recuperación
HtmlUrl url La dirección URL objetivo del elemento en el origen de datos Consulta, recuperación y búsqueda
Id Consulta, recuperación
LabelNames Consulta, recuperación y búsqueda
Locale Consulta, recuperación y búsqueda
Anticuado
OutDatedLocales Consulta, recuperación y búsqueda
PermissionGroupId Consulta, recuperación
Position Consulta, recuperación
Promovido
SectionId Consulta, recuperación
SectionName Consulta, recuperación
SourceLocale Consulta, recuperación y búsqueda
Título Título El título del elemento que desea que se muestre en Copilot y otras experiencias de búsqueda Consulta, recuperación y búsqueda
UpdateDate Fecha de la última modificación Fecha y hora en que el elemento se modificó por última vez en el origen de datos. Consulta, recuperación
Url Consulta, recuperación
UserSegmentId Consulta, recuperación
VoteCount Consulta, recuperación
VoteSum Consulta, recuperación

Vista previa de datos

Use el botón vista previa de los resultados para comprobar los valores de ejemplo de las propiedades seleccionadas y el filtro de consulta.

Sincronizar

Captura de pantalla que muestra la pestaña Sincronizar donde puede configurar la frecuencia de rastreo.

El intervalo de actualización determina la frecuencia con la que se sincronizan los datos entre el origen de datos y el índice del conector copilot del Centro de ayuda de Zendesk. Hay dos tipos de intervalos de actualización: rastreo completo y rastreo incremental. Para obtener más información, vea Actualizar configuración.

Puede cambiar los valores predeterminados del intervalo de actualización desde aquí si lo desea.

Solución de problemas

Después de publicar la conexión, puede revisar el estado en la pestaña Orígenes de datos del centro de administración. Para obtener información sobre cómo realizar actualizaciones y eliminaciones, consulte Administración del conector.

Si tiene problemas o quiere proporcionar comentarios, póngase en contacto con Microsoft Graph | Soporte técnico.