Pular para o conteúdo
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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 chrome_py0qhiu5p8.webp botão na Aplicações do usuário lista. No formulário de configuração exibido, siga as etapas a seguir:

1

Configurar a URL

Especifique a URL do seu aplicativo, o endereço onde ele está hospedado; ela serve como base para a integração.

2

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.

Entendendo os parâmetros de URL sugeridos

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

  1. ?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

  1. ?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.

Exemplo de URL do aplicativo com parâmetros

Teste sua configuração para garantir que o aplicativo carregue corretamente. Clique image-20241217-083119.png para exibir uma prévia.

3

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.

4

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

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.

5

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.

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.

Quando a autenticação está ativada, a plataforma adiciona o ?session_key= parâmetro à URL do seu aplicativo.

  • Se você selecionou uma Chave de APIchave de API, o valor do parâmetro contém essa chave.

  • Se você optou por uma Chave de sessãochave 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.

6

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.

Exemplo de visualização incorporada do aplicativo de usuário
Dicas rápidas de solução de problemas

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

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.

Atualizado

Isto foi útil?