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 .

您可以通过调用Agent DVR的URL以特定视图打开Agent（区分大小写）：

• ?start=Live&viewIndex=3（在第3个视图上进行实时查看）
• ?start=TimeMachine（时光机视图）
• ?start=Timeline（时间轴视图）
• ?start=Photos（照片视图）
• ?start=Recordings（录像视图）
• ?start=Floorplans&planIndex=2（在第2个平面图上进行楼层图视图）
• ?start=VR（虚拟现实）

您可以通过传入两个字母的语言代码来打开Agent DVR（绕过语言选择）。例如：?lang=fr

您可以使用过滤器参数传入保存的过滤器名称以应用过滤器。例如：?start=Recordings&filter=intruder。您还可以使用JavaScript的时间戳传入过滤器的起始时间和结束时间。例如：?start=timeline&from=1657841514949&to=1657852514949。

设置默认的主题选项（主题选项在账户菜单中的主题设置中可用）：

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

加载时自动播放音频（可能还需要更改浏览器设置）：

• ?playaudio=true

以最小化模式启动（隐藏顶部和底部的用户界面栏）：

• ?mini=true

传入本地用户名和密码以进行自动登录（注意 - 这将向网络公开您的凭据）：

• ?un=username&pwd=password

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

O Agent DVR inclui vários comandos pré-configurados que podem controlar vários 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 em seu computador.

Chamando um Arquivo de Script

Para executar um arquivo de script genérico, basta adicionar um arquivo .bat (ou .sh no Linux/macOS) ao diretório de comandos. O nome do arquivo de script (sem a extensão) aparecerá na lista de Comandos e poderá ser clicado para ser executado. Observação: Talvez seja necessário recarregar a interface para que ele apareça.

Chamando a API

Crie um novo arquivo .bat na pasta de Comandos onde o Agent está instalado. A primeira linha deve ser:

REM ispy-internal

As linhas subsequentes são interpretadas como comandos para a API do Agent. 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 anexados às chamadas da API no formato /command.cgi?cmd=.... Portanto, você pode usar qualquer comando disponível na API.

Os comandos de exemplo acima irão ativar todos os dispositivos rotulados como "externos", desativar todos os dispositivos "internos", iniciar a gravação nos dispositivos "externos" e enviar uma mensagem de transmissão para todos os clientes conectados.

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

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

A partir da versão 3.8.1.0+, você pode usar nomes de localização nos comandos (por exemplo, switchon&location=home). Apenas atribua 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.

O Agent DVR integra-se completamente com o Home Assistant, permitindo que você adicione o Agent DVR à sua configuração do Home Assistant. Incorpore o painel do Agent DVR na interface do usuário do Lovelace ou selecione câmeras individuais. Ele também inclui um controle para o painel de segurança principal. Para mais informações, consulte o link do Home Assistant em Servidor - Integrações.

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.