> 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 de usuário**, você trabalhará com várias configurações-chave que determinam como seu aplicativo externo 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 as etapas a seguir:

{% stepper %}
{% step %}

## Configurar a URL

Especifique a URL do seu aplicativo, o endereço onde ele está hospedado; 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, aponte para um recurso confiável e contenha no máximo 1.000 caracteres.
* Certifique-se de que o aplicativo tenha a configuração de iFrame ativada do lado dele; caso contrário, você não conseguirá abri-lo na interface da plataforma.
  {% endhint %}
  {% endstep %}

{% step %}

## Configurar parâmetros básicos

Para personalizar seu aplicativo, 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>Entendendo os parâmetros de URL sugeridos</summary>

A 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 fuso 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 sugerido do parâmetro ou especificar um determinado valor para ele.

</details>

![Exemplo de URL do aplicativo 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\&token=557f4728-dad8-455c-a92a-ddd4fcb43694)

{% hint style="info" %}
Teste sua configuração para garantir que o aplicativo 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 %}

## Ajustar aparência

Crie uma identidade reconhecível para seu aplicativo para facilitar o acesso. As configurações a seguir ajudarão você nisso:

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

{% step %}

## Selecionar método de exibição

Decida como seu aplicativo será aberto escolhendo uma das duas opções no **Abrir em** menu suspenso:

* **Incorporado**: O app aparece dentro da interface da plataforma
* **Nova aba**: O app é aberto 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 com essa tecnologia, certifique-se de visualizar previamente o resultado da incorporação. Se você encontrar algum problema com esse método de exibição, considere usar **Nova aba**.
{% endhint %}
{% endstep %}

{% step %}

## Configurar autenticação (opcional)

Configure a autenticação se seu aplicativo depender da API da plataforma. Nesse caso, a plataforma fornecerá os dados de autenticação diretamente ao aplicativo quando ele for aberto, eliminando a necessidade de implementar funcionalidade adicional de login no seu aplicativo.\
Você pode escolher um dos dois métodos de autenticação:

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

{% hint style="info" %}
A seleção do **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 adiciona o `?session_key=` parâmetro à URL do seu aplicativo.

* Se você selecionou uma **Chave de API**chave de API, o valor do parâmetro contém essa chave.
* Se você optou por uma **Chave de sessão**chave de sessão, o valor do parâmetro inclui a chave da sessão do usuário atual a partir da qual o aplicativo está sendo acessado.

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

{% step %}

## Salvar o novo aplicativo

Clique no **Salvar** botão. Seu aplicativo aparece na **Aplicações do usuário** lista e na barra lateral da plataforma. Os aplicativos ativados 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 visualização incorporada do aplicativo de usuário</p></figcaption></figure>

<details>

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

Se seu aplicativo não for exibido corretamente quando incorporado, tente:

* Abri-lo 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>

Os aplicativos criados permanecem totalmente configuráveis após serem salvos. Você pode ajustar seus parâmetros e aparência a qualquer momento. Para saber mais sobre o gerenciamento de aplicativos, consulte [Gerenciar Aplicações do usuário existentes](https://navixy.com/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.
