Este artículo explica cómo incrustar el Web Widget de Zendesk en un sitio de Microsoft SharePoint usando las extensiones SharePoint Framework (SPFx). Al seguir estos pasos, podrá mejorar el sitio de SharePoint gracias a las capacidades del widget, que permiten buscar artículos y chatear con los agentes. Para aplicar este ejemplo, es necesario ser un administrador tanto en Zendesk como en SharePoint. Cabe mencionar también que este artículo da por hecho que usted tiene experiencia con SharePoint. Para obtener ayuda con SharePoint, consulte Ayuda y aprendizaje de SharePoint.
Para agregar el Web Widget a un sitio de SharePoint, siga estos pasos:
Paso 1: Decidir qué extensión usar y empaquetarla
Ya opte por crear una nueva extensión o por utilizar una existente, asegúrese de empaquetarla correctamente.
- Seleccione una extensión SPFx en el repositorio de GitHub que mantiene la comunidad de Microsoft, o bien desarrolle la suya propia. Este repositorio sirve de host para varias extensiones que han desarrollado los empleados de Microsoft. Si prefiere crear sus propias extensiones, hay tutoriales y guías que le pueden ayudar. En este ejemplo, va a usar la extensión Script Editor Web Part for Modern Pages (Elemento web del editor de scripts para páginas modernas).
- Para empaquetar la extensión, lea las instrucciones sobre los elementos web que se describen en esta página de GitHub. También encontrará más ayuda sobre el empaquetado en el artículo Implementar el elemento web del lado cliente en una página de SharePoint.
Una vez que termine de empaquetar, recibirá un archivo con la extensión `.sppkg`.
Paso 2: Cargar la extensión en el centro de administración de SharePoint
Después de empaquetar la extensión, siga las instrucciones indicadas a continuación para cargarla al sitio de SharePoint.
Para cargar la extensión
- Acceda al centro de administración de SharePoint. Para ello, puede añadir /admin al URL de su sitio de SharePoint.
- Vaya a la página Manage apps (Administrar aplicaciones), donde puede empaquetar con la extensión .sppkg. Asegúrese de que el estado del paquete esté establecido en Enabled (Habilitado). Se le pedirá que lo haga después de cargar.
Así queda cargada la extensión a su sitio de SharePoint. Si necesita ayuda para cargar el paquete, consulte Implementar el elemento web del lado cliente en una página de SharePoint.
Paso 3: Activar la extensión en el sitio de SharePoint
Siga estas instrucciones para activar la extensión en todo el sitio.
Para activar la extensión
- En su sitio de SharePoint, vaya a la página de configuración del sitio.
- En la página Site Settings (Configuración del sitio), haga clic en el icono de engranaje y luego haga clic en Add an app (Agregar una aplicación).
- Seleccione la aplicación y haga clic en Add (Agregar).
En la página My apps (Mis aplicaciones), bajo Added apps (Aplicaciones agregadas), verá el paquete que agregó anteriormente.
Paso 4: Incrustar el Web Widget
Ahora que la extensión está activada, puede incrustar el Web Widget en su página.
Para incrustar el Web Widget
- Abra la página de SharePoint donde desea incrustar el Web Widget.
- Haga clic en Edit (Editar).
- Haga clic en la sección del elemento web en la parte superior de la página y luego seleccione la extensión que agregó.
- Haga clic en Edit markup (Editar marcado), y luego haga clic en Edit HTML Code (Editar código HTML).
- En el editor de script, agregue el script del widget como se muestra a continuación:
Si desea más información sobre cómo generar el script del widget, consulte Adición del widget de Zendesk Chat a un sitio web.
Ahora, el Web Widget está disponible en la página de SharePoint.
Más información
- Tutorial de SPFx
- Extensión de SPFx: Script editor web part for modern pages (Elemento web editor de scripts para páginas modernas)