Integrando com cancelas
O PlacaFlow pode acionar cancelas automaticamente ao reconhecer uma placa autorizada. A integração é feita via webhooks — quando uma placa é detectada, enviamos uma notificação HTTP ao seu sistema, que decide se abre a cancela.
Arquitetura
Câmera
Detecta placa
PlacaFlow
Webhook
Seu sistema
Verifica placa
Cancela
Abre
- Câmera detecta veículo
- PlacaFlow reconhece a placa
- Webhook é disparado com dados da placa
- Seu sistema verifica se a placa está na lista de autorizados
- Se autorizada, envia comando para abrir a cancela
Configurando
1. Crie um webhook
No dashboard, vá em Webhooks e crie um novo:
- URL: endpoint do seu sistema (ex:
https://seuservidor.com/api/placaflow-event) - Eventos: selecione
recognition.created - Secret: guarde para validar as requisições
2. Receba o evento
Seu endpoint receberá um POST com:
{
"event": "recognition.created",
"data": {
"plate": "ABC1D23",
"confidence": 0.96,
"cameraId": "550e8400-...",
"cameraName": "Entrada",
"timestamp": "2026-03-22T14:30:00Z"
}
}
3. Verifique a placa
No seu sistema, compare data.plate com a lista de placas autorizadas.
4. Acione a cancela
Se a placa é autorizada, envie o comando para a cancela:
- Cancela com relé HTTP: faça um GET/POST para o IP do relé
- Cancela com API: chame a API do fabricante (Linear, PPA, Rossi, etc.)
- Cancela com GPIO: se usar Raspberry Pi, acione a porta GPIO
Exemplo em Node.js
app.post('/api/placaflow-event', (req, res) => {
const { plate, confidence } = req.body.data;
// Verificar confiança mínima
if (confidence < 0.85) {
return res.json({ action: 'ignored', reason: 'low_confidence' });
}
// Verificar se placa está autorizada
const authorized = authorizedPlates.includes(plate);
if (authorized) {
// Acionar cancela
openGate();
return res.json({ action: 'opened' });
}
res.json({ action: 'denied' });
});
Latência
O tempo total desde a detecção até a abertura da cancela depende de:
| Etapa | Tempo típico |
|---|---|
| Reconhecimento | 200-300ms |
| Webhook delivery | 50-200ms |
| Seu sistema | depende da implementação |
| Comando para cancela | 50-500ms |
| Total | 300ms - 1s |
Dica
Para minimizar a latência, hospede seu sistema receptor na mesma região que o PlacaFlow (São Paulo) e mantenha a lógica de verificação de placa simples (lookup em memória ou cache Redis).