Integrações

Nossos aplicativos móveis permitem que você se conecte pela sua LAN ou através de nossos serviços remotos. Eles estão disponíveis para dispositivos Android e iOS.

Baixe o Aplicativo Android Agent DVR Remote .

Baixe o Aplicativo IOS Agent DVR Remote .

Existe um wrapper python para funcionalidades básicas de interface do usuário aqui: agent-py .

Você pode abrir Agent DVR em uma visualização específica chamando a url do Agent DVR com (sensível a maiúsculas e minúsculas):

• ?start=Live&viewIndex=3 (visualização ao vivo na visualização 3)
• ?start=Live&viewIndex=3&ot=2&oid=2&max=true (visualização ao vivo na visualização 3, câmera id 2 maximizada). "oid" é o id do objeto do dispositivo (visível na parte superior da caixa de diálogo quando você edita a câmera), "ot" é o tipo de objeto - 1 = microfone, 2 = câmera.
• ?start=TimeMachine (visualização da máquina do tempo)
• ?start=Timeline (visualização da linha do tempo)
• ?start=Photos (visualização de fotos)
• ?start=Recordings (visualização de gravações)
• ?start=Floorplans&planIndex=2 (visualização de plantas no plano 2)
• ?start=VR (realidade virtual)

Você pode abrir Agent DVR com um idioma específico (contornando a seleção de idioma). Basta passar o código de idioma de 2 letras: ?lang=fr

Você pode passar o nome de um filtro salvo para aplicar usando um parâmetro de filtro - ex: ?start=Recordings&filter=intruder. Você também pode passar uma hora de início e fim para o filtro usando ticks javascript. ex ?start=timeline&from=1657841514949&to=1657852514949.

Defina opções de tema padrão (as opções de tema estão disponíveis no menu de conta - configurações de tema):

• ?theme=darkly&variant=dark&large=false
• ?theme=sketchy&variant=primary&large=true

Reproduzir áudio automaticamente ao carregar (pode também exigir alteração das configurações do navegador):

• ?playaudio=true

Iniciar em modo minimizado (barras de UI superior e inferior ocultas):

• ?mini=true

Passar nome de usuário e senha locais para login automático (cuidado - isso exposerá suas credenciais à rede):

• ?un=username&pwd=password

Abrir um alerta específico por id de alerta (no json de alerta):

• ?alertid=xxx

Para acessar Comandos no Agent DVR, clique no ícone Servidor no canto superior direito da interface do Agent DVR e selecione "Commands" em System. Um atalho rápido é pressionar "Alt-C".

Agent DVR inclui vários comandos pré-built que podem controlar múltiplos dispositivos simultaneamente. Esses comandos utilizam a API para realizar várias tarefas. Você tem a flexibilidade de adicionar seus próprios comandos personalizados para chamar a API ou executar software no seu computador.

Chamando um Arquivo de Script

Para executar um arquivo de script genérico, simplesmente adicione um arquivo .bat (ou arquivo .sh no Linux/macOS) ao diretório de comandos. O nome do arquivo do script (sem a extensão) aparecerá na lista de Comandos e pode ser clicado para executar. Nota: Você pode precisar recarregar a interface para que apareça.

Chamando a API

Crie um novo arquivo .bat na pasta Commands onde Agent DVR está instalado. A primeira linha deve ser:

REM ispy-internal

As linhas subsequentes são interpretadas como comandos para a API do Agent DVR. Por exemplo:

 REM ispy-internal

 switchon&group=external

 switchoff&group=internal

 record&group=external

 broadcast 'external cameras are on and recording'

Esses comandos são adicionados às chamadas de API no formato /command.cgi?cmd=.... Assim, você pode usar qualquer comando disponível na API.

Os comandos de exemplo acima ativarão todos os dispositivos rotulados como "external", desativarão todos os dispositivos "internal", iniciarão a gravação em dispositivos "external" e enviarão uma mensagem de broadcast para todos os clientes conectados.

Consulte o botão de comando readme para exemplos e a documentação da API para uma lista de comandos disponíveis.

Após recarregar a interface e pressionar "Alt-C", seu novo comando deve estar visível na lista. Clique nele para executar.

A partir da versão 3.8.1.0+, você pode usar nomes de localização em comandos (por exemplo, switchon&location=home). Basta atribuir uma localização aos seus dispositivos primeiro!

A partir da versão 2.9.5.0, o Agent DVR oferece integração com a Amazon Alexa. Essa funcionalidade permite que você controle o Agent DVR usando comandos de voz por meio de dispositivos compatíveis com a Alexa. Você pode armar ou desarmar o sistema ou exibir feeds de vídeo ao vivo em dispositivos Alexa Show.

Para configurar, selecione 'Alexa' em Integrações no menu Servidor do Agent DVR. Isso redirecionará você para a Amazon para vincular suas contas.

Depois de vinculado, execute o processo de descoberta da Alexa. Ela deve encontrar dois dispositivos: o painel de segurança e o controle da câmera.

Agora você pode usar comandos de voz como:

• "Alexa, arme o Agent no modo residencial"
• "Alexa, mostre a câmera do Agent"

Defina seu código de segurança nas Configurações do Agent para operações que exigem autenticação. O código padrão é 1234.

