Pontos de integração compatíveis

O Flowlu permite que os aplicativos se integrem diretamente às principais áreas de sua interface. Os aplicativos aparecem em locais predefinidos chamados pontos de integração, e cada um define onde e como um aplicativo é renderizado dentro do Flowlu. Os pontos disponíveis estão listados abaixo.

Header (Cabeçalho)

Um aplicativo pode adicionar um único ícone ou botão à barra de navegação superior, usado para abrir a interface do aplicativo, exibir informações de status ou mostrar um pequeno menu suspenso de ações ou notificações. Para manter a interface organizada, é permitido apenas um elemento de cabeçalho por aplicativo. O ícone aparece automaticamente após a instalação, com uma dica de ferramenta (tooltip) ao passar o mouse, e é exibido apenas para usuários que têm acesso ao aplicativo.

Menu principal

Um aplicativo pode adicionar itens de navegação ao menu à esquerda, seja como um item de nível superior ou como um item dentro de uma seção existente, como o CRM. Ao selecionar o item, a interface do aplicativo é aberta no espaço de trabalho central.

A visibilidade do menu é gerenciada automaticamente: apenas usuários com acesso ao aplicativo veem seus itens. O menu é atualizado dinamicamente, de modo que a instalação de um aplicativo adiciona seu item imediatamente e a remoção do aplicativo o retira, sem a necessidade de reiniciar o portal.

Abas

Um aplicativo pode adicionar abas personalizadas a páginas de entidade existentes, como oportunidades de vendas, tarefas, projetos ou contatos. Por exemplo, um aplicativo pode adicionar uma aba "Analytics" a uma página de oportunidade de vendas para exibir dados adicionais.

O manifesto do aplicativo define o tipo de entidade de destino e atribui um identificador exclusivo a cada aba. Uma aba aparece apenas quando o aplicativo está instalado e o usuário tem acesso a ele.

Importante: o sistema monitora a unicidade — dois aplicativos diferentes não podem adicionar abas com o mesmo nome a um único objeto; isso é verificado durante a instalação.

Widgets (cartões)

Um aplicativo pode exibir widgets (cartões), blocos informativos colocados em várias partes da interface: páginas de entidade, quadros de tarefas, dashboards e visualizações de relatórios. Os widgets variam em tamanho e conteúdo, desde pequenos indicadores até blocos de dados maiores. Sua localização e conteúdo são definidos na seção cards do manifesto do aplicativo.

A plataforma fornece uma API para atualizar o conteúdo do widget em tempo real, permitindo que um aplicativo envie novos dados e faça com que um gráfico ou valor seja redesenhado sem a necessidade de recarregar a página.

Por exemplo, uma integração meteorológica pode exibir um cartão de "Clima Atual" dentro do portal, e um aplicativo financeiro pode mostrar um cartão com o saldo atual ou taxas de câmbio. Na maioria dos casos, os usuários podem controlar a visibilidade dos widgets, ocultando um widget ou adicionando-o ao seu dashboard pessoal.

Relatórios

Um aplicativo pode registrar um tipo de relatório personalizado no módulo de relatórios do Flowlu, usando dados externos ou seus próprios cálculos. Após a instalação, o tipo de relatório fica disponível para usuários com as permissões apropriadas.

Quando um relatório é gerado, o Flowlu solicita os dados ao aplicativo por meio de sua API. O aplicativo retorna um JSON padronizado (tabelas e conjuntos de dados) e define, através de um esquema, como os dados devem ser visualizados, para que o Flowlu possa renderizar tabelas e gráficos de forma consistente. O acesso segue as mesmas regras baseadas em funções de usuário dos relatórios nativos.

Dashboard

Um aplicativo pode adicionar widgets ao dashboard do usuário para mostrar resumos de alto nível, métricas ou visualizações. O manifesto do aplicativo define o tipo e o tamanho do widget e fornece os dados para exibição. Os usuários ativam ou desativam esses widgets nas configurações do dashboard, e widgets de vários aplicativos podem rodar juntos sem afetar o desempenho. O Flowlu os mantém atualizados por meio de sondagens (polling) periódicas ou atualizações push do aplicativo.

Aplicativo móvel

O Flowlu possui um cliente móvel, e os aplicativos podem se integrar a ele quando o suporte móvel é declarado no manifesto do aplicativo. Um aplicativo suportado pode adicionar um item de navegação ou uma tela na interface móvel, ou um widget no dashboard móvel.

A integração móvel é implementada por meio de um WebView: o Flowlu abre a página web responsiva do aplicativo dentro do cliente móvel e passa o contexto, como o token do usuário. Se um aplicativo não suportar o uso móvel, seus elementos serão ocultados ou marcados como apenas para desktop. Recomendamos fornecer pelo menos um suporte móvel básico para que seu aplicativo alcance o maior público possível.

Módulo de comunicações

Um aplicativo pode se integrar ao módulo de Comunicações do Flowlu para estender os recursos de mensagens e comunicação, por exemplo, adicionando suporte para canais adicionais ou conectando serviços de comunicação externos.

Essas integrações precisam de configuração extra e seguem requisitos de segurança mais rigorosos, dada a natureza sensível dos dados de comunicação. Um aplicativo que se integre ao módulo de Comunicações deve cumprir todas as regras de segurança e permissão da plataforma.

Como funcionam os pontos de integração

Os pontos de integração são gerenciados de forma modular. Quando um aplicativo é instalado, o Flowlu lê as seções relevantes de seu manifesto do aplicativo e incorpora automaticamente o aplicativo nos locais corretos. Esse design permite que o Flowlu adicione novos pontos de integração ao longo do tempo sem alterações na arquitetura principal; os aplicativos adotam um novo local simplesmente atualizando seu manifesto do aplicativo quando este estiver disponível.