# Crear nuevas aplicaciones de Usuario

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

Comience haciendo clic en la <img src="https://3876955220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-b205ed1cd11ae77328c30a95f8af7d8d5be21be8%2Fchrome_py0qhiu5p8.webp?alt=media" alt="chrome_py0qhiu5p8.webp" data-size="line"> botón en la **User applications** lista. En el formulario de configuración que apareció, proceda con los siguientes pasos:

{% stepper %}
{% step %}
**Configure la URL**

Especifique la URL de su aplicación: la dirección donde se hospeda su aplicación; sirve como la base para la integración.

{% hint style="danger" %}

* Asegúrese de que la URL sea válida, utilice una conexión HTTPS, conduzca a un recurso confiable y no contenga más de 1000 caracteres.
* Asegúrese de que la aplicación tenga habilitada la configuración de iFrame en su lado; de lo contrario no podrá abrirla en la interfaz de la plataforma.
  {% endhint %}
  {% endstep %}

{% step %}
**Configure los parámetros básicos**

Para personalizar su aplicación, puede incluir varios parámetros en la URL. Puede agregar parámetros manualmente en el campo de 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. Expanda la descripción a continuación para obtener más información sobre los parámetros sugeridos y ejemplos.

<details>

<summary>Comprensión de los parámetros de URL sugeridos</summary>

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`

2. `?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`

3. `?timezone={timezone}`\
   Parámetro de hora 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 determinado para el mismo.

</details>

![Ejemplo de URL de aplicación con parámetros](https://3876955220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-5ef1c1516fcc65f19333029d0918f4a42d1a5605%2FURL_with_Params.png?alt=media)

{% hint style="info" %}
Pruebe su configuración para asegurarse de que la aplicación se carga correctamente. Haga clic <img src="https://3876955220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-78171811e50248dd9b883328ca7b69ec6cf767bf%2Fimage-20241217-083119.png?alt=media" alt="image-20241217-083119.png" data-size="line"> para mostrar una vista previa.
{% endhint %}
{% endstep %}

{% step %}
**Ajustar apariencia**

Cree una identidad reconocible para su aplicación para que sea fácil de acceder. Los siguientes ajustes le ayudarán a lograrlo:

* **Label** – Agregue 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.
  {% endstep %}

{% step %}
**Seleccione el método de visualización**

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

* **Embedded** – La aplicación aparece dentro de la interfaz de la plataforma
* **Nueva pestaña** – La aplicación se abre en una pestaña de navegador separada

{% hint style="info" %}
Nuestra plataforma utiliza iFrame para la incrustación. Dado que no todas las URL pueden procesarse correctamente con esta tecnología, asegúrese de obtener una vista previa del resultado de la incrustación. Si encuentra problemas con este método de visualización, considere usar **Nueva pestaña**.
{% endhint %}
{% endstep %}

{% step %}
**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 su lado de la aplicación.\
Puede elegir uno de los dos métodos de autenticación:

* **API key**
  * Este método es para aplicaciones donde no se requiere gestión de roles o permisos de usuario.
  * La clave de API corresponde al nivel de acceso del propietario de la cuenta. Esto significa que proporcionar una clave de API a un usuario común puede concederle 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 sin acceso alguno, usar la clave de API aún expondrá todos los rastreadores de la cuenta principal.
* **Clave de sesión**
  * Este método se recomienda cuando está involucrada la gestión de roles.
  * Transmite la clave de sesión del usuario actual a la aplicación.

{% hint style="info" %}
Seleccionar el **API key** método desactivará automáticamente el **Clave de sesión** método, y viceversa. Solo se puede usar un método a la vez.
{% endhint %}

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

* Si ha seleccionado un **API key**, el valor del parámetro contendrá esta clave.
* Si ha optado por un **Clave de sesión**, el valor del parámetro incluirá la clave de la sesión del usuario actual desde la cual se accede a la aplicación.

Asegúrese de que la aplicación sea capaz de leer y utilizar este parámetro.
{% endstep %}

{% step %}
**Guarde la nueva aplicación**

Haga clic en el **Guardar** botón. Su aplicación aparecerá en la **User applications** lista y en la barra lateral de la plataforma. Las aplicaciones habilitadas se ponen automáticamente a disposición de los usuarios de la cuenta.
{% endstep %}
{% endstepper %}

<figure><img src="https://3876955220-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-f3208949947b9860b2bd4665a35ccfa6708d32bb%2Fimage.png?alt=media" alt=""><figcaption><p>Ejemplo de vista de Aplicación de usuario incrustada</p></figcaption></figure>

<details>

<summary>Consejos rápidos de solución de problemas</summary>

Si su aplicación no se muestra correctamente cuando se incrusta, intente:

* 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 correctamente formateados

</details>

Las aplicaciones creadas permanecen totalmente configurables después de guardarlas. Puede ajustar sus parámetros y apariencia en cualquier momento. Para obtener más información sobre la gestión de aplicaciones, consulte [Gestionar Aplicaciones de usuario existentes](https://www.navixy.com/docs/user/es/guide/account/user-applications/managing-existing-user-applications).
