IoT Device Setup

🤖 Explicar com IA

Este guia cobre a configuracao e gestao de integracoes IoT para o 4Geeks Perks, permitindo rastreamento em tempo real e resgate automatizado de beneficios atraves de dispositivos conectados.

Recurso Premium

Integracoes IoT estao disponiveis exclusivamente no plano Premium.

Visao Geral¶

O 4Geeks Perks suporta varios dispositivos IoT para criar uma experiencia de resgate de beneficios fluida e sem toque:

Maquinas Vending: Rastreie consumo de lanches e bebidas em tempo real
Estacoes de Cafe: Monitore uso de cafe e automatize alertas de reabastecimento
Mercados Autoatendimento: Varejo sem atendimento 24/7 com checkout automatizado
Leitores RFID: Habilite autenticacao e pagamento baseados em cartao em todos os pontos IoT
Armarios Inteligentes: Entrega segura de pacotes e retirada de beneficios

Dispositivos Suportados¶

Maquinas Vending¶

O 4Geeks Perks se integra com maquinas vending inteligentes que suportam:

Leitores de cartao RFID
Sistemas de pagamento sem dinheiro
Rastreamento de estoque
Monitoramento remoto
Dados de vendas em tempo real

Marcas Compatíveis: - Crane Merchandising Systems - Automatic Products International (API) - Seaga Manufacturing - TCN Vending - Solucoes personalizadas (via API)

Estacoes de Cafe¶

Sistemas inteligentes de cafe e bebidas com:

Autenticacao RFID
Rastreamento de uso
Analytics de consumo
Monitoramento automatico de suprimentos
Metricas de qualidade

Sistemas Compatíveis: - Maquinas profissionais Jura - Sistemas de cafe Franke - Cafe de vending Necta - Maquinas personalizadas habilitadas por IoT

Mercados Autoatendimento¶

Espacos de varejo sem atendimento com:

Entrada controlada por RFID
Prateleiras inteligentes com sensores de peso
Visao computador para reconhecimento de produtos
Checkout automatizado
Gestao de estoque em tempo real

Solucoes Suportadas: - Parceiros de tecnologia Amazon Just Walk Out - Micro-mercados padrao com entrada por RFID - Configuracoes de varejo inteligente personalizadas

Leitores RFID¶

Leitores RFID independentes para resgate de beneficios:

Leitores HID Global
Leitores AWID
Leitores multi-TEcnologia (RFID + NFC)
Leitores de mesa USB para uso administrativo

Pre-requisitos¶

Antes de configurar integracoes IoT:

Plano Premium: Garanta que sua conta tenha acesso Premium
Infraestrutura de Rede:
Conexao internet estavel nos locais dos dispositivos
Conectividade Wi-Fi ou Ethernet
Largura de banda adequada para transmissao de dados em tempo real
Alimentacao Eletrica: Conexao eletrica confiavel para todos os dispositivos
Espaco Fisico: Localizacao apropriada com seguranca adequada
Aprovacao de TI: Coordene com seu departamento de TI para acesso a rede

Configurando Integracao com Maquina Vending¶

Passo 1: Preparacao do Dispositivo¶

Garanta que a maquina vending tenha:
Modulo controlador IoT instalado
Conectividade de rede configurada
Leitor RFID anexado (se nao for integrado)
Firmware atualizado para a versao mais recente
Teste a funcionalidade basica:
Distribuicao de produtos
Processamento de pagamento
Comunicacao de rede
Leitura de cartao RFID

Passo 2: Registrar Dispositivo no 4Geeks Perks¶

Faca login no 4Geeks Console
Navege ate Perks > IoT Devices > Add Device
Selecione o tipo de dispositivo: Vending Machine
Preencha os detalhes do dispositivo:
Nome do dispositivo: Nome descritivo (ex.: “Building A - Floor 2 Vending”)
Localizacao: Localizacao fisica
Numero de serie: Numero de serie do fabricante
Endereco MAC: Identificador de rede
Endereco IP: IP atual (se estatico)
Escolha o metodo de integracao:
API Direta: Para maquinas vending inteligentes com API nativa
Middleware: Para maquinas que requerem traducao de protocolo
Sincronizacao manual: Para maquinas basicas com conectividade limitada
Clique em Register

