top of page
bitmap.jpg
Rastrear
_edited.png

Criação de novos aplicativos de usuário

Ao configurar um novo aplicativo de usuário , você trabalhará com diversas configurações importantes que determinam como seu aplicativo externo se integra à plataforma. Vamos explorar cada componente essencial.


Comece clicando no

na lista de aplicativos do usuário . No formulário de configuração que aparecer, siga os passos abaixo:


  1. Configure o URL


Especifique o URL da sua aplicação – o endereço onde sua aplicação está hospedada; ele serve como base para a integração.

  • Certifique-se de que o URL seja válido, utilize uma conexão HTTPS, direcione para um recurso confiável e contenha no máximo 1000 caracteres.


  • Certifique-se de que o aplicativo tenha a configuração iFrame ativada, caso contrário, você não conseguirá abri-lo na interface da plataforma.

  1. 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á-lo ao final da URL. Expanda a descrição abaixo para saber mais sobre os parâmetros sugeridos e exemplos.

Entendendo alguns parâmetros basico para personalização

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


  1. ?user_id={user_identifier}

Parâmetro de contexto do usuário que passa 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 tempo 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 determinado valor para ele.

Exemplo de URL de aplicativo com parâmetros

Teste sua configuração para garantir que o aplicativo carregue corretamente. Clique

para exibir uma pré-visualização.

  1. Ajustar aparência

Crie uma identidade facilmente reconhecível para seu aplicativo, facilitando o acesso. As seguintes configurações ajudarão você a fazer isso:


  • Rótulo – Adicione um nome exclusivo e descritivo para seu aplicativo (até 24 caracteres). Ele será 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 ajudará seus usuários a compreender melhor a finalidade do aplicativo.


  • Ícone – Selecione um ícone que represente a função do seu aplicativo para uma navegação ainda mais intuitiva.


  1. Selecione o método de exibição

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


  • Incorporado – O aplicativo aparece dentro da interface da plataforma.


  • Nova guia – O aplicativo abre em uma guia separada do navegador.

Nossa plataforma utiliza iFrame para incorporação. Como nem todos os URLs podem ser processados ​​corretamente com essa tecnologia, certifique-se de visualizar o resultado da incorporação. Caso encontre algum problema com esse método de exibição, considere usar uma nova aba .

  1. Configurar autenticação (opcional)

Configure a autenticação se o 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 funcionalidades de login adicionais no seu aplicativo. Você pode escolher um dos dois métodos de autenticação:


  • Chave de API


  • Este método destina-se a aplicações onde a gestão de funções ou permissões de utilizador não são necessárias.


  • 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 rastreadores aos quais um usuário tem direitos limitados ou nenhum acesso, o uso da chave de API ainda exporá todos os rastreadores da conta principal.


  • Chave de sessão


  • Este método é recomendado quando se trata de gestão de funções.


  • Transmite a chave de sessão do usuário atual para o aplicativo.

Selecionar o método de chave de API desativará automaticamente o método de chave de sessão e vice-versa. Apenas um método pode ser usado por vez.

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


  • Se você selecionou uma chave de API , o valor do parâmetro conterá essa chave.


  • Se você optou por uma chave de sessão , o valor do parâmetro incluirá 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.


  1. Salve o novo aplicativo.

Clique no botão Salvar . Seu aplicativo aparecerá na lista de aplicativos do usuário e na barra lateral da plataforma. Os aplicativos habilitados ficam automaticamente disponíveis para os usuários da conta.

Exemplo de visualização de aplicativo de usuário incorporado
Exemplo de visualização de 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 o seguinte:


  • Abrir em uma nova aba em vez disso


  • Verificando se seu URL está correto 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 Gerenciando aplicativos de usuário existentes .

bottom of page