Pular para o conteúdo principal

Integração Telegram

Integração nativa com Telegram para funções de autoatendimento e comodidade.

Conceito​

A integração permite que pessoas autorizadas acessem funções do ACCELERO diretamente pelo aplicativo Telegram:

  • Gerar convites de visita
  • Gerar QRCodes pessoais
  • Gerenciar eventos
  • Visitantes recorrentes
Sem Configuração

Integração é nativa e não exige configurações especiais do sistema.

Como Funciona​

Pessoas cadastradas no ACCELERO podem usar o BOT ACCELERO no Telegram para executar ações de forma totalmente autônoma.

Bot Accelero​

O que é:

  • Bot oficial do ACCELERO no Telegram
  • Interface conversacional
  • Comandos simples
  • Respostas automáticas

Como encontrar:

  • Entre em contato com suporte técnico IONGRADE
  • Eles fornecerão nome do bot correto para sua instalação

Configuração de Acesso​

Passo 1: Configurar Username​

A pessoa deve ter username no Telegram.

Como verificar/criar username no Telegram:

  1. Abra Telegram
  2. Vá em Settings/Configurações
  3. Edite perfil
  4. Defina username (ex: @joaosilva)

Passo 2: Cadastrar no ACCELERO​

Caminho: Cadastro > Pessoas > [Selecionar pessoa]

Campo: Usuário Telegram

Digite o username da pessoa (sem @).

Exemplo:

Username no Telegram: @joaosilva
Campo no ACCELERO: joaosilva

Passo 3: Liberar Permissões​

Caminho: Cadastro > Pessoas > [Selecionar pessoa]

Campo: Permissões Telegram

Opções disponíveis:

PermissãoPermite
Gerar convitesAgendar visitantes pelo Telegram
Gerar QRCodesGerar QRCode pessoal temporário

Marque as permissões desejadas.

Múltiplas Permissões

Pessoa pode ter uma ou ambas as permissões habilitadas.

Passo 4: Iniciar Conversa com Bot​

Pessoa deve:

  1. Pesquisar bot no Telegram
  2. Encontrar bot correto (fornecido pelo suporte)
  3. Clicar em "Iniciar" ou "Start"
  4. Bot responde com menu de opções
Iniciativa da Pessoa

Pessoa deve tomar iniciativa de iniciar conversa. Sistema não inicia conversas automaticamente.

Após esses 4 passos, pessoa terá acesso às funções Telegram!

Funções Disponíveis​

Acesse funções pelo menu no Telegram (ícone de menu próximo à barra de mensagens).

1. Gerar Convites​

Cria convites de visita através de conversa interativa.

Como funciona:

  1. Selecione "Gerar convites" no menu
  2. Bot faz perguntas:
    • Nome do visitante
    • Data da visita
    • Duração do evento
  3. Pessoa responde interativamente
  4. Bot cria visita no ACCELERO
  5. QRCode enviado automaticamente para visitante
  6. Tudo registrado em logs

Exemplo de conversa:

Bot: Qual o nome do visitante?
Você: Maria Silva

Bot: Qual a data da visita?
Você: 15/03/2026

Bot: Qual a duração?
Você: 2 horas

Bot: ✓ Visita agendada! QRCode enviado para Maria Silva.

Benefícios:

  • Agilidade total
  • Não precisa acessar computador
  • Visitante recebe QRCode imediatamente
  • Auditoria completa

2. Gerar QRCodes​

Gera QRCode pessoal temporário para a própria pessoa.

Quando usar:

  • Esqueceu cartão
  • Identificador perdido
  • Acesso emergencial

Como funciona:

  1. Selecione "Gerar QRCodes" no menu
  2. Bot gera QRCode imediatamente
  3. QRCode tem validade curta (segurança)
  4. Invalida qualquer QRCode anterior
  5. Apresente QRCode no leitor

Características:

  • Validade curta (ex: 30 minutos)
  • Uso único ou limitado
  • Invalida QRCodes anteriores da pessoa
  • Logs registram geração
Segurança

Validade curta evita uso indevido de QRCode. Use apenas quando necessário.

3. Gerenciar Eventos​

Cria eventos especiais (festas, reuniões) com convites individualizados.

