Webhook
Webhooks são callbacks HTTP definidos pelo usuário, acionados por eventos em sistemas externos e enviados ao hub de automação em tempo real via HTTP/HTTPS (REST). Funcionam como ponte entre nuvem e local; por exemplo, um entregador chega e o app envia um sinal para o Home Assistant. Use HTTPS e IDs longos para segurança.
Definição Aprofundada
Webhooks são 'callbacks' de HTTP definidos pelo usuário. Eles são acionados por eventos em sistemas externos, como uma notificação de entrega, um alerta de segurança de uma câmera em nuvem ou um comando de um serviço como IFTTT. Quando o evento ocorre, o serviço de origem faz uma requisição HTTP (geralmente do tipo POST) para a URL configurada no seu hub de automação, entregando um payload de dados instantaneamente.
Arquitetura e Funcionamento
Ao contrário do polling, onde o hub pergunta 'há algo novo?' a cada minuto, o Webhook entrega a informação no milissegundo em que o evento acontece.
Permite que sistemas completamente diferentes (como um banco ou um serviço de clima) conversem com sua casa sem que o hub precise conhecer o funcionamento interno deles.
Suporta o envio de dados complexos em formato JSON, permitindo que a automação receba variáveis detalhadas, como nomes de usuários, coordenadas ou valores de sensores.
Praticamente qualquer serviço web moderno que possua uma API é capaz de enviar Webhooks, tornando-o a ferramenta definitiva para automação baseada em nuvem.
Cenário Prático: A Ponte entre Nuvem e Local
Imagine que você quer que as luzes da garagem pisquem quando um entregador de comida estiver chegando. O aplicativo de entregas envia um sinal (Webhook) para o seu Home Assistant. No momento em que o entregador entra no seu raio de entrega, o servidor do app faz uma chamada para a sua URL personalizada: `https://seu-hub.com/api/webhook/entrega_chegando`. Seu sistema recebe esse 'empurrão' e executa a cena de iluminação imediatamente.
Análise Técnica
- ·Elimina o tráfego desnecessário de rede causado pelo polling.
- ·Resposta em tempo real para eventos externos.
- ·Fácil integração com ferramentas como Zapier, IFTTT e Node-RED.
- ·Permite disparar automações a partir de simples URLs (HTTP GET/POST).
- ·Requer que o hub esteja exposto à internet (ou via proxy reverso/nuvem).
- ·Menos seguro que protocolos locais se a URL do Webhook não for protegida.
- ·Depende totalmente da estabilidade da conexão de internet e da API do terceiro.
Padrão
HTTP/HTTPS (REST)