Integraciones

Nuestras aplicaciones móviles te permiten conectarte a través de tu LAN o mediante nuestros servicios remotos. Están disponibles para dispositivos Android e iOS.

Descarga la Aplicación Remota de Agent DVR para Android .

Descarga la Aplicación Remota de Agent DVR para iOS .

Hay un envoltorio de Python para la funcionalidad básica de la interfaz de usuario aquí: agent-py .

Puede abrir Agent DVR en una vista específica llamando a la URL de Agent DVR con (distingue mayúsculas y minúsculas):

• ?start=Live&viewIndex=3 (vista en directo en la vista 3)
• ?start=Live&viewIndex=3&ot=2&oid=2&max=true (vista en directo en la vista 3, cámara id 2 maximizada). "oid" es el id de objeto del dispositivo (visible en la parte superior del diálogo cuando edita la cámara), "ot" es el tipo de objeto - 1 = micrófono, 2 = cámara.
• ?start=TimeMachine (vista timemachine)
• ?start=Timeline (vista timeline)
• ?start=Photos (vista de fotos)
• ?start=Recordings (vista de grabaciones)
• ?start=Floorplans&planIndex=2 (vista de planos en el plano 2)
• ?start=VR (realidad virtual)

Puede abrir Agent DVR con un idioma específico (omitiendo la selección de idioma). Solo pase el código de idioma de 2 letras: ?lang=fr

Puede pasar el nombre de un filtro guardado para aplicar usando un parámetro filter - ej: ?start=Recordings&filter=intruder. También puede pasar un tiempo de inicio y fin para el filtro usando ticks de javascript. ej ?start=timeline&from=1657841514949&to=1657852514949.

Establezca opciones de tema predeterminadas (las opciones de tema están disponibles en el menú de cuenta - configuración de tema):

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

Reproducción automática de audio al cargar (también puede requerir cambiar la configuración del navegador):

• ?playaudio=true

Iniciar en modo minimizado (barras de interfaz de usuario superior e inferior ocultas):

• ?mini=true

Pase el nombre de usuario y contraseña locales para inicio de sesión automático (precaución - esto expondrá sus credenciales a la red):

• ?un=username&pwd=password

Abra una alerta específica por id de alerta (en el json de alerta):

• ?alertid=xxx

Para acceder a Commands en Agent DVR, haz clic en el icono Server en la parte superior derecha de la interfaz de Agent DVR y selecciona "Commands" en System. Un atajo rápido es presionar "Alt-C".

Agent DVR incluye varios comandos preestablecidos que pueden controlar múltiples dispositivos simultáneamente. Estos comandos utilizan la API para realizar diversas tareas. Tienes la flexibilidad de añadir tus propios comandos personalizados para llamar a la API o ejecutar software en tu ordenador.

Llamar a un Archivo de Script

Para ejecutar un archivo de script genérico, simplemente añade un archivo .bat (o .sh en Linux/macOS) al directorio de comandos. El nombre del archivo de script (sin la extensión) aparecerá en la lista de Commands y se puede hacer clic para ejecutar. Nota: Es posible que necesites recargar la interfaz para que aparezca.

Llamar a la API

Crea un nuevo archivo .bat en la carpeta Commands donde está instalado Agent DVR. La primera línea debe ser:

REM ispy-internal

Las líneas posteriores se interpretan como comandos para la API de Agent DVR. Por ejemplo:

 REM ispy-internal

 switchon&group=external

 switchoff&group=internal

 record&group=external

 broadcast 'external cameras are on and recording'

Estos comandos se añaden a las llamadas de API en el formato /command.cgi?cmd=.... Por lo tanto, puedes utilizar cualquier comando disponible en la API.

Los comandos de ejemplo anteriores activarán todos los dispositivos etiquetados como "external", desactivarán todos los dispositivos "internal", comenzarán a grabar en dispositivos "external" y enviarán un mensaje de difusión a todos los clientes conectados.

Consulta el botón de comando readme para ver ejemplos y la documentación de la API para una lista de comandos disponibles.

Después de recargar la interfaz y presionar "Alt-C", tu nuevo comando debería ser visible en la lista. Haz clic en él para ejecutar.

A partir de la versión 3.8.1.0+, puedes usar nombres de ubicación en comandos (por ejemplo, switchon&location=home). ¡Solo asigna una ubicación a tus dispositivos primero!

A partir de la versión 2.9.5.0, Agent DVR ofrece integración con Amazon Alexa. Esta característica te permite controlar Agent DVR utilizando comandos de voz a través de dispositivos habilitados para Alexa. Puedes armar o desarmar el sistema o mostrar transmisiones de video en vivo en dispositivos Alexa Show.

Para configurarlo, selecciona 'Alexa' en Integraciones en el menú del Servidor de Agent DVR. Esto te redirige a Amazon para vincular tus cuentas.

Una vez vinculado, ejecuta el proceso de descubrimiento de Alexa. Debería encontrar dos dispositivos: el panel de seguridad y el control de la cámara.

Ahora puedes usar comandos de voz como:

