Integrações
O PlacaFlow pode enviar reconhecimentos e alertas automaticamente para outros serviços. Configure tudo no painel, sem código.
Provedores disponíveis
| Provedor | O que faz | Eventos suportados |
|---|---|---|
| CarbigData | Envia reconhecimentos para a plataforma CarbigData | Reconhecimento de placa |
| Slack | Notificações em canais do Slack | Reconhecimento, alerta, câmera offline/online |
| Telegram | Mensagens via bot do Telegram | Reconhecimento, alerta, câmera offline/online |
| Discord | Notificações em canais do Discord | Reconhecimento, alerta, câmera offline/online |
Configurando uma integração
- Vá em Integrações no dashboard
- Escolha o provedor desejado
- Preencha os dados de configuração
- Selecione quais eventos devem disparar o envio
- Clique em Criar integração
A integração começa a funcionar imediatamente. Você pode pausar, editar ou excluir a qualquer momento.
CarbigData
A integração com CarbigData envia reconhecimentos do PlacaFlow automaticamente, incluindo foto e dados da placa. A configuração é feita em duas etapas: primeiro a integração na conta, depois o mapeamento por câmera.
Etapa 1 — Criar a integração
Vá em Integrações no dashboard e clique em CarbigData.
| Campo | Descrição |
|---|---|
| API Key | Chave de API fornecida pela CarbigData. Uma por conta. |
A API Key é única por conta — todas as suas câmeras usarão a mesma chave.
Dica
Se você não tem uma API Key, entre em contato com a CarbigData para solicitar acesso à API. Peça também acesso ao ambiente de sandbox para testes.
Etapa 2 — Mapear câmeras
Após criar a integração, vá em Câmeras → clique na câmera que deseja enviar para CarbigData → na seção Integrações, preencha o ID CarbigData.
| Campo | Descrição |
|---|---|
| ID CarbigData | O código da câmera cadastrada na CarbigData (ex: CAM123456789). Cada câmera tem um ID diferente. |
Info
Somente câmeras com o campo ID CarbigData preenchido terão reconhecimentos enviados. Câmeras sem ID são ignoradas silenciosamente.
O ID da câmera é fornecido pela CarbigData no momento em que você cadastra a câmera na plataforma deles. Se não sabe qual é o ID, consulte o painel da CarbigData ou entre em contato com o suporte.
Como funciona o envio
Para cada reconhecimento, o PlacaFlow envia a placa reconhecida, o bounding box (coordenadas da placa na imagem) e a foto. O fluxo é:
- Verifica se a câmera tem um ID CarbigData configurado — se não tiver, ignora
- Gera uma URL temporária para a foto da captura
- Baixa a imagem e monta um
multipart/form-datacom:- capture (JSON):
deviceId,captureDateTime,plate,boundingBox - image (JPG): foto da captura
- capture (JSON):
- Envia para o endpoint da CarbigData com a API Key no header
Atenção
Se a captura não tiver foto (erro na câmera, falha de upload), o envio é cancelado. A CarbigData exige imagem em todas as capturas.
Verificando o funcionamento
Após configurar, reconhecimentos novos serão enviados automaticamente. Para confirmar:
- Acesse Integrações no dashboard — o status deve estar Ativo
- Verifique a coluna Último envio para confirmar que os dados estão sendo enviados
- No painel da CarbigData, confirme que as capturas aparecem
Se o status mudar para Erro, o último erro aparecerá no card da integração. Os motivos mais comuns são:
| Erro | Causa provável | Solução |
|---|---|---|
| HTTP 401 | API Key inválida ou expirada | Verifique a chave com a CarbigData |
| HTTP 400 | Dados incompletos ou ID da câmera incorreto | Confira o ID CarbigData nas configurações da câmera |
| Imagem não disponível | Captura sem foto | Verifique se a câmera está gerando fotos corretamente |
Info
Integrações em erro não são desativadas — o PlacaFlow continua tentando a cada novo reconhecimento. Quando o envio funcionar novamente, o status volta para Ativo automaticamente.
Resumo da configuração
1. Integrações → CarbigData → Inserir API Key + tipo de câmera → Criar
2. Câmeras → [cada câmera] → Integrações → Preencher ID CarbigData → Salvar
3. Pronto — reconhecimentos serão enviados automaticamente
Slack
Envia notificações formatadas para um canal do Slack via Incoming Webhook.
Como configurar
- No Slack, vá em api.slack.com/apps → Create New App
- Ative Incoming Webhooks
- Clique em Add New Webhook to Workspace e selecione o canal
- Copie a Webhook URL
- No PlacaFlow, vá em Integrações → Slack → cole a URL → Criar
Exemplo de notificação
🔍 Placa reconhecida
Placa: ABC1D23 · 95% · Entrada principal
Telegram
Envia mensagens para um chat ou grupo do Telegram via bot.
Como configurar
- Fale com @BotFather no Telegram
- Crie um bot com
/newbote copie o Bot Token - Adicione o bot ao grupo desejado
- Descubra o Chat ID:
- Envie uma mensagem no grupo
- Acesse
https://api.telegram.org/bot<TOKEN>/getUpdates - Procure o campo
chat.idna resposta
- No PlacaFlow, vá em Integrações → Telegram → cole o Token e Chat ID → Criar
Info
Chat IDs de grupos começam com -100. Chat IDs pessoais são números positivos.
Discord
Envia notificações formatadas (com embeds coloridos) para um canal do Discord.
Como configurar
- No Discord, vá nas configurações do canal → Integrações → Webhooks
- Clique em Novo Webhook
- Copie a URL do Webhook
- No PlacaFlow, vá em Integrações → Discord → cole a URL → Criar
Exemplo de notificação
As mensagens aparecem como embeds com cor:
- 🔵 Azul — reconhecimento de placa
- 🔴 Vermelho — câmera offline
- 🟢 Verde — câmera online
Status da integração
| Status | Significado |
|---|---|
| Ativo | Funcionando normalmente |
| Inativo | Pausado manualmente |
| Erro | Última tentativa falhou — verifique os dados de configuração |
Integrações em erro são reativadas automaticamente quando o próximo envio funciona.
Webhooks vs Integrações
| Webhooks | Integrações | |
|---|---|---|
| Para quem | Desenvolvedores | Qualquer usuário |
| Configuração | URL + secret + código | Sem código |
| Flexibilidade | Total (seu endpoint) | Limitado ao provedor |
| Formato | JSON com HMAC | Formato do provedor |
Use webhooks se você tem um sistema próprio que precisa receber dados. Use integrações para enviar dados diretamente para serviços que sua equipe já usa.