Integração SigmaApp
Integração nativa do ACCELERO com o aplicativo SigmaApp, usado por moradores/responsáveis para agendar visitas e liberar visitantes. Pelo app, a visita é agendada; o ACCELERO gera o QRCode de acesso do visitante e, à medida que a passagem acontece, informa o SigmaApp o andamento da visita.
SigmaApp é um módulo licenciado (categoria Integrações). A tela de configuração e a integração só ficam disponíveis quando o módulo sigmaapp está habilitado na licença. Ver Licenciamento.
Como funciona
A integração é bidirecional:
- Do SigmaApp para o ACCELERO: o app cadastra/atualiza visitantes e agenda visitas, e solicita o QRCode da visita atual do visitante. Essas chamadas são autenticadas pelo Access Key configurado (enviado no cabeçalho
ACCESSKEYde cada requisição). - Do ACCELERO para o SigmaApp: a cada passagem de acesso registrada, o ACCELERO atualiza a visita no SigmaApp, sinalizando quando ela foi iniciada e quando foi concluída (baixa da visita).
Cada visita agendada no SigmaApp vira um evento no ACCELERO. O tipo de evento aplicado depende do mapeamento configurado (ver abaixo), e o visitante recebe um QRCode para apresentar na entrada.
Configuração
Caminho de acesso: Configurações > Aplicativos - SigmaApp
A tela de configuração tem duas abas: Geral e Tipos de evento.
Tela Configurações > Aplicativos - SigmaApp, aba Geral, mostrando os campos Operador, Exigir escort de novos visitantes, Token de autenticação (Access Key) e URL SigmaApp.
Aba Geral
| Campo | Obrigatório | Descrição |
|---|---|---|
| Operador | Sim | Operador em nome do qual os eventos de visita são criados no ACCELERO |
| Exigir escort de novos visitantes | — | Quando ligado, os visitantes criados pela integração já entram marcados para exigir escort |
| Token de autenticação (Access Key) | Sim | Chave que autentica as chamadas entre o SigmaApp e o ACCELERO. Deve coincidir com a chave configurada no SigmaApp |
| URL SigmaApp | Sim | Endereço da API do SigmaApp que o ACCELERO aciona para atualizar as visitas |
Aba Tipos de evento
Nesta aba você define o mapeamento de tipos de evento globais: para cada categoria de visita do SigmaApp, escolha o tipo de evento correspondente no ACCELERO. Todos são obrigatórios.
| Categoria no SigmaApp | Campo | Mapeia para |
|---|---|---|
| Visita | Evento SigmaApp "Visita" | Um tipo de evento do ACCELERO |
| Evento | Evento SigmaApp "Evento" | Um tipo de evento do ACCELERO |
| Prestação de serviço | Evento SigmaApp "Prestação de serviço" | Um tipo de evento do ACCELERO |
| Outro | Evento SigmaApp "Outro" | Um tipo de evento do ACCELERO |
Cadastre em Eventos os tipos que representarão cada categoria (por exemplo, um tipo "Visita" e um "Prestação de serviço") antes de fazer o mapeamento.
Mapeamento por empresa/divisão
Além do mapeamento global, cada empresa/divisão pode ter seu próprio mapeamento de tipos de evento, sobrescrevendo o global apenas para ela. Na edição da empresa/divisão, a seção Mapeamento de tipos de evento repete as quatro categorias (Visita, Evento, Prestação de serviço, Outro); deixe em branco para herdar o mapeamento global.
Ver Empresas para o cadastro de empresas e divisões.
Sincronização de moradores
Uma pessoa do ACCELERO pode ser sincronizada como morador no SigmaApp. A sincronização é feita na edição da pessoa.
Caminho de acesso: Pessoas > Todas > [editar pessoa] > SigmaApp
- Sincronizar SigmaApp — cria o morador no SigmaApp e guarda o token do morador retornado no cadastro da pessoa.
- Remover SigmaApp — desfaz a sincronização (o morador é marcado como removido no SigmaApp) e limpa o token.
Para sincronizar, a pessoa precisa de um telefone celular com exatamente 11 dígitos (DDD + número). Sem isso, a sincronização é recusada.
Uma pessoa sincronizada com o SigmaApp não pode ser excluída diretamente — faça a remoção da sincronização antes. O campo SigmaApp - Morador token é apenas para consulta; alterá-lo manualmente pode quebrar a integração.
Seção SigmaApp na edição da pessoa, mostrando os botões Sincronizar/Remover SigmaApp e o campo Morador token.
Fluxo típico
- O morador agenda a visita pelo SigmaApp e informa os dados do visitante.
- O SigmaApp envia o agendamento ao ACCELERO, que cria o evento de visita usando o tipo de evento mapeado para a categoria.
- O visitante recebe o QRCode da visita para apresentar na entrada.
- Na chegada, a passagem é validada e o acesso liberado; se a opção estiver ligada, o visitante exige escort.
- O ACCELERO notifica o SigmaApp que a visita foi iniciada e, ao final, que foi concluída.
Boas práticas
- Alinhe o Access Key nos dois lados: o token configurado no ACCELERO precisa ser o mesmo esperado pelo SigmaApp, senão as chamadas são rejeitadas.
- Mapeie todos os tipos de evento: as quatro categorias são obrigatórias no mapeamento global; use o mapeamento por empresa/divisão apenas quando alguma unidade precisar de tipos diferentes.
- Padronize o telefone dos moradores: garanta o celular com 11 dígitos antes de sincronizar.
- Decida sobre o escort: ative Exigir escort de novos visitantes se a política do cliente pedir acompanhamento de visitantes.