Integração com CarbigData

A integração com CarbigData permite enviar reconhecimentos de placas automaticamente do PlacaFlow para a plataforma CarbigData, incluindo foto e dados da captura.

Pré-requisitos

Antes de configurar, você precisa ter:

Uma conta ativa na CarbigData
Uma API Key (solicite ao suporte da CarbigData)
Um ou mais IDs de câmera cadastrados na CarbigData (ex: CAM123456789)
Pelo menos uma câmera configurada e reconhecendo placas no PlacaFlow

Dica

Peça acesso ao ambiente de sandbox da CarbigData (sandbox.carbigdata.com.br) para testar a integração antes de usar em produção.

Passo a passo

1. Criar a integração no PlacaFlow

No dashboard, vá em Integrações
Clique no card CarbigData
Preencha a API Key — chave fornecida pela CarbigData (uma por conta)
Marque o evento Reconhecimento de placa
Clique em Criar integração

2. Configurar as câmeras

Agora associe cada câmera ao ID correspondente na CarbigData:

Vá em Câmeras
Clique na câmera que deseja conectar
Na seção Integrações (no final da página), preencha o campo ID CarbigData com o código da câmera na CarbigData
Clique em Salvar

Repita para cada câmera que deseja enviar para a CarbigData.

Info

Câmeras sem o campo ID CarbigData preenchido são ignoradas — nenhum dado é enviado para elas. Isso permite que você conecte apenas câmeras específicas.

3. Verificar o funcionamento

Após a configuração, cada reconhecimento novo nas câmeras mapeadas será enviado automaticamente.

Para confirmar:

Em Integrações, verifique que o status está Ativo e a coluna Último envio tem data recente
No painel da CarbigData, confirme que as capturas estão aparecendo

O que é enviado

Para cada reconhecimento, o PlacaFlow envia a placa reconhecida, o bounding box (coordenadas da placa na imagem) e a foto em um multipart/form-data:

capture (JSON):

{
  "deviceId": "CAM123456789",
  "captureDateTime": "2026-03-27T14:32:05.000",
  "plate": "ABC1D23",
  "boundingBox": "190,125;451,125;451,235;190,235"
}

image (JPG): foto original da captura.

Solução de problemas

Status "Erro" na integração

Erro	Causa	Solução
`HTTP 401`	API Key inválida ou expirada	Confirme a chave com a CarbigData e atualize na integração
`HTTP 400: Required request part 'image' is not present`	Captura sem foto	Verifique se a câmera está gerando fotos — câmeras com erro de conexão ou falha de upload não geram imagem
`HTTP 400` (outros)	Dados incorretos	Confira o ID CarbigData na configuração da câmera — ele deve corresponder exatamente ao ID cadastrado na plataforma CarbigData
`HTTP 403`	Conta sem permissão	Verifique com a CarbigData se sua conta tem acesso à API de captura

Info

O PlacaFlow não desativa a integração em caso de erro. A cada novo reconhecimento, ele tenta enviar novamente. Quando o envio funcionar, o status volta para Ativo automaticamente.

Reconhecimentos não aparecem na CarbigData

Verifique o ID da câmera — Vá em Câmeras → [sua câmera] → Integrações e confirme que o campo ID CarbigData está preenchido
Verifique o status da integração — Vá em Integrações e veja se está Ativo ou Erro
Verifique se há fotos — Reconhecimentos sem foto não são enviados. Confira na lista de reconhecimentos se a captura tem imagem
Verifique o ambiente — Se está usando sandbox, as capturas aparecem no painel do sandbox, não no de produção

Câmera específica não envia

Se uma câmera está reconhecendo placas mas não envia para CarbigData:

O campo ID CarbigData pode estar vazio — vá na câmera e preencha
O ID pode estar incorreto — confirme com a CarbigData qual o código correto

Perguntas frequentes

Posso usar a mesma API Key em várias contas PlacaFlow? Cada conta PlacaFlow tem sua própria integração. Se usar a mesma API Key da CarbigData em várias contas, os envios funcionarão normalmente, pois a diferenciação é feita pelo ID da câmera.

Preciso de uma API Key por câmera? Não. A API Key é por conta. Cada câmera é identificada pelo seu ID CarbigData (deviceId), que é configurado individualmente.

O que acontece se eu remover o ID CarbigData de uma câmera? Os reconhecimentos dessa câmera deixam de ser enviados. Nenhum dado é perdido — apenas os novos reconhecimentos não serão enviados. Você pode reconfigar a qualquer momento.

O envio é em tempo real? Sim. O envio acontece dentro de segundos após o reconhecimento. O PlacaFlow tenta enviar imediatamente após processar cada captura.

Posso enviar reconhecimentos antigos? Não. Apenas novos reconhecimentos (feitos após a configuração da integração) são enviados.