Os perfis da Alexa (Casa / Ausente / Noite) correspondem aos do Agent DVR. Configure-os em Servidor - Perfis.

Para vários servidores, defina um nome de servidor nas configurações e use-o nos comandos de voz.

Agent DVR se integra completamente com Home Assistant, permitindo que você adicione Agent DVR à sua configuração do Home Assistant. Incorpore o painel Agent DVR na interface lovelace ou selecione câmeras individuais. Também inclui um controle para o painel de segurança principal. Para mais informações, consulte o link Home Assistant em Server - Integrations.

Agent DVR também pode publicar seus dispositivos no Home Assistant como sensores e switches via MQTT: consulte Descoberta MQTT do Home Assistant.

O IFTTT permite que você configure ações e gatilhos com dispositivos IoT. Comece vinculando sua conta do IFTTT ao iSpyConnect.com, acessível em Servidor - Integrações.

A configuração de alertas push móveis é detalhada em Configurando Alertas Push.

Conecte o Agent DVR com o chatbot do Telegram para controle e notificações de alerta ao vivo. Ative as notificações Push nas configurações do dispositivo para alertas ao vivo. Comece selecionando o botão do Telegram abaixo do ícone do Servidor na interface web remota.

O Agent DVR pode enviar alertas para qualquer serviço que aceite webhooks de entrada, incluindo Discord, Slack, Mattermost, Google Chat, Microsoft Teams e ntfy. Não é preciso vincular contas: você cria uma URL de webhook no serviço de destino e o Agent DVR publica os alertas diretamente, então também funciona em servidores sem acesso remoto.

A configuração geral é a mesma para todos os serviços. Edite sua câmera ou microfone, abra a aba Ações e adicione uma ação:

• Se: Alerta (ou qualquer outro evento)
• Então: Chamar URL
• URL: a URL de webhook do serviço
• Método: POST
• Corpo: a mensagem, no formato mostrado para cada serviço abaixo

Você pode usar tags como {NAME}, {MESSAGE}, {AI} e {ZONE} no campo Corpo para montar a mensagem dinamicamente.

Content-Type: application/json

Discord

No Discord, abra as configurações do canal (ícone de engrenagem) e escolha Integrações - Webhooks - Novo webhook, depois Copiar URL do webhook. Na ação do Agent DVR use:

• URL: a URL de webhook copiada
• Corpo:

  {"content":"{MESSAGE}: {NAME} em {SERVER} {AI}"}

Para anexar capturas à mensagem do Discord, defina o controle Fazer upload de imagem para 1 ou mais (v7.8.7.0+). Cada imagem adicional é capturada com meio segundo de intervalo.

Slack

Crie um aplicativo Slack em api.slack.com/apps, ative Incoming Webhooks, clique em Add New Webhook to Workspace, escolha um canal e copie a URL (ela começa com hooks.slack.com). Na ação do Agent DVR use:

• URL: a URL de webhook copiada
• Corpo:

  {"text":"{MESSAGE}: {NAME} em {SERVER} {AI}"}

Os webhooks de entrada do Slack são somente texto, então deixe Fazer upload de imagem em 0.

Mattermost

No Mattermost, vá em Menu principal - Integrações - Webhooks de entrada - Adicionar webhook de entrada, escolha um canal e copie a URL. Use o mesmo formato de Corpo do Slack:

{"text":"{MESSAGE}: {NAME} em {SERVER}"}

Google Chat

Em um espaço do Google Chat (contas Workspace), clique no nome do espaço e escolha Apps e integrações - Webhooks - Adicionar webhook, depois copie a URL. Use o mesmo formato de Corpo do Slack:

{"text":"{MESSAGE}: {NAME} em {SERVER}"}

Microsoft Teams

No Teams, clique nos três pontos ao lado de um canal, escolha Fluxos de trabalho e adicione o modelo Postar em um canal quando uma solicitação de webhook for recebida, depois copie a URL fornecida. O Teams exige a mensagem como Adaptive Card:

{"type":"message","attachments":[{"contentType":"application/vnd.microsoft.card.adaptive","content":{"type":"AdaptiveCard","version":"1.4","body":[{"type":"TextBlock","text":"{MESSAGE}: {NAME} em {SERVER}","wrap":true}]}}]}

ntfy

O ntfy envia notificações push para o seu telefone sem precisar de conta, e também pode ser auto-hospedado. Escolha um nome de tópico difícil de adivinhar (qualquer pessoa que o conheça pode se inscrever), então:

• URL: https://ntfy.sh/seu-nome-de-topico
• Corpo: texto simples (sem JSON), por ex.

  {MESSAGE}: {NAME} em {SERVER}

• Cabeçalhos (opcional, um por linha):

  Title: Agent DVR
  Tags: rotating_light
  Priority: high

Instale o aplicativo ntfy no seu telefone e inscreva-se no seu tópico para receber os alertas.

Outros serviços

Qualquer coisa que aceite um HTTP POST funciona da mesma forma, por exemplo os gatilhos de webhook do Home Assistant (http://homeassistant.local:8123/api/webhook/seu-id - embora a integração MQTT seja mais completa). O Agent DVR envia corpos JSON como application/json e todo o resto codificado como formulário. Você pode adicionar cabeçalhos extras (por exemplo chaves de API) no campo Cabeçalhos, um por linha como Nome: Valor.