Nota: Para seguir los pasos que se indican a continuación, asegúrese de tener acceso de administrador a su instancia de Microsoft Azure.
En esta guía, aprenderá a conectar su instancia de Microsoft SharePoint a Talkdesk Knowledge Management. Esta es una descripción general de los pasos:
Microsoft SharePoint
Para conectar su instancia de Microsoft SharePoint (MS Sharepoint) a Talkdesk Knowledge Management, necesita acceso al Microsoft Azure Portal. Comience por crear la conexión en Microsoft Azure y, a continuación, rellene los datos de la conexión en Talkdesk Knowledge Management. Para obtener información más detallada y actualizada, consulte la guía de Microsoft.
Registre una nueva aplicación
- En el portal de Azure, en Servicios de Azure, seleccione Microsoft Entra ID.
- Seleccione + Agregar y luego Registro de aplicaciones.
- Agregue un nombre, y en Tipos de cuentas compatibles, seleccione: Cuentas solo en este directorio organizativo.
- Seleccione «Registrarse».
ID de la aplicación (ID del cliente)
- Después de registrar una nueva aplicación, busque la ID de la aplicación (cliente) y la ID del directorio (inquilino) en la opción del menú de visión general. Tome nota de estos valores, ya que se necesitarán en la configuración de Talkdesk Knowledge Management.
Generar un Client Secret
- Por razones de seguridad, debe agregar un secreto a la configuración. En el menú anterior, en Credenciales del cliente, seleccione «Agregar un certificado o secreto».
- Seleccione New Client Secret.
- Agregue una descripción y seleccione una fecha de vencimiento (le recomendamos 730 días o 24 meses).
- Seleccione Agregar.
- Información importante: Guarde inmediatamente el valor secreto, ya que los valores de Client Secret solo pueden verse inmediatamente después de su creación. Asegúrese de guardar el valor secreto antes de salir de la página.
Permisos de API
Para permitir que su conector acceda a sus sitios y documentos de SharePoint, debe atribuir permisos de lectura para leer todos los sitios, leer todos los archivos y navegar por la lista de todos los sitios.
- Dentro de su registro de aplicación en Administrar, seleccione Permisos de API.
- Seleccione Agregar un permiso.
- Seleccione Microsoft Graph.
- Luego seleccione Permisos de aplicación.
- Ahora, agregue los siguientes permisos:
-
-
- Sitios.Leer.Todos
- Archivos.Leer.Todos
- BrowserSiteLists.Leer.Todos
-
- Seleccione Agregar permisos. Todos estos permisos deben ser aprobados por un administrador. Si tiene permisos de administrador, seleccione Conceder consentimiento de administrador.
Nombre del sitio de SharePoint
Decida qué sitio desea conectar a Talkdesk SharePoint. Por el momento, solo puede seleccionar un sitio por conector. Si desea sincronizar más de un sitio, cree otro conector. No es posible seleccionar un subsitio; debe seleccionar el sitio raíz de su SharePoint.
- Para encontrar todos sus sitios activos, vaya a:
- Guarde el nombre del sitio (Nota: Esto no se refiere a la dirección URL del sitio), ya que el nombre del sitio se utilizará para conectarse a su instancia de Talkdesk.
Talkdesk
Con la información de los pasos anteriores, asegúrese de disponer de los siguientes datos:
- ID de cliente - > ID de aplicación (cliente)
- Client Secret -> Valor de la clave
- ID de inquilino - > ID de directorio (inquilino)
- Nombre del sitio
Agregue un conector de MS SharePoint
- Dentro de su Talkdesk Workspace, navegue al menú de Knowledge Management.
- Haga clic en el botón Fuentes externas.
- Seleccione Conectar nueva fuente.
- De la lista de conectores disponibles, elija SharePoint.
- Complete los campos requeridos en Talkdesk Knowledge Management como se muestra en el siguiente ejemplo.
- No se olvide de agregar un nombre y descripción, así como elegir la opción Actualizar configuración.
- Seleccione Crear y ¡el conector se crea!
Notas:
- Dentro de Talkdesk, puede crear conectores repetidos a MS Sharepoint (por ejemplo, mapear diferentes partes de su Sharepoint con diferentes niveles de permiso para el acceso a diferentes usuarios).
- Solo SharePoint Online es compatible con este conector.
- La información se extrae de ambas páginas y documentos presentes en el sitio de SharePoint.
- Tenga en cuenta que actualmente hay un límite de 40 000 documentos por conector. Para los archivos PDF, cada página se trata como un documento separado, mientras que para los archivos Markdown (MD), cada sección se trata como un documento separado.
Tipos de archivos compatibles con MS Sharepoint
Estos son los tipos de archivos compatibles con el conector de MS Sharepoint.
Formato del documento |
Tratado como |
Cómo se trata el documento |
Estructura original |
Formato de documento portátil (PDF) | Texto sin formato | Solo se extrae contenido de texto de archivos PDF para la búsqueda. Las imágenes y otros contenidos no se extraen. | Sin estructurar |
Lenguaje de marcado de hipertexto (HTML) | HTML | Se extraen todos los elementos HTML, con etiquetas potencialmente maliciosas eliminadas. | Semiestructurado |
MarkDown (MD) | Texto sin formato | El contenido se extrae con la sintaxis MarkDown incluida. | Semiestructurado |
Valores separados por comas (CSV) | CSV | Contenido extraído de cada celda, con un único archivo tratado como resultado de un único documento. | Estructurado para los archivos de preguntas frecuentes, por lo demás, semiestructurado |
Microsoft Excel (XLS y XLSX) | XLS y XLSX | Contenido extraído de cada celda, con un único archivo tratado como resultado de un único documento. | Semiestructurado |
Microsoft PowerPoint (PPT) | PPT | Solo se extrae el contenido textual de las diapositivas de PowerPoint para la búsqueda. Las imágenes y otros contenidos no se extraen. | Sin estructurar |
Microsoft Word (DOCX) | DOCX | Solo se extrae el contenido textual de las páginas de Word para la búsqueda. Las imágenes y otros contenidos no se extraen. | Sin estructurar |
Texto sin formato (TXT) | TXT | Se extrae todo el texto del documento de texto. | Sin estructurar |
Procesador de texto Hangul (HWP) | TXT | Solo se extrae contenido de texto de los documentos HWP para la búsqueda. Las imágenes y otros contenidos no se extraen. | Sin estructurar |
EPUB | Markdown | Convertido a Markdown. | Semiestructurado |