Cómo instalar el Messenger Notiondesk en su sitio web

Notiondesk Messenger lleva tu centro de ayuda Notiondesk directamente a tu sitio web o aplicación web.

Los visitantes pueden usar Messenger para buscar en tu centro de ayuda, leer artículos, chatear con tu asistente de IA, ver las actualizaciones del registro de cambios y contactar con tu equipo sin salir de tu sitio web.

Esta guía explica cómo instalar Notiondesk Messenger en un sitio web estándar.

Antes de empezar

Antes de instalar Notiondesk Messenger, asegúrese de tener:

• Centro de ayuda Notiondesk

• Un mensajero configurado en Notiondesk

• Acceso al código de su sitio web o a la configuración de código personalizado para todo el sitio.

• Su fragmento de instalación único de Messenger Notiondesk

Si desea que los visitantes utilicen el asistente de IA dentro de Messenger, configure también el chatbot de IA Notiondesk. Consulte Configurar y habilitar el chatbot de IA .

Elija un método de instalación

Utilice el método de instalación que mejor se adapte a su sitio web.

Para la mayoría de los sitios web tradicionales, el fragmento de código JavaScript es el método de instalación más sencillo.

Instalar Messenger en un sitio web estándar

1. Copia tu código de instalación de Messenger.

Abre la configuración de Messenger en Notiondesk y busca la sección Instalación .

Copia el fragmento de instalación generado para tu Messenger.

El código tiene este formato:

YOUR_MESSENGER_ID identifica el Messenger que debe cargarse en su sitio web.

Copia el fragmento desde tu propio panel de control Notiondesk en lugar de copiar un ID de Messenger de otro sitio web o cuenta.

2. Añade el fragmento a tu sitio web.

Pegue el fragmento de Messenger inmediatamente antes de la etiqueta de cierre </body>:

Si su sitio web utiliza un diseño compartido, una plantilla, un pie de página o una sección de código personalizado para todo el sitio, agregue el fragmento una sola vez para que Messenger se cargue en todo el sitio web.

Si Messenger solo debe aparecer en páginas específicas, incluya el fragmento únicamente en esas páginas.

3. Publica tus cambios

Guarda y publica tu sitio web después de añadir el fragmento de código.

El código de Messenger debe estar presente en el sitio web publicado. Si se agrega el código solo a una versión local o no publicada, Messenger no estará disponible para los visitantes.

<script
  async
  src="https://static.notiondesk.help/messenger/widget.js"
  data-messenger-id="YOUR_MESSENGER_ID">
</script>

<body>
  <!-- Your website -->

  <script
    async
    src="https://static.notiondesk.help/messenger/widget.js"
    data-messenger-id="YOUR_MESSENGER_ID">
  </script>
</body>

Verificar la instalación

Abra el sitio web publicado en su navegador.

Una instalación exitosa debería cargar el lanzador de Messenger Notiondesk en las páginas que contienen el código de instalación.

Abre Messenger y verifica que aparezca el contenido esperado Notiondesk.

Puedes probar:

• Mensajero de apertura y cierre

• Buscar en tu centro de ayuda

• Abrir un artículo

• Iniciar una conversación con la IA si el chatbot de IA está habilitado.

• Abrir cualquier otra sección de Messenger que haya habilitado

Si Messenger no aparece, abre las herramientas para desarrolladores de tu navegador y comprueba si el widget se carga correctamente.

React, Next.js, Vue, Nuxt y SPAs

Las aplicaciones de una sola página desarrolladas con React, Next.js, Vue, Nuxt, etc., deberían usar el paquete oficial @notiondesk-so/messenger-js-sdk en lugar de agregar manualmente el fragmento de código estándar.

Instala el paquete con:

También puedes instalarlo con Yarn o pnpm.

El SDK proporciona integraciones específicas para:

npm install @notiondesk-so/messenger-js-sdk

• JavaScript y TypeScript

• Reaccionar

• Next.js

• Vista

• Nuxt

El SDK también proporciona métodos para mostrar, ocultar, alternar, configurar y destruir Messenger.

Las integraciones del framework deben inicializar Notiondesk Messenger en el lado del cliente. No inicialice el SDK de Messenger durante la renderización del lado del servidor.

No instale tanto el fragmento de código estándar de Messenger como el SDK en la misma aplicación, a menos que gestione intencionadamente instancias de Messenger por separado.

Para una configuración completa del framework, consulte la guía Instalar Notiondesk Messenger con React y Next.js.

Solución de problemas