Passo 3: Configurar Integracao¶

Apos o registro, clique em Configure no dispositivo
Configure a conexao API:
Endpoint da API: URL da API da maquina vending
Autenticacao: Chave de API ou credenciais OAuth
Intervalo de polling: Frequencia de sincronizacao de dados (recomendado: 5 minutos)
Mapeie os produtos:
Importe o catalogo de produtos da maquina vending
Atribua categorias de beneficios (lanches, bebidas, opcoes saudaveis)
Defina precos e regras de subsidio
Configure regras de resgate:
Metodo de pagamento: Pontos da carteira, cartao RFID ou hibrido
Limites diarios: Maximo de transacoes por funcionario
Funcionarios elegiveis: Quem pode usar esta maquina
Teste a conexao:
Clique em Test Connection
Verifique se os dados fluem corretamente
Execute uma transacao de teste
Clique em Save and Activate

Passo 4: Configuracao de Funcionarios¶

Notifique os funcionarios sobre o novo beneficio da maquina vending
Garanta que todos os funcionarios tenham:
Conta ativa do 4Geeks Perks
Cartao RFID ativado
Saldo suficiente na carteira
Forneça instrucoes de uso:
Aproxime-se da maquina vending
Toque o cartao RFID no leitor
Selecione o produto
Confirme o resgate
Retire o produto

Configurando Integracao com Estacao de Cafe¶

Passo 1: Preparacao da Maquina¶

Garanta que a maquina de cafe tenha:
Modulo IoT instalado
Conectividade de rede
Leitor RFID (integrado ou externo)
Linhas de agua e suprimentos conectadas
Configure as configuracoes da maquina:
Tipos de bebidas disponiveis
Tamanhos de xicara
Preferencias de temperatura
Agenda de manutencao

Passo 2: Registrar Estacao de Cafe¶

Va em Perks > IoT Devices > Add Device
Selecione o tipo de dispositivo: Coffee Station
Preencha os detalhes:
Nome do dispositivo: (ex.: “Main Break Room Coffee”)
Localizacao: Sala ou area especifica
Modelo da maquina: Fabricante e modelo
Numero de serie: Para rastreamento de garantia
Escolha o metodo de integracao:
API Direta: Para maquinas inteligentes
Gateway IoT: Para maquinas com conectividade basica
Clique em Register

Passo 3: Configurar Beneficio de Cafe¶

Clique em Configure no dispositivo registrado
Configure o catalogo de bebidas:
Espresso, americano, cappuccino, etc.
Opcoes de cha e chocolate quente
Bebidas frias (se aplicavel)
Defina a precificacao:
Gratis para todos os funcionarios
Subsidiado (ex.: empresa paga 80%)
Deducao de pontos da carteira
Limites diarios (ex.: 3 bebidas por dia)
Configure o rastreamento de uso:
Rastreie consumo por funcionario
Monitore horarios de pico
Defina alertas de reabastecimento
Habilite notificacoes:
Avisos de estoque baixo
Lembretes de manutencao
Alertas de limite de uso
Teste a configuracao:
Execute um resgate de teste
Verifique se o rastreamento funciona
Verifique a entrega de notificacoes
Clique em Save and Activate

Configurando Mercado Autoatendimento¶

Passo 1: Infraestrutura do Mercado¶

Mercados autoatendimento requerem uma configuracao mais extensa:

Configuracao Fisica:
Sala segura ou area fechada
Sistema de entrada com porteiro RFID
Prateleiras inteligentes ou cameras de visao computador
Estacao de checkout (opcional para totalmente automatizado)
Pilha Tecnologica:
Sistema de controle de acesso
Sistema de rastreamento de estoque
Integracao de processamento de pagamento
Cameras de seguranca