• "Alexa, arma Agent en modo hogar"
• "Alexa, muestra la cámara de Agent"

Establece tu código de seguridad en la configuración de Agent para operaciones que requieren autenticación. El código predeterminado es 1234.

Los perfiles de Alexa (Hogar / Ausente / Noche) coinciden con los de Agent DVR. Configúralos en Servidor - Perfiles.

Para varios servidores, establece un nombre de servidor en la configuración y úsalo en los comandos de voz.

Agent DVR se integra completamente con Home Assistant, permitiendo agregar Agent DVR en tu configuración de Home Assistant. Inserta el panel de Agent DVR en la interfaz lovelace o selecciona cámaras individuales. También incluye un control para el panel de seguridad principal. Para más información, consulta el enlace de Home Assistant en Server - Integrations.

Agent DVR también puede publicar sus dispositivos en Home Assistant como sensores e interruptores a través de MQTT: consulta Home Assistant MQTT discovery.

IFTTT te permite configurar acciones y disparadores con dispositivos IoT. Comienza vinculando tu cuenta de IFTTT con iSpyConnect.com, accesible en Servidor - Integraciones.

La configuración de las alertas push móviles se detalla en Configuración de Alertas Push.

Conecte Agent DVR con el chatbot de Telegram para el control y las notificaciones de alerta en vivo. Habilite las Notificaciones push en la configuración del dispositivo para alertas en vivo. Comience seleccionando el botón de Telegram debajo del ícono del Servidor en la interfaz web remota.

Agent DVR puede enviar alertas a cualquier servicio que acepte webhooks entrantes, incluidos Discord, Slack, Mattermost, Google Chat, Microsoft Teams y ntfy. No se necesita vincular cuentas: usted crea una URL de webhook en el servicio de destino y Agent DVR publica las alertas directamente, por lo que también funciona en servidores sin acceso remoto.

La configuración general es la misma para todos los servicios. Edite su cámara o micrófono, abra la pestaña Acciones y añada una acción:

• Si: Alerta (o cualquier otro evento)
• Entonces: Llamar a URL
• URL: la URL de webhook del servicio
• Método: POST
• Cuerpo: el mensaje, con el formato mostrado para cada servicio a continuación

Puede usar etiquetas como {NAME}, {MESSAGE}, {AI} y {ZONE} en el campo Cuerpo para construir el mensaje dinámicamente.

Content-Type: application/json

Discord

En Discord, abra la configuración del canal (icono de engranaje) y elija Integraciones - Webhooks - Nuevo webhook, luego Copiar URL de webhook. En la acción de Agent DVR use:

• URL: la URL de webhook copiada
• Cuerpo:

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

Para adjuntar capturas al mensaje de Discord, ponga el control deslizante Subir imagen en 1 o más (v7.8.7.0+). Cada imagen adicional se captura con medio segundo de diferencia.

Slack

Cree una aplicación de Slack en api.slack.com/apps, active Incoming Webhooks, haga clic en Add New Webhook to Workspace, elija un canal y copie la URL (comienza con hooks.slack.com). En la acción de Agent DVR use:

• URL: la URL de webhook copiada
• Cuerpo:

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

Los webhooks entrantes de Slack son solo de texto, así que deje Subir imagen en 0.

Mattermost

En Mattermost, vaya a Menú principal - Integraciones - Webhooks entrantes - Añadir webhook entrante, elija un canal y copie la URL. Use el mismo formato de Cuerpo que Slack:

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

Google Chat

En un espacio de Google Chat (cuentas de Workspace), haga clic en el nombre del espacio y elija Aplicaciones e integraciones - Webhooks - Añadir webhook, luego copie la URL. Use el mismo formato de Cuerpo que Slack:

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

Microsoft Teams

En Teams, haga clic en los tres puntos junto a un canal, elija Flujos de trabajo y añada la plantilla Publicar en un canal cuando se reciba una solicitud de webhook, luego copie la URL que le proporciona. Teams requiere el mensaje como Adaptive Card:

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

ntfy

ntfy envía notificaciones push a su teléfono sin necesidad de cuenta, y también puede alojarse en su propio servidor. Elija un nombre de tema difícil de adivinar (cualquiera que lo conozca puede suscribirse), luego:

• URL: https://ntfy.sh/su-nombre-de-tema
• Cuerpo: texto plano (sin JSON), p. ej.

  {MESSAGE}: {NAME} en {SERVER}

• Encabezados (opcional, uno por línea):

  Title: Agent DVR
  Tags: rotating_light
  Priority: high

Instale la aplicación ntfy en su teléfono y suscríbase a su tema para recibir las alertas.

Otros servicios

Cualquier cosa que acepte un HTTP POST funciona de la misma manera, por ejemplo los activadores de webhook de Home Assistant (http://homeassistant.local:8123/api/webhook/su-id - aunque la integración MQTT es más completa). Agent DVR envía los cuerpos JSON como application/json y todo lo demás codificado como formulario. Puede añadir encabezados adicionales (por ejemplo claves de API) en el campo Encabezados, uno por línea como Nombre: Valor.