Notificações via WhatsApp e Telegram

Receba notificações de reconhecimento de placas diretamente no WhatsApp ou Telegram usando webhooks.

Telegram

O Telegram é a opção mais simples — basta criar um bot e configurar o webhook.

1. Crie um bot no Telegram

1. Abra o Telegram e busque por @BotFather
2. Envie /newbot e siga as instruções
3. Copie o token do bot (ex: 6123456789:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw)

2. Obtenha o chat ID

1. Inicie uma conversa com seu bot
2. Envie qualquer mensagem
3. Acesse: https://api.telegram.org/bot<TOKEN>/getUpdates
4. Copie o chat.id da resposta

3. Crie um servidor intermediário

Você precisa de um pequeno servidor que recebe o webhook do PlacaFlow e encaminha para o Telegram:

// Node.js com Express
const TELEGRAM_TOKEN = 'seu_token';
const CHAT_ID = 'seu_chat_id';

app.post('/webhook/placaflow', async (req, res) => {
  const { plate, confidence, cameraName, timestamp } = req.body.data;

  const message = `🚗 *Placa detectada*\n\n`
    + `Placa: \`${plate}\`\n`
    + `Confiança: ${(confidence * 100).toFixed(1)}%\n`
    + `Câmera: ${cameraName}\n`
    + `Horário: ${new Date(timestamp).toLocaleString('pt-BR')}`;

  await fetch(`https://api.telegram.org/bot${TELEGRAM_TOKEN}/sendMessage`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      chat_id: CHAT_ID,
      text: message,
      parse_mode: 'Markdown'
    })
  });

  res.json({ ok: true });
});

4. Configure o webhook no PlacaFlow

Use a URL do seu servidor como endpoint do webhook, com o evento alert.triggered (para receber apenas quando alertas disparam) ou recognition.created (para todas as detecções).

WhatsApp

Para WhatsApp, existem duas opções:

Opção A: WhatsApp Business API (oficial)

1. Configure uma conta na API do WhatsApp Business
2. Crie um template de mensagem aprovado
3. Configure um servidor que recebe o webhook do PlacaFlow e envia via API do WhatsApp

Opção B: Serviços de terceiros

Serviços como Z-API, Evolution API ou Baileys oferecem APIs simplificadas para enviar mensagens pelo WhatsApp:

1. Configure o serviço e conecte seu WhatsApp
2. Crie um endpoint que recebe o webhook e chama a API do serviço
3. Configure no PlacaFlow

Dica: filtre antes de notificar

Para evitar spam de notificações, use alertas no PlacaFlow em vez de webhooks diretos:

1. Crie um alerta com as condições desejadas (placa específica, horário, câmera)
2. Configure o webhook para o evento alert.triggered
3. Assim, você só recebe notificação quando as condições são atendidas