Passo 2: Registrar Mercado¶

Va em Perks > IoT Devices > Add Device
Selecione o tipo de dispositivo: Self-Serve Market
Preencha os detalhes:
Nome do mercado: (ex.: “Building B Micro-Market”)
Localizacao: Endereco completo e sala
Horario de funcionamento: 24/7 ou horarios especificos
Capacidade: Maximo de usuarios simultaneos
Configure o controle de acesso:
Vincule ao sistema de porteiro RFID
Defina o metodo de autenticacao de entrada
Defina procedimentos de sobressaente de emergencia
Clique em Register

Passo 3: Configurar Catalogo de Produtos¶

Clique em Configure no mercado
Importe o inventario de produtos:
Faca upload de CSV com lista de produtos
Escaneie codigos de barras para importacao automatica
Entrada manual para catalogos pequenos
Categorize os produtos:
Lanches
Bebidas
Refeicoes
Cuidados pessoais
Material de escritorio
Defina precos e subsidios:
Preco cheio
Taxa com desconto
Apenas pontos da carteira
Mix de metodos de pagamento
Configure o rastreamento de estoque:
Defina limites de reposicao
Defina informacoes do fornecedor
Habilite alertas de reposicao automatica
Teste o sistema:
Entre com cartao RFID
Selecione produtos
Complete o checkout
Verifique a atualizacao do estoque
Verifique a deducao da carteira
Clique em Save and Activate

Configuracao de Leitor RFID¶

Leitores RFID Independentes¶

Para locais sem dispositivos IoT completos:

Compre um leitor RFID compativel
Conecte a rede:
USB para computador local
Ethernet para rede
Configuracao Wi-Fi
Registre no 4Geeks Perks:
Va em Perks > IoT Devices > Add Device
Selecione RFID Reader
Insira detalhes do dispositivo
Configure o endpoint
Teste a leitura de cartao:
Toque o cartao RFID do funcionario
Verifique a identificacao do funcionario
Confirme o acesso a carteira
Implante no local

Configuracao do Leitor RFID¶

Defina o modo do leitor:
Apenas autenticacao: Verificar identidade
Pagamento habilitado: Processar deducoes da carteira
Rastreamento de tempo: Registrar horarios de entrada/saida
Configure a seguranca:
Configuracoes de criptografia
Alertas contra adulteracao
Comportamento em modo offline
Configure notificacoes:
Status da conexao
Alertas de erro
Relatorios de uso

Monitorando Dispositivos IoT¶

Painel de Dispositivos¶

Va em Perks > IoT Devices > Dashboard
Visualize todos os dispositivos conectados:
Status online/offline
Horario da ultima comunicacao
Contagem de transacoes (hoje/mes)
Status de erro
Filtre por:
Tipo de dispositivo
Localizacao
Status
Edificio

Detalhes do Dispositivo¶

Clique em qualquer dispositivo para ver: - Status em tempo real - Historico de transacoes - Niveis de estoque (se aplicavel) - Agenda de manutencao - Logs de erro - Metricas de desempenho

Alertas e Notificacoes¶

Configure alertas para: - Dispositivo offline: Notificacao imediata - Estoque baixo: Avisos baseados em limite - Uso alto: Deteccao de atividade incomum - Manutencao pendente: Lembretes agendados - Erro detectado: Alertas de mau funcionamento do sistema

Configure em Perks > IoT Devices > Alerts

Solucao de Problemas¶

Dispositivo Offline¶

Verifique conexoes fisicas:
Alimentacao eletrica
Cabo de rede
Status do roteador/switch
Verifique a conectividade de rede:
Faca ping no IP do dispositivo
Verifique regras de firewall
Confirme a resolucao DNS
Reinicie o dispositivo:
Ciclo de energia
Aguarde 2 minutos
Verifique se volta ao online
Se ainda estiver offline:
Verifique os logs do dispositivo
Contate o fabricante do dispositivo
Entre em contato com o suporte da 4Geeks

