> 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 novos aplicativos de usuário
Ao configurar um novo **Aplicativo de usuário**, você trabalhará com várias configurações principais que determinam como seu aplicativo externo se integra à plataforma. Vamos explorar cada componente essencial.
Comece clicando em botão na **Aplicativos do usuário** lista. No formulário de configuração exibido, prossiga com as seguintes etapas:
{% stepper %}
{% step %}
**Configurar a URL**
Especifique a URL do seu aplicativo - o endereço onde seu aplicativo está hospedado; ele 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 1000 caracteres.
* Certifique-se de que a configuração iFrame esteja habilitada do lado do aplicativo; 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 ver exemplos.
Entendendo os parâmetros de URL sugeridos
Sugerimos 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 do parâmetro sugerido ou especificar um valor específico para ele.
{% hint style="info" %}
Teste sua configuração para garantir que o aplicativo seja carregado corretamente. Clique para exibir uma prévia.
{% endhint %}
{% endstep %}
{% step %}
**Ajustar 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 exclusivo e descritivo para seu app (até 24 caracteres). Ele será 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 ajudará 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 na **Abrir em** lista suspensa:
* **Incorporado** – O app aparece dentro da interface da plataforma
* **Nova aba** – O app abre em uma aba separada do navegador
{% hint style="info" %}
Nossa plataforma usa iFrame para incorporação. Como nem todas as URLs podem ser processadas com sucesso com essa tecnologia, não deixe de visualizar o resultado da incorporação. Se você encontrar algum problema com este 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 uma funcionalidade adicional de login do lado do seu aplicativo.\
Você pode escolher um dos dois métodos de autenticação:
* **Chave da API**
* Este método é para aplicativos em que o gerenciamento de funções ou permissões de usuário não é necessário.
* A chave da API corresponde ao nível de acesso do proprietário da conta. Isso significa que fornecer uma chave da 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 rastreadores aos quais um usuário tem direitos limitados ou nenhum acesso, o uso da chave da API ainda exporá todos os rastreadores da conta principal.
* **Chave de sessão**
* Este método é recomendado quando há gerenciamento de funções envolvido.
* Transmite a chave de sessão atual do usuário para o aplicativo.
{% hint style="info" %}
A seleção do **Chave da API** método desativará 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 parâmetro `?session_key=` à URL do seu aplicativo.
* Se você tiver selecionado uma **Chave da API**chave da API
* Se você tiver optado por uma **Chave de sessão**chave de sessão, o valor do parâmetro incluirá a chave da sessão 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 aparecerá na **Aplicativos 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 de 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 em vez disso
* Verificar se a URL está correta e acessível
* Verificar se todos os parâmetros estão formatados corretamente
Os aplicativos criados permanecem totalmente configuráveis depois de salvos. Você pode ajustar seus parâmetros e aparência a qualquer momento. Para saber mais sobre o gerenciamento de aplicativos, consulte [Gerenciando Aplicativos 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.