> 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
Ao configurar um novo **Aplicativo do usuário**, você trabalhará com várias configurações principais que determinam como seu aplicativo externo se integra à plataforma Navixy. Vamos explorar cada componente essencial.
Comece clicando na botão na **Aplicações do usuário** lista. No formulário de configuração exibido, siga estas etapas:
{% stepper %}
{% step %}
## Configure 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" %}
* Garanta que a URL seja válida, use uma conexão HTTPS, aponte para um recurso confiável e tenha no máximo 1.000 caracteres.
* Certifique-se de que o aplicativo tenha a configuração de iFrame habilitada do lado dele; caso contrário, você não conseguirá abri-lo na interface da plataforma.
{% endhint %}
{% endstep %}
{% step %}
## Configure 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 de 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.
Entendendo os parâmetros sugeridos da URL
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 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 determinado para ele.
{% hint style="info" %}
Teste sua configuração para garantir que o aplicativo carregue corretamente. Clique para exibir uma prévia.
{% endhint %}
{% endstep %}
{% step %}
## Ajuste a aparência
Crie uma identidade reconhecível para seu aplicativo para facilitar o acesso. As configurações a seguir ajudarão você a fazer isso:
* **Rótulo**: Adicione um nome único 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 a finalidade do aplicativo.
* **Ícone**: Selecione um ícone que represente a função do seu aplicativo para uma navegação ainda mais nativa.
{% endstep %}
{% step %}
## Selecione o método de exibição
Decida como seu aplicativo abrirá escolhendo uma das duas opções no **Abrir em** menu suspenso:
* **Embutido**: O aplicativo aparece dentro da interface da plataforma
* **Nova aba**: O aplicativo é 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 por essa tecnologia, não deixe 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 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 uma funcionalidade adicional de login do lado do seu aplicativo.\
Você pode escolher um dos dois métodos de autenticação:
* **chave de API**
* Este método é para aplicativos em que o gerenciamento de funções ou as permissões do usuário não são necessários.
* A chave de API corresponde ao nível de acesso do Proprietário da conta. Isso significa que fornecer uma chave de API a um usuário comum pode conceder a ele acesso a **todos os dados** disponíveis para o usuário principal.\
Por exemplo, se seu aplicativo trabalha com dispositivos GPS aos quais um usuário tem direitos limitados ou nenhum acesso, o uso da 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 atual do usuário para o aplicativo.
{% 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á habilitada, a plataforma adiciona o parâmetro `?session_key=` à URL do seu aplicativo.
* 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 atual do usuário 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 ficam automaticamente disponíveis para os usuários da conta.
{% endstep %}
{% endstepper %}
Exemplo de visualização do aplicativo do usuário incorporado
Dicas rápidas de solução de problemas
Se o seu aplicativo não for exibido corretamente quando incorporado, tente:
* Abri-lo em uma nova aba
* Verificar se a sua URL está correta e acessível
* Verificar se todos os parâmetros estão formatados corretamente
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](/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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://navixy.com/docs/user/pt-br/guide/account/user-applications/creating-new-user-applications.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.