---
title: Notificações
description: Configure Canais de Notificação para receber Eventos confirmados via webhook, WhatsApp ou e-mail.
---

# Notificações

O Argos envia **Eventos confirmados** para destinos externos configurados como
**Canais de Notificação**. Apenas eventos com `veredito=confirmado` disparam notificações.

> Requer o papel de **administrador da conta**.

## Tipos de canal

| Tipo | Descrição |
|------|-----------|
| `webhook` | HTTP POST para uma URL sua |
| `whatsapp` | Mensagem via WhatsApp Business |
| `email` | E-mail para um endereço configurado |

## Criar um canal de notificação

### Webhook

```bash
curl -X POST https://argos.automatizase.com.br/api/v1/notificacoes/canais \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "tipo": "webhook",
    "empresa_id": 7,
    "url": "https://meu-servidor.com/argos-webhook",
    "filtros": {
      "tipos_ia": ["fogo", "invasao"],
      "gravidade_minima": "media"
    }
  }'
```

### E-mail

```bash
curl -X POST https://argos.automatizase.com.br/api/v1/notificacoes/canais \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "tipo": "email",
    "empresa_id": 7,
    "email": "seguranca@empresa.com",
    "filtros": {
      "tipos_ia": ["fogo"]
    }
  }'
```

## Payload do webhook

O Argos envia um `HTTP POST` com `Content-Type: application/json`:

```json
{
  "evento_id": 1001,
  "camera_id": 42,
  "camera_nome": "Portaria Principal",
  "empresa_id": 7,
  "tipo": "fogo",
  "gravidade": "alta",
  "criado_em": "2026-06-17T14:32:00Z",
  "veredito": {
    "resultado": "confirmado",
    "confianca": 0.92,
    "motivo": "Chama visível no frame."
  },
  "frame_url": "https://argos.automatizase.com.br/frames/1001.jpg"
}
```

## Listar canais

```bash
curl https://argos.automatizase.com.br/api/v1/notificacoes/canais \
  -H "Authorization: Bearer $TOKEN"
```

## Filtros disponíveis

| Campo | Tipo | Descrição |
|-------|------|-----------|
| `tipos_ia` | `string[]` | Tipos de IA que disparam (ex.: `["fogo", "invasao"]`) |
| `gravidade_minima` | `string` | `"baixa"`, `"media"` ou `"alta"` |
| `camera_ids` | `int[]` | Restringir a câmeras específicas |

## Agenda no canal

Você pode armar um canal apenas em horários específicos:

```json
{
  "tipo": "webhook",
  "empresa_id": 7,
  "url": "https://...",
  "agenda": {
    "dias": ["seg", "ter", "qua", "qui", "sex"],
    "inicio": "18:00",
    "fim": "06:00"
  }
}
```

## Teste de entrega

```bash
# Envia um evento de teste para o canal 5
curl -X POST https://argos.automatizase.com.br/api/v1/notificacoes/canais/5/teste \
  -H "Authorization: Bearer $TOKEN"
```

## Próximos passos

- **[Referência da API](/docs/referencia/api)** — endpoints `/notificacoes` em detalhe.
- **[Quickstart](/docs/guias/quickstart)** — criar câmeras e ler eventos.