Funcionalidade:

  1. Selecione "Gerenciar eventos" no menu
  2. Crie evento (festa, reunião, etc.)
  3. Bot gera links individualizados
  4. Compartilhe link com cada convidado
  5. Convidado preenche próprios dados
  6. Você recebe notificação via Telegram
  7. Autorize ou negue o convite
  8. Convidado recebe QRCode se autorizado

Fluxo detalhado:

Você: Criar evento "Festa Aniversário"

Bot: Evento criado! Links gerados:
  Link 1: https://...abc (Convidado 1)
  Link 2: https://...def (Convidado 2)
  ...

Você: Envia Link 1 para João

João: Acessa link, preenche dados

Bot → Você: João preencheu convite. Autorizar?

Você: Sim, autorizar

Bot → João: Convite autorizado! QRCode anexo.

Benefícios:

  • Cada link é individualizado
  • Convidado preenche próprios dados
  • Você decide autorizar ou não
  • Controle total
Link Único

Não compartilhe mesmo link com múltiplas pessoas. Cada convidado deve ter link próprio.

4. Visitantes Recorrentes​

Configura acessos recorrentes (diarista, personal, etc.).

Quando usar:

  • Diarista (toda terça e quinta)
  • Personal trainer (segundas, quartas, sextas)
  • Professor particular (diário)

Como funciona:

  1. Selecione "Visitantes recorrentes" no menu
  2. Digite dados do visitante
  3. Defina dias da semana
  4. Defina horários
  5. Bot cria eventos recorrentes
  6. Visitante recebe QRCode com validade estendida

Exemplo:

Bot: Nome do visitante?
Você: Ana Paula (diarista)

Bot: Quais dias?
Você: Terça e quinta

Bot: Horário?
Você: 08:00 às 12:00

Bot: ✓ Visita recorrente criada!
Ana terá acesso todas terças e quintas, 08:00-12:00.

Configuração de categorias:

Categorias associadas ao visitante recorrente são definidas previamente pelo administrador:

Caminho: Avançado > Sistema > Aplicativos - Telegram

Campo: "Tipo de evento para visitas"

Administrador configura qual tipo de evento (e categorias) serão usados para visitas recorrentes criadas pelo Telegram.

Boas Práticas​

  1. Configure permissões adequadamente: Nem todos precisam gerar convites

  2. Oriente sobre QRCodes temporários: Use apenas quando necessário

  3. Um link por convidado: Nunca compartilhe mesmo link com várias pessoas

  4. Treine usuários: Ensine uso correto das funções

  5. Monitore logs: Acompanhe convites gerados via Telegram

  6. Defina regras claras: Quando usar cada função

  7. Teste antes de liberar: Valide funcionamento com usuários piloto

Troubleshooting​

Bot não responde​

Causas:

  • Bot errado (não é o bot da sua instalação)
  • Não clicou em "Iniciar"
  • Username não configurado no ACCELERO

Solução: Verifique bot correto com suporte, inicie conversa, verifique cadastro

Funções não aparecem no menu​

Causa: Permissões não habilitadas no ACCELERO

Solução: Habilite permissões em "Permissões Telegram" no cadastro da pessoa

Username não encontrado​

Causas:

  • Username incorreto no ACCELERO
  • Pessoa mudou username no Telegram

Solução: Verifique e atualize username

QRCode gerado não funciona​

Causas:

  • QRCode expirou (validade curta)
  • Pessoa não tem permissões de acesso
  • Categoria expirada

Solução: Gere novo QRCode, verifique permissões e categorias

Segurança​

Controle de Acesso​

  • Apenas pessoas cadastradas e autorizadas
  • Permissões granulares (convites vs QRCodes)
  • Logs de todas as ações

QRCodes Temporários​

  • Validade curta
  • Invalida QRCodes anteriores
  • Reduz risco de uso indevido
  • Um link por pessoa
  • Não reutilizável
  • Rastreável

Notificação de Passagem​

O Telegram também pode ser utilizado para enviar notificações quando uma passagem é realizada por um controlador de acesso. Isso permite que moradores ou operadores recebam alertas em tempo real sobre movimentações relevantes.

Próximos Passos​