Dashboard

Integrações

Integrações

O PlacaFlow pode enviar reconhecimentos e alertas automaticamente para outros serviços. Configure tudo no painel, sem código.

Provedores disponíveis

ProvedorO que fazEventos suportados
CarbigDataEnvia reconhecimentos para a plataforma CarbigDataReconhecimento de placa
SlackNotificações em canais do SlackReconhecimento, alerta, câmera offline/online
TelegramMensagens via bot do TelegramReconhecimento, alerta, câmera offline/online
DiscordNotificações em canais do DiscordReconhecimento, alerta, câmera offline/online

Configurando uma integração

  1. Vá em Integrações no dashboard
  2. Escolha o provedor desejado
  3. Preencha os dados de configuração
  4. Selecione quais eventos devem disparar o envio
  5. 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.

CampoDescrição
API KeyChave 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.

CampoDescrição
ID CarbigDataO 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 é:

  1. Verifica se a câmera tem um ID CarbigData configurado — se não tiver, ignora
  2. Gera uma URL temporária para a foto da captura
  3. Baixa a imagem e monta um multipart/form-data com:
    • capture (JSON): deviceId, captureDateTime, plate, boundingBox
    • image (JPG): foto da captura
  4. 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:

  1. Acesse Integrações no dashboard — o status deve estar Ativo
  2. Verifique a coluna Último envio para confirmar que os dados estão sendo enviados
  3. 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:

ErroCausa provávelSolução
HTTP 401API Key inválida ou expiradaVerifique a chave com a CarbigData
HTTP 400Dados incompletos ou ID da câmera incorretoConfira o ID CarbigData nas configurações da câmera
Imagem não disponívelCaptura sem fotoVerifique 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

  1. No Slack, vá em api.slack.com/apps → Create New App
  2. Ative Incoming Webhooks
  3. Clique em Add New Webhook to Workspace e selecione o canal
  4. Copie a Webhook URL
  5. No PlacaFlow, vá em IntegraçõesSlack → 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

  1. Fale com @BotFather no Telegram
  2. Crie um bot com /newbot e copie o Bot Token
  3. Adicione o bot ao grupo desejado
  4. Descubra o Chat ID:
    • Envie uma mensagem no grupo
    • Acesse https://api.telegram.org/bot<TOKEN>/getUpdates
    • Procure o campo chat.id na resposta
  5. No PlacaFlow, vá em IntegraçõesTelegram → 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

  1. No Discord, vá nas configurações do canal → IntegraçõesWebhooks
  2. Clique em Novo Webhook
  3. Copie a URL do Webhook
  4. No PlacaFlow, vá em IntegraçõesDiscord → 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

StatusSignificado
AtivoFuncionando normalmente
InativoPausado 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

WebhooksIntegrações
Para quemDesenvolvedoresQualquer usuário
ConfiguraçãoURL + secret + códigoSem código
FlexibilidadeTotal (seu endpoint)Limitado ao provedor
FormatoJSON com HMACFormato 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.

Esta página foi útil?