Integração Accelero Visitas
A integração Accelero Visitas conecta o ACCELERO ao aplicativo Accelero Visitas, voltado à gestão de visitas em condomínios e empresas. Pelo app, anfitriões (moradores ou colaboradores) cadastram e aprovam visitantes; o ACCELERO recebe esses agendamentos, cria os eventos de visita, mantém o cadastro do visitante e gera o QR Code usado na entrada. O ACCELERO também devolve ao app o status da visita (check-in e passagens) em tempo real.
Esta integração é disponibilizada como plugin (accelerovisitas) e precisa ser instalada e habilitada pela equipe técnica da IONGRADE. Consulte o suporte para verificar compatibilidade com a sua versão do ACCELERO.
Versão atual do plugin: 1.4.0 — compatível com ACCELERO 2.17.0 ou superior.
O que a integração faz
O plugin estabelece um canal bidirecional entre o ACCELERO e o aplicativo Accelero Visitas. O app é responsável pela experiência do anfitrião e do visitante; o ACCELERO continua sendo a fonte de verdade do controle de acesso (eventos, pessoas, cartões e QR Codes).
| Funcionalidade | O que acontece no ACCELERO |
|---|---|
| Criação de visitas | O app envia uma visita e o ACCELERO cria o evento, faz o upsert do visitante e vincula visitante e visitado (unidade/empresa) |
| Visitas recorrentes | O app envia uma visita recorrente (data inicial, data final e dias da semana) e o ACCELERO registra o evento recorrente correspondente |
| QR Code de acesso | O ACCELERO gera (ou reaproveita) o QR Code dinâmico do visitante, válido até a data fim da visita |
| Atualização de status da visita | O app pode atualizar o status da visita no ACCELERO; o ACCELERO devolve ao app eventos de check-in, entrada e saída |
| Departamentos e aprovadores | O ACCELERO organiza empresas em departamentos e vincula operadores (aprovadores) a esses departamentos, sincronizados com o app |
| Provisionamento de usuários do app | Operadores do ACCELERO podem ser criados ou removidos como usuários do Accelero Visitas |
| Consulta de empresas e tipos de evento | O app consulta as empresas (unidades) e os tipos de evento habilitados para a integração |
Permite que moradores e colaboradores gerenciem suas próprias visitas pelo aplicativo, com o ACCELERO controlando o acesso físico e o QR Code de entrada — sem cadastro manual de cada visitante na portaria.
Configuração
Caminho de acesso: Configurações > Integrações - AcceleroVisitas
A tela possui uma aba: Geral.
Tela de configuração Configurações > Integrações - AcceleroVisitas, aba Geral, mostrando os campos de Dados da integração, o Tipo de evento padrão, a chave Sobrescrever dados de pessoas existentes e os botões Salvar e Sincronizar tudo.
Dados da integração
| Campo | Descrição |
|---|---|
| Operador | Operador do ACCELERO usado pela integração como responsável pelos eventos criados a partir do app |
| Token de autenticação (APP > Accelero) | Token que o aplicativo usa para autenticar as chamadas recebidas pelo ACCELERO |
| Token de autenticação (Accelero > APP) | Token usado pelo ACCELERO para autenticar as notificações enviadas ao aplicativo |
| URL AcceleroVisitas | Endpoint do serviço Accelero Visitas para onde o ACCELERO envia as notificações |
Tipo de evento
| Campo | Descrição |
|---|---|
| Tipo de evento padrão | Tipo de evento usado ao criar uma visita quando o app não informa um tipo específico |
Opções
| Campo | Descrição |
|---|---|
| Sobrescrever dados de pessoas existentes | Quando ativo, os dados do visitante (nome, documento, foto, telefone, e-mail) enviados pelo app sobrescrevem o cadastro de uma pessoa já existente. Quando inativo, pessoas já cadastradas não têm seus dados alterados |
Botões da tela
| Botão | Função |
|---|---|
| Salvar | Persiste a configuração |
| Sincronizar tudo | Dispara a sincronização em massa de empresas, departamentos e aprovadores com o Accelero Visitas (ver Sincronização em massa) |
Os tokens de autenticação e a URL do Accelero Visitas são definidos durante a implantação. Mantenha-os em sigilo — eles autorizam a criação de visitas e o envio de notificações.
Departamentos
O plugin adiciona a entidade Departamentos, usada para segmentar empresas (unidades) e organizar quais aprovadores atuam em cada setor. Os departamentos são sincronizados com o Accelero Visitas.
Caminho de acesso: Configurações > Departamentos
Listagem de Departamentos (Configurações > Departamentos), mostrando as colunas Código e Descrição do Departamento, o botão Novo Departamento e a busca.
Campos do departamento
| Campo | Descrição |
|---|---|
| Código | Código identificador do departamento |
| Descrição do Departamento | Nome/descrição do departamento |
Vínculo de departamentos a empresas
Na edição de uma Empresa, o plugin adiciona a aba Departamentos, onde se associam departamentos àquela empresa.
Edição de Empresa com a aba Departamentos aberta, mostrando a associação de departamentos à empresa (inclusão inline e listagem).
Vínculo de operadores a departamentos
Na edição de um Operador, o plugin adiciona a aba Departamentos, onde o operador é vinculado a uma empresa e a um departamento — definindo onde ele atua como aprovador de visitas.
Edição de Operador com a aba Departamentos aberta, mostrando a inclusão do vínculo Empresa + Departamento e a listagem dos vínculos existentes.
A gestão de departamentos e seus vínculos é controlada pela permissão Departamentos - Gerenciar (depManager), atribuível aos perfis de operador.
Campos adicionados às entidades
Operador
Além da aba Departamentos, a edição de operador ganha a seção Accelero Visitas, com ações de provisionamento do usuário no aplicativo:
Seção Accelero Visitas na edição de operador, mostrando os botões Criar usuário no Accelero Visitas e Deletar usuário no Accelero Visitas.
| Ação | Efeito |
|---|---|
| Criar usuário no Accelero Visitas | Provisiona o operador como usuário no aplicativo (processado de forma assíncrona) |
| Deletar usuário no Accelero Visitas | Remove o usuário correspondente no aplicativo (processado de forma assíncrona) |
Empresa
A edição de empresa recebe a aba Departamentos para associação de departamentos (ver Departamentos).
Tipo de Evento
Na edição de um Tipo de Evento, o plugin adiciona a seção Accelero Visitas com a opção:
Seção Accelero Visitas na edição de Tipo de Evento, mostrando a chave Deseja utilizar esse tipo de evento na integração?.
| Campo | Descrição |
|---|---|
| Deseja utilizar esse tipo de evento na integração? | Marca o tipo de evento como disponível para a integração. Apenas tipos de evento habilitados aparecem como opção no aplicativo |
Fluxos da integração
Os fluxos abaixo são acionados pelo aplicativo Accelero Visitas por meio de chamadas autenticadas ao ACCELERO. Não há telas próprias para eles no ACCELERO — eles refletem o comportamento do plugin.
Criação de visita
Ao receber uma visita do app, o ACCELERO:
- Localiza a unidade (empresa) informada como visitado;
- Faz o upsert do visitante (cria a pessoa se não existir; atualiza nome, documento, tipo de documento, telefone, e-mail e foto conforme a opção Sobrescrever dados de pessoas existentes);
- Cria o evento com a data de início e fim informadas, usando o tipo de evento enviado ou o Tipo de evento padrão;
- Vincula visitante e visitado ao evento e dispara, quando aplicável, a notificação ao convidado.
A criação de visita exige, no mínimo: dados do evento (identificador, data de início e data de fim), do visitante (nome, documento, telefone e foto) e do visitado (unidade). Cadastros incompletos são rejeitados.
Visita recorrente
Para visitas recorrentes, o app envia, além dos dados do evento e das pessoas, os dias da semana e o período (data inicial e data final). O ACCELERO registra o evento recorrente correspondente. O QR Code é gerado a partir desse evento recorrente, válido até a data final.
QR Code de acesso
O ACCELERO gera um QR Code dinâmico para o visitante, válido até a data fim da visita (ou da recorrência). Se já houver um cartão/QR Code válido e habilitado vinculado àquela visita, ele é reaproveitado; caso contrário, um novo é gerado.
Diagrama do fluxo de uma visita: app cria a visita → ACCELERO cria evento e visitante → ACCELERO gera QR Code → visitante apresenta o QR Code na portaria → ACCELERO notifica o app (check-in / entrada / saída).
Notificações de status para o app
O ACCELERO devolve ao Accelero Visitas, em tempo real, os seguintes eventos da visita:
| Evento | Quando ocorre |
|---|---|
| Check-in | Quando o check-in do convidado é realizado |
Entrada (entry) | Quando o visitante passa por um canal de entrada |
Saída (exit) | Quando o visitante passa por um canal configurado como baixa de visita |
Passagens em canais configurados como check-in não geram notificação de entrada/saída para o app.
Atualização de status pelo app
O aplicativo pode atualizar o status de uma visita no ACCELERO (por exemplo, cancelamento). O ACCELERO localiza a visita pelo identificador do app e aplica o novo status ao vínculo evento-pessoa correspondente.
Sincronização em massa
O botão Sincronizar tudo, na tela de configuração, envia ao Accelero Visitas o conjunto atual de empresas, seus departamentos e os aprovadores (operadores vinculados a departamentos).
A sincronização monta:
- Empresas com seus departamentos associados;
- Aprovadores — operadores vinculados a pares válidos de empresa + departamento, com nome, e-mail, documento e telefone.
A sincronização só envia dados quando existem vínculos operador-departamento e ao menos uma empresa com departamento associado. Sem vínculos, nada é enviado.
Use Sincronizar tudo após criar/alterar departamentos, vincular novos aprovadores ou associar departamentos a empresas, para refletir essas mudanças no aplicativo.
Casos de uso
Habilitar a integração
- Solicitar à IONGRADE a instalação do plugin
accelerovisitas. - Em
Configurações > Integrações - AcceleroVisitas, preencher Operador, os dois tokens de autenticação, a URL AcceleroVisitas e o Tipo de evento padrão. - Definir, em cada Tipo de Evento desejado, a opção Deseja utilizar esse tipo de evento na integração?.
- Cadastrar Departamentos e associá-los às empresas e aos operadores aprovadores.
- Clicar em Sincronizar tudo para enviar empresas, departamentos e aprovadores ao app.
Provisionar um aprovador no aplicativo
- Editar o Operador que será aprovador.
- Na aba Departamentos, vincular o operador à empresa e ao departamento corretos.
- Na seção Accelero Visitas, clicar em Criar usuário no Accelero Visitas.
Receber uma visita agendada pelo app
- O anfitrião agenda a visita no aplicativo.
- O ACCELERO cria o evento e o cadastro do visitante automaticamente.
- O visitante recebe/apresenta o QR Code na portaria.
- Na passagem, o ACCELERO notifica o app com o evento de entrada e, na baixa, de saída.
Boas práticas
- Operador de integração dedicado: use um operador específico como responsável pelos eventos criados pela integração, em vez de uma conta nominal.
- Tipos de evento explícitos: habilite na integração apenas os tipos de evento realmente usados para visitas pelo app.
- Manter vínculos atualizados: sempre que mudar departamentos ou aprovadores, rode Sincronizar tudo.
- Avaliar a sobrescrita de dados: use Sobrescrever dados de pessoas existentes com cautela — ela substitui dados de cadastros já existentes pelos dados vindos do app.
Troubleshooting
Visitas do app não são criadas no ACCELERO
Possíveis causas:
- Unidade (empresa) informada pelo app não existe no ACCELERO;
- Dados obrigatórios do visitante ou do evento ausentes;
- Token de autenticação (APP > Accelero) incorreto.
Solução:
- Confirme que a empresa/unidade existe no cadastro de Empresas.
- Verifique se o app envia nome, documento, telefone e foto do visitante e as datas do evento.
- Revise o Token de autenticação (APP > Accelero) na configuração.
Tipos de evento não aparecem no app
Possíveis causas:
- Tipo de evento sem a opção Deseja utilizar esse tipo de evento na integração? marcada.
Solução:
- Edite o Tipo de Evento e habilite a opção na seção Accelero Visitas.
App não recebe entrada/saída
Possíveis causas:
- Canal de passagem configurado como check-in (não notifica entrada/saída);
- URL AcceleroVisitas ou token (Accelero > APP) incorretos;
- Visita sem o identificador da integração vinculado.
Solução:
- Verifique a configuração do canal do controlador.
- Revise URL AcceleroVisitas e o Token de autenticação (Accelero > APP).
Sincronização não envia dados
Possíveis causas:
- Nenhum vínculo operador-departamento cadastrado;
- Nenhuma empresa com departamento associado.
Solução:
- Cadastre departamentos, associe-os às empresas e vincule operadores aos departamentos.
- Rode Sincronizar tudo novamente.
Integração com outros módulos
Empresas
As empresas funcionam como unidades visitadas e são segmentadas por departamentos. Consulte Empresas.
Operadores
Operadores atuam como aprovadores, vinculados a empresas e departamentos, e podem ser provisionados como usuários do aplicativo.
Pessoas
Cada visitante recebido do app gera ou atualiza um cadastro em Pessoas.
Eventos
As visitas são registradas como Eventos (inclusive recorrentes), usando os tipos de evento habilitados para a integração.
Logs e Eventos
As passagens físicas do visitante alimentam as notificações de entrada/saída enviadas ao app. Consulte Logs e Monitoramento.
Próximos Passos
- Empresas — Cadastre as unidades visitadas e associe departamentos
- Operadores — Vincule aprovadores a empresas e departamentos
- Pessoas — Entenda o cadastro de visitantes
- Eventos — Entenda os eventos e tipos de evento de visita
- Plugins — Saiba mais sobre o sistema de plugins do ACCELERO