ArgosDocs
Guias

Notificações

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

TipoDescrição
webhookHTTP POST para uma URL sua
whatsappMensagem via WhatsApp Business
emailE-mail para um endereço configurado

Criar um canal de notificação

Webhook

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

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:

{
  "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

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

Filtros disponíveis

CampoTipoDescrição
tipos_iastring[]Tipos de IA que disparam (ex.: ["fogo", "invasao"])
gravidade_minimastring"baixa", "media" ou "alta"
camera_idsint[]Restringir a câmeras específicas

Agenda no canal

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

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

Teste de entrega

# 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