---
title: Plugar Câmeras
description: Conecte câmeras ao Argos diretamente via URL RTSP ou agrupadas por um Gravador (DVR/NVR).
---

# Plugar Câmeras

O Argos suporta duas formas de conectar câmeras:

| Forma | Quando usar |
|-------|-------------|
| **URL RTSP direta** | Câmera IP autônoma com stream acessível |
| **Via Gravador (DVR/NVR)** | Câmeras agrupadas num gravador de múltiplos canais |

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

---

## Câmera direta (URL RTSP)

Se a câmera tem uma URL RTSP própria, cadastre-a diretamente:

```bash
curl -X POST https://argos.automatizase.com.br/api/v1/cameras \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "nome": "Portaria Principal",
    "rtsp_url": "rtsp://192.168.0.50:554/stream",
    "empresa_id": 7,
    "ias_habilitadas": ["fogo", "invasao"]
  }'
```

Campos obrigatórios:

| Campo | Tipo | Descrição |
|-------|------|-----------|
| `nome` | string | Nome amigável da câmera |
| `rtsp_url` | string | URL RTSP do stream de vídeo |
| `empresa_id` | int | ID da sua organização |
| `ias_habilitadas` | string[] | Análises a ativar (ver lista em [Introdução](/docs/guias/introducao)) |

---

## Via Gravador (DVR/NVR)

Quando as câmeras estão ligadas a um DVR ou NVR, cadastre primeiro o **Gravador**
e depois as câmeras como canais dele.

### 1. Cadastrar o Gravador

```bash
curl -X POST https://argos.automatizase.com.br/api/v1/gravadores \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "nome": "DVR Galpão",
    "host": "192.168.0.100",
    "porta": 554,
    "usuario": "admin",
    "senha": "SUA_SENHA",
    "empresa_id": 7,
    "fabricante": "dahua"
  }'
```

Resposta: `{ "id": 10, "nome": "DVR Galpão", ... }`

### 2. Descobrir canais disponíveis

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

Resposta:

```json
[
  { "canal": 1, "nome": "Canal 1", "rtsp_url": "rtsp://192.168.0.100:554/cam/realmonitor?channel=1&subtype=0" },
  { "canal": 2, "nome": "Canal 2", "rtsp_url": "rtsp://192.168.0.100:554/cam/realmonitor?channel=2&subtype=0" }
]
```

### 3. Cadastrar câmeras a partir dos canais

```bash
curl -X POST https://argos.automatizase.com.br/api/v1/cameras \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "nome": "Canal 1 — Entrada",
    "gravador_id": 10,
    "canal": 1,
    "empresa_id": 7,
    "ias_habilitadas": ["epi", "invasao"]
  }'
```

Quando `gravador_id` e `canal` são fornecidos, a `rtsp_url` é derivada automaticamente
do template do fabricante — não é necessário informá-la manualmente.

---

## Ativar análises e calibrar

Após criar a câmera, você pode:

- **Habilitar/desabilitar IAs**: `PATCH /api/v1/cameras/{id}` com `ias_habilitadas`.
- **Calibrar limiares**: `PATCH /api/v1/cameras/{id}` com `config_ia`.
- **Definir agenda**: `PATCH /api/v1/cameras/{id}` com `agenda`.

Exemplo — calibrar confiança mínima da IA de EPI:

```bash
curl -X PATCH https://argos.automatizase.com.br/api/v1/cameras/42 \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "config_ia": {
      "epi": { "conf": 0.70 }
    }
  }'
```

---

## Listar câmeras

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

---

## Próximos passos

- **[Quickstart](/docs/guias/quickstart)** — ler eventos após conectar a câmera.
- **[Introdução e Conceitos](/docs/guias/introducao)** — entender IAs, Zonas, Calibração e Agenda.
- **[Notificações](/docs/guias/notificacoes)** — configurar envio de alertas para canais externos.