> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/pt-br/guide/account/user-applications/creating-new-user-applications.md).

# Criando novas Aplicações do usuário

Configure uma nova Aplicação do usuário no Navixy definindo a URL de integração e outros parâmetros para conectar uma ferramenta externa à interface da plataforma.

Ao configurar um novo **aplicativo do usuário**, você trabalhará com várias configurações essenciais que determinam como sua aplicação externa se integra à plataforma Navixy. Vamos explorar cada componente essencial.

Comece clicando na <img src="https://1308974401-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ão na **Aplicações do usuário** lista. No formulário de configuração exibido, siga os passos abaixo:

{% stepper %}
{% step %}

## Configure a URL

Especifique a URL da sua aplicação, o endereço em que sua aplicação está hospedada; ela serve como base para a integração.

{% hint style="danger" %}

* Certifique-se de que a URL seja válida, use uma conexão HTTPS, leve a um recurso confiável e não contenha mais de 1000 caracteres.
* Certifique-se de que a aplicação tenha a configuração de iFrame habilitada do lado dela; caso contrário, você não conseguirá abri-la na interface da plataforma.
  {% endhint %}
  {% endstep %}

{% step %}

## Configure parâmetros básicos

Para personalizar sua aplicação, você pode incluir vários parâmetros na URL. Você pode adicionar parâmetros manualmente no campo da URL ou usar uma de nossas sugestões: idioma, ID do usuário ou fuso horário. Clique em uma sugestão de parâmetro para adicioná-la ao final da URL. Expanda a descrição abaixo para saber mais sobre os parâmetros sugeridos e exemplos.

<details>

<summary>Entenda os parâmetros de URL sugeridos</summary>

Navixy sugere alguns parâmetros básicos para personalização

1. `?locale={locale_code}`\
   Parâmetro de idioma que corresponde automaticamente ao idioma da plataforma do usuário.

* Exemplo: `https://your-app.com/dashboard?locale=en`

2. `?user_id={user_identifier}`\
   Parâmetro de contexto do usuário que transmite a identidade do usuário para filtrar informações personalizadas.

* Exemplo: `https://your-app.com/dashboard?user_id=12345`

3. `?timezone={timezone}`\
   Parâmetro de horário que corresponde automaticamente ao fuso horário da plataforma do usuário.

* Exemplo: `https://your-app.com/dashboard?timezone=UTC+1`

Você pode editar o nome do parâmetro sugerido ou especificar um valor específico para ele.

</details>

![Exemplo de URL da aplicação com parâmetros](https://1308974401-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" %}
Teste sua configuração para garantir que a aplicação carregue corretamente. Clique <img src="https://1308974401-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 exibir uma prévia.
{% endhint %}
{% endstep %}

{% step %}

## Ajuste a aparência

Crie uma identidade reconhecível para sua aplicação para facilitar o acesso. As configurações a seguir ajudarão você a fazer isso:

* **Rótulo**: Adicione um nome exclusivo e descritivo para seu aplicativo (até 24 caracteres). Ele é exibido na barra lateral da plataforma.
* **Descrição**: Adicione uma breve explicação com detalhes sobre a funcionalidade do aplicativo ou destaque informações importantes (até 50 caracteres). Uma descrição informativa ajuda seus usuários a entender com mais clareza o propósito do aplicativo.
* **Ícone**: Selecione um ícone que represente a função da sua aplicação para uma navegação ainda mais nativa.
  {% endstep %}

{% step %}

## Selecione o método de exibição

Decida como sua aplicação será aberta escolhendo uma das duas opções na **Abrir em** lista suspensa:

* **Incorporado**: O aplicativo aparece dentro da interface da plataforma
* **Nova aba**: O aplicativo abre em uma aba separada do navegador

{% hint style="info" %}
A plataforma Navixy usa iFrame para incorporação. Como nem todas as URLs podem ser processadas com sucesso por essa tecnologia, certifique-se de visualizar o resultado da incorporação. Se você encontrar algum problema com esse método de exibição, considere usar **Nova aba**.
{% endhint %}
{% endstep %}

{% step %}

## Configure a autenticação (opcional)

Configure a autenticação se sua aplicação depender da API da plataforma. Nesse caso, a plataforma fornecerá os dados de autenticação diretamente à aplicação quando ela for aberta, eliminando a necessidade de implementar funcionalidades adicionais de login do lado da sua aplicação.\
Você pode escolher um dos dois métodos de autenticação:

* **chave de API**
  * Esse método é para aplicações em que o gerenciamento de funções ou as permissões de usuário não são necessários.
  * A chave da API corresponde ao nível de acesso do proprietário da conta. Isso significa que fornecer a um usuário comum uma chave da API pode conceder a ele acesso a **todos os dados** disponíveis para o usuário principal.\
    Por exemplo, se sua aplicação trabalha com dispositivos GPS aos quais um usuário tem direitos limitados ou nenhum acesso, o uso da chave da API ainda expõe todos os dispositivos GPS da conta principal.
* **Chave de sessão**
  * Esse método é recomendado quando há gerenciamento de funções envolvido.
  * Transmite a chave de sessão do usuário atual para a aplicação.

{% hint style="info" %}
Selecionar o **chave de API** método desativa automaticamente o **Chave de sessão** método, e vice-versa. Apenas um método pode ser usado por vez.
{% endhint %}

Quando a autenticação está ativada, a plataforma acrescenta o parâmetro `?session_key=` à URL da sua aplicação.

* Se você tiver selecionado uma **chave de API**, o valor do parâmetro contém essa chave.
* Se você tiver optado por uma **Chave de sessão**, o valor do parâmetro inclui a chave da sessão do usuário atual a partir da qual a aplicação está sendo acessada.

Certifique-se de que a aplicação seja capaz de ler e usar esse parâmetro.
{% endstep %}

{% step %}

## Salvar o novo aplicativo

Enviar **para salvar o comando. Clique em** botão. Sua aplicação aparece na **Aplicações do usuário** lista e na barra lateral da plataforma. As aplicações ativadas tornam-se automaticamente disponíveis para os usuários da conta.
{% endstep %}
{% endstepper %}

<figure><img src="https://1308974401-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>Exemplo de exibição do aplicativo do usuário incorporado</p></figcaption></figure>

<details>

<summary>Dicas rápidas de solução de problemas</summary>

Se sua aplicação não for exibida corretamente quando incorporada, tente:

* Abri-la em uma nova aba em vez disso
* Verificar se sua URL está correta e acessível
* Verificar se todos os parâmetros estão formatados corretamente

</details>

As aplicações criadas permanecem totalmente configuráveis após serem salvas. Você pode ajustar seus parâmetros e aparência a qualquer momento. Para saber mais sobre o gerenciamento de aplicações, consulte [Gerenciando Aplicações do usuário existentes](/docs/user/pt-br/guide/account/user-applications/managing-existing-user-applications.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/user/pt-br/guide/account/user-applications/creating-new-user-applications.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.