Cómo Configurar Notificaciones de Seguridad con Captura de Imagen en Telegram y Home Assistant en España

Seguridad proactiva e instantánea sin cuotas mensuales

En el ámbito de la seguridad residencial en España, las notificaciones tradicionales de texto se han quedado cortas. Cuando un sensor detecta movimiento en el jardín o la entrada de casa, recibir un simple mensaje no es suficiente para evaluar si se trata de una intrusión real o de un falso positivo provocado por una mascota o el viento. La solución óptima es recibir una captura de imagen en tiempo real directamente en tu móvil.

Utilizar la plataforma de mensajería Telegram integrada con Home Assistant ofrece un sistema de alerta temprana ultrarrápido, totalmente privado y sin depender de servidores de terceros ni suscripciones de pago. En esta guía detallada, aprenderás paso a paso cómo configurar este potente sistema de videovigilancia.

Paso 1: Creación y configuración del Bot de Telegram

Para que Home Assistant pueda enviar imágenes a tu smartphone, es necesario crear un bot privado en Telegram que actúe como pasarela de comunicación segura.

1. Abre la aplicación de Telegram en tu teléfono o PC y busca el usuario oficial @BotFather.
2. Inicia una conversación y envía el comando /newbot. Sigue las instrucciones para asignarle un nombre y un usuario único a tu bot de seguridad.
3. Al finalizar, BotFather te proporcionará un código único conocido como HTTP API Token. Guarda este token de forma segura, ya que lo necesitarás más adelante.
4. Para obtener tu ID de chat personal, busca el bot @userinfobot en Telegram y envíale cualquier mensaje. Te devolverá un número de varios dígitos que representa tu ID de usuario.

Paso 2: Integración de Telegram en Home Assistant

Una vez que tienes el token del bot y tu ID de chat, el siguiente paso es declarar la pasarela de notificaciones en el ecosistema de Home Assistant. Esto se realiza editando el archivo de configuración principal de tu servidor.

• Accede a los archivos de configuración de Home Assistant (puedes usar complementos como File Editor o VS Code).
• Abre el archivo configuration.yaml y añade las siguientes líneas de código, sustituyendo los valores de ejemplo por tu token y tu ID de chat:

telegram_bot:
- platform: polling
api_key: "TU_API_TOKEN_AQUÍ"
allowed_chat_ids:
- TU_CHAT_ID_AQUÍ

notify:
- name: telegram_seguridad
platform: telegram
chat_id: TU_CHAT_ID_AQUÍ

Una vez guardado el archivo, dirígete a las herramientas de desarrollo de Home Assistant, verifica que la configuración sea válida y reinicia el sistema para aplicar los cambios de forma efectiva.

Paso 3: Automatización de captura y envío de imagen

Con la integración lista, ahora crearemos la lógica de automatización que enlazará un sensor de movimiento con la cámara IP para realizar una captura instantánea y enviarla a tu terminal móvil.

1. Dirígete al panel de Ajustes > Automatizaciones y escenas y haz clic en crear una nueva automatización desde cero.
2. Desencadenador (Trigger): Selecciona el estado de tu sensor de movimiento o sensor de apertura de puerta. Configúralo para que se active cuando pase de "Desconectado" a "Detectado".
3. Acción 1 (Captura de pantalla): Selecciona la acción de llamar a un servicio y elige camera.snapshot. Elige la cámara que apunta a la zona del sensor y define una ruta local para guardar la imagen temporalmente (por ejemplo, /config/www/tmp/alerta_seguridad.jpg).
4. Acción 2 (Espera de seguridad): Añade un pequeño retraso o delay de 1 segundo para asegurar que el archivo de imagen se ha escrito completamente en el almacenamiento local antes de intentar enviarlo.
5. Acción 3 (Envío de notificación): Llama al servicio de notificación creado previamente notify.telegram_seguridad. En los parámetros del mensaje, especifica la ruta de la imagen guardada y un texto descriptivo de la alerta.

Consejos avanzados de ahorro energético, confort y mantenimiento

Para garantizar que este sistema de seguridad sea eficiente y no se convierta en una molestia ni sobrecargue el almacenamiento del servidor, es vital seguir una serie de buenas prácticas adaptadas al uso diario en España.

• Evita el desgaste del almacenamiento local: Escribir capturas de imagen constantemente en una tarjeta SD puede reducir drásticamente su vida útil. Si utilizas una Raspberry Pi, configura la ruta temporal de almacenamiento de las capturas en la memoria RAM utilizando directorios de sistema temporales como /tmp.
• Condiciona las alertas al estado del hogar: No querrás recibir fotos tuyas cada vez que salgas al patio. Utiliza condiciones lógicas en Home Assistant para que la automatización solo se ejecute cuando el sistema de alarma esté en modo "Armado fuera" o cuando la geolocalización detecte que no hay nadie en casa.
• Filtros por horario de tarifas eléctricas: Si usas focos disuasorios LED vinculados a las cámaras para mejorar la visibilidad nocturna de la captura, puedes programar la automatización para que solo encienda la iluminación de apoyo durante las horas nocturnas, optimizando el consumo de electricidad de tu instalación inteligente.