Creación de nuevas aplicaciones de usuario

Configure una nueva aplicación de usuario en Navixy configurando la URL de integración y otros parámetros para conectar una herramienta externa a la interfaz de la plataforma.

Al configurar una nueva Aplicación de usuario, trabajará con varias configuraciones clave que determinan cómo se integra su aplicación externa con la plataforma. Exploremos cada componente esencial.

Comience haciendo clic en la botón en la Aplicaciones de usuario lista. En el formulario de configuración que aparece, continúe con los siguientes pasos:

1

Configure la URL

Especifique la URL de su aplicación: la dirección donde está alojada su aplicación; esta sirve como base para la integración.

• Asegúrese de que la URL sea válida, use una conexión HTTPS, lleve a un recurso fiable y no contenga más de 1000 caracteres.

• Asegúrese de que la aplicación tenga habilitada la configuración iFrame en su lado; de lo contrario, no podrá abrirla en la interfaz de la plataforma.

2

Configure los parámetros básicos

Para personalizar su aplicación, puede incluir varios parámetros en la URL. Puede añadir parámetros manualmente en el campo de la URL o usar una de nuestras sugerencias: idioma, ID de usuario o zona horaria. Haga clic en una sugerencia de parámetro para añadirla al final de la URL. Amplíe la descripción a continuación para obtener más información sobre los parámetros sugeridos y los ejemplos.

Comprender los parámetros de URL sugeridos

Sugerimos algunos parámetros básicos para la personalización

1. ?locale={locale_code} Parámetro de idioma que coincide automáticamente con el idioma de la plataforma del usuario.

• Ejemplo: https://your-app.com/dashboard?locale=en

1. ?user_id={user_identifier} Parámetro de contexto de usuario que transmite la identidad del usuario para filtrar información personalizada.

• Ejemplo: https://your-app.com/dashboard?user_id=12345

1. ?timezone={timezone} Parámetro de zona horaria que coincide automáticamente con la zona horaria de la plataforma del usuario.

• Ejemplo: https://your-app.com/dashboard?timezone=UTC+1

Puede editar el nombre del parámetro sugerido o especificar un valor concreto para él.

Ejemplo de URL de la aplicación con parámetros

Pruebe su configuración para asegurarse de que la aplicación se cargue correctamente. Haga clic en para mostrar una vista previa.

3

Ajustar la apariencia

Cree una identidad reconocible para su aplicación para facilitar el acceso. La siguiente configuración le ayudará a lograrlo:

• campo – Añada un nombre único y descriptivo para su aplicación (hasta 24 caracteres). Se mostrará en la barra lateral de la plataforma.

• Descripción – Añada una breve explicación con detalles sobre la funcionalidad de la aplicación o destaque información importante (hasta 50 caracteres). Una descripción informativa ayudará a sus usuarios a comprender mejor el propósito de la aplicación.

• Icono – Seleccione un icono que represente la función de su aplicación para una navegación aún más nativa.

4

Seleccione el método de visualización

Decida cómo se abrirá su aplicación eligiendo una de las dos opciones en la Abrir en lista desplegable:

• Incrustado – La aplicación aparece dentro de la interfaz de la plataforma

• Nueva pestaña – La aplicación se abre en una pestaña aparte del navegador

Nuestra plataforma utiliza iFrame para incrustar. Como no todas las URL pueden procesarse correctamente con esta tecnología, asegúrese de previsualizar el resultado de la incrustación. Si encuentra algún problema con este método de visualización, considere usar Nueva pestaña.

5

Configure la autenticación (opcional)

Configure la autenticación si su aplicación depende de la API de la plataforma. En este caso, la plataforma proporcionará los datos de autenticación directamente a la aplicación cuando se abra, eliminando la necesidad de implementar funcionalidad de inicio de sesión adicional en el lado de su aplicación. Puede elegir uno de los dos métodos de autenticación:

• campo de clave API. Asegúrese de haber creado una clave correcta como se describe en Crear clave API.

  • Este método es para aplicaciones en las que no se requiere gestión de roles ni permisos de usuario.

  • La clave API corresponde al nivel de acceso del propietario de la cuenta. Esto significa que proporcionar una clave API a un usuario común puede otorgarle acceso a todos los datos disponibles para el usuario principal. Por ejemplo, si su aplicación trabaja con rastreadores a los que un usuario tiene derechos limitados o ningún acceso, el uso de la clave API seguirá mostrando todos los rastreadores de la cuenta principal.

• Clave de sesión

  • Este método se recomienda cuando interviene la gestión de roles.

  • Transmite la clave de sesión actual del usuario a la aplicación.

La selección del campo de clave API. Asegúrese de haber creado una clave correcta como se describe en Crear clave API. método deshabilitará automáticamente el Clave de sesión método, y viceversa. Solo se puede usar un método a la vez.

Cuando la autenticación está habilitada, la plataforma añade el parámetro ?session_key= a la URL de su aplicación.

• Si ha seleccionado una campo de clave API. Asegúrese de haber creado una clave correcta como se describe en Crear clave API.clave API

• Si ha optado por una Clave de sesiónclave de sesión, el valor del parámetro incluirá la clave de la sesión de usuario actual desde la que se accede a la aplicación.

Asegúrese de que la aplicación sea capaz de leer y usar este parámetro.

6

Guardar la nueva aplicación

Haga clic en el Guardar botón. Su aplicación aparecerá en la Aplicaciones de usuario lista y en la barra lateral de la plataforma. Las aplicaciones habilitadas pasan a estar disponibles automáticamente para los usuarios de la cuenta.

Ejemplo de vista de una aplicación de usuario incrustada

Consejos rápidos para solucionar problemas

Si su aplicación no se muestra correctamente al incrustarla, pruebe a:

• Abrirla en una nueva pestaña en su lugar

• Verificar que su URL sea correcta y accesible

• Comprobar que todos los parámetros estén formateados correctamente

Las aplicaciones creadas permanecen completamente configurables después de guardarlas. Puede ajustar sus parámetros y su apariencia en cualquier momento. Para obtener más información sobre la gestión de aplicaciones, consulte Gestión de Aplicaciones de usuario existentes.