Falhas em Transacoes¶

Verifique a elegibilidade do funcionario:
Status da conta ativa
Saldo suficiente na carteira
Beneficio habilitado para o funcionario
Verifique o status do dispositivo:
Online e responsivo
Sem estados de erro
Transacoes recentes bem-sucedidas
Revise os logs de transacoes:
Va em Perks > Transactions
Filtre por dispositivo e tempo
Identifique codigos de erro
Solucoes comuns:
Repita a transacao
Ressincronize os dados do dispositivo
Atualize o firmware do dispositivo

Seguranca¶

Seguranca de Rede¶

Use VLAN dedicada para dispositivos IoT
Implemente regras de firewall restringindo comunicacao de dispositivos
Habilite criptografia WPA3 para dispositivos Wi-Fi
Atualize regularmente o firmware dos dispositivos
Monitore trafego de rede para anomalias

Seguranca de Dados¶

Todos os dados transmitidos via TLS 1.3
Dados de funcionarios criptografados em repouso
Auditorias de seguranca regulares
Conformidade com GDPR e leis locais de privacidade
Timeouts automaticos de sessao

Seguranca Fisica¶

Instale dispositivos em areas monitoradas
Use selos de adulteracao visivel
Implemente controles de acesso para manutencao
Inspecoes fisicas regulares
Documente todas as atividades de manutencao

Integracao com API¶

Para solucoes IoT personalizadas, o 4Geeks Perks fornece APIs REST:

Autenticacao¶

POST /api/v1/auth/token
Content-Type: application/json

{
  "client_id": "your_client_id",
  "client_secret": "your_client_secret",
  "grant_type": "client_credentials"
}

Registrar Dispositivo¶

POST /api/v1/iot/devices
Authorization: Bearer {token}
Content-Type: application/json

{
  "device_type": "vending_machine",
  "name": "Building A Vending",
  "location": "Floor 2, Break Room",
  "serial_number": "VM-12345",
  "integration_method": "api",
  "api_endpoint": "https://vending-api.example.com"
}

Reportar Transacao¶

POST /api/v1/iot/transactions
Authorization: Bearer {token}
Content-Type: application/json

{
  "device_id": "device_uuid",
  "employee_id": "employee_uuid",
  "product_id": "product_uuid",
  "amount": 150,
  "currency": "points",
  "timestamp": "2026-04-24T10:30:00Z"
}

Veja documentacao completa da API

Manutencao¶

Tarefas de Manutencao Regulares¶

Diario: - Revise o painel de status do dispositivo - Verifique alertas de erro - Monitore taxas de sucesso de transacoes

Semanalmente: - Revise niveis de estoque - Verifique analytics de uso - Confirme a sincronizacao de dados

Mensalmente: - Inspecao fisica do dispositivo - Verificacao de atualizacao de firmware - Revisao de auditoria de seguranca - Otimizacao de desempenho

Trimestralmente: - Auditoria abrangente do sistema - Revisao de seguranca de rede - Calibracao do dispositivo (se necessario) - Revisao de desempenho do fornecedor

Atualizacoes de Firmware¶

Verifique atualizacoes em Perks > IoT Devices > Updates
Revise as notas de lancamento
Agende a atualizacao durante horarios de pouco uso
Faca backup da configuracao do dispositivo
Aplique a atualizacao
Teste a funcionalidade
Monitore por 24 horas

Suporte¶

Documentacao: Guias do 4Geeks Perks
Suporte Tecnico: iot-support@4geeks.io
Compatibilidade de Dispositivos: Verifique a lista de compatibilidade ou contate vendas
Integracao Personalizada: Servicos profissionais disponiveis para solucoes personalizadas

Proximos Passos¶

Ainda tem dúvidas? Pergunte na Discord or explore tutoriais