Webhooks en Home Assistant: dispara automatizaciones desde cualquier servicio de internet

Qué es un webhook, cómo crear el primero en Home Assistant paso a paso, cómo usar los datos que llegan, cuatro ideas para empezar y las reglas de seguridad. En la nube funcionan sin abrir puertos.

Un atajo del móvil que enciende la calefacción, un formulario web que abre la persiana, un servicio externo que te avisa con una luz roja cuando algo falla… Todo eso se hace con webhooks: una dirección secreta de tu Home Assistant que, cuando alguien la llama, dispara una automatización. Con Home Assistant en la nube funcionan desde el primer minuto, sin abrir puertos ni montar nada.

Qué es un webhook

Es la forma más simple de que un servicio le avise a otro de que pasó algo. En vez de preguntar cada rato «¿hay novedades?», el servicio llama a una dirección web en el momento justo, y quien la recibe actúa. En Home Assistant esa dirección tiene esta forma:

https://ha.TU-ID.coiaca.app/api/webhook/TU-ID-DE-WEBHOOK

La última parte, el ID del webhook, la eliges tú y funciona como una contraseña: quien la conoce puede disparar la automatización. Por eso conviene que sea larga y difícil de adivinar.

Por qué en la nube es más fácil

Para que un servicio de internet llame a tu Home Assistant, tu Home Assistant tiene que estar en internet. Si está en casa, eso supone abrir un puerto en el router, tener una dirección fija o usar un servicio intermedio. Si está en la nube, ya tiene su dirección HTTPS con certificado válido: el webhook funciona sin configurar nada más.

Tu primer webhook, paso a paso

  1. En Home Assistant, ve a Ajustes → Automatizaciones y escenas y crea una automatización nueva.
  2. Como disparador, elige Webhook. Home Assistant te propone un ID al azar: déjalo o cámbialo por otro igual de largo.
  3. Abre las opciones del disparador (la rueda dentada) y desactiva el acceso solo desde la red local, que viene activado. Si no, las llamadas desde internet se rechazan.
  4. Añade la acción que quieras, por ejemplo encender una luz, y guarda.

Si prefieres YAML, en automations.yaml queda así:

- alias: Webhook - encender la luz del pasillo
  triggers:
    - trigger: webhook
      webhook_id: "pasillo-7f3k9q2xw8m4"
      allowed_methods:
        - POST
      local_only: false
  actions:
    - action: light.turn_on
      target:
        entity_id: light.pasillo

Para probarlo, desde cualquier ordenador con terminal:

curl -X POST https://ha.TU-ID.coiaca.app/api/webhook/pasillo-7f3k9q2xw8m4

Si la luz se enciende, ya está: cualquier servicio que sepa llamar a una dirección web puede hacer lo mismo.

Usar los datos que llegan

Muchos servicios mandan información junto con la llamada, normalmente en JSON. Home Assistant la deja en trigger.json (y los parámetros de la dirección, en trigger.query). Por ejemplo, si llamas al webhook con {"brillo": 40}, la acción puede usar ese número:

  actions:
    - action: light.turn_on
      target:
        entity_id: light.pasillo
      data:
        brightness_pct: "{{ trigger.json.brillo | default(100) }}"

Y para probarlo:

curl -X POST -H "Content-Type: application/json" -d '{"brillo": 40}' 
  https://ha.TU-ID.coiaca.app/api/webhook/pasillo-7f3k9q2xw8m4

Cuatro ideas para empezar

  • Un atajo del móvil. Los atajos del iPhone y apps como Tasker en Android pueden llamar a una dirección web. Un botón en la pantalla de inicio, «Llego en 20 minutos», enciende la calefacción.
  • Servicios de automatización web. Los servicios que conectan aplicaciones entre sí (correo, calendario, hojas de cálculo, formularios) suelen tener una acción «llamar a un webhook». Por ejemplo: cuando entra un correo con cierto asunto, que parpadee una luz.
  • Avisos de monitorización. Si tienes una web o un servidor vigilado por un servicio de monitorización, este puede llamar al webhook cuando algo cae: una luz en rojo en el escritorio y una notificación al móvil.
  • Tus propios scripts. Un script en otro ordenador, una placa o un servidor puede avisar a Home Assistant cuando termina una tarea, sin instalar nada: basta con una llamada HTTP.

Seguridad: tres reglas

  • Trata el ID como una contraseña. Largo, al azar y sin compartirlo. Si se filtra, cámbialo en la automatización y ya.
  • Un webhook por uso. Así, si tienes que cambiar uno, no rompes los demás.
  • Nada crítico sin una condición más. No uses un webhook solo para abrir la puerta de casa o desarmar una alarma. Si lo haces, añade una condición, por ejemplo que alguien de la familia esté en casa según la app.

Con Coiaca Cloud HA

En Coiaca Cloud HA tienes el Home Assistant oficial, sin modificar, en tu propia instancia privada en la nube, con su dirección HTTPS desde el primer minuto. Los webhooks funcionan tal cual: creas la automatización, desactivas el acceso solo local y cualquier servicio de internet puede llamarla.

Con los 30 días de prueba gratis puedes conectar tus primeros servicios y armar tus avisos antes del primer pago. Si no es para ti, cancelas antes del día 31.

Prueba Coiaca Cloud HA 30 días gratis

Fuentes

Coiaca no está afiliada a Open Home Foundation ni Nabu Casa. Las marcas citadas son de sus titulares.

Deja un comentario

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *