Como Configurar Automações no Home Assistant: Tutorial Passo a Passo

Publicado em 9 de outubro de 2026

Principais pontos:

As automações funcionam sob a lógica ‘Quando isso acontece, faça aquilo’, composta por gatilhos (trigger), condições (condition) e ações (action).
O editor visual é ideal para começar, mas o modo YAML oferece controle total sobre lógicas complexas, como múltiplas condições simultâneas.
Sempre teste suas automações usando o botão ‘Testar’ antes de ativá-las definitivamente para evitar loops ou comandos errados.
Use IDs descritivos e comentários nos arquivos YAML para manter a organização à medida que sua casa inteligente cresce.

Saber como configurar automações no Home Assistant é o que transforma uma coleção de gadgets conectados em uma verdadeira casa inteligente autônoma. Se você sente que está apenas trocando um aplicativo pelo outro para acender luzes, este tutorial vai mudar seu jogo. Aqui, vamos do zero absoluto até suas primeiras regras funcionais, usando exemplos reais de iluminação e segurança.

Não importa se você usa Raspberry Pi, NUC ou um dispositivo dedicado; a lógica é universal. Vamos explorar a estrutura básica, a diferença entre o editor visual e o código YAML, e criar três automações essenciais que resolvem problemas comuns do dia a dia.

A Anatomia de uma Automação no Home Assistant

Toda automação no Home Assistant segue uma sintaxe rigorosa baseada em três pilares: Gatilho (Trigger), Condição (Condition) e Ação (Action). Pense nisso como uma frase condicional: “SE algo acontecer, E certas coisas forem verdadeiras, ENTÃO faça algo”.

Gatilho: É o evento que inicia o processo. Pode ser uma mudança de estado (luz ligada/desligada), um horário específico, a detecção de movimento ou a abertura de uma porta.
Condição: São os filtros opcionais. Eles garantem que a ação só ocorra se todos os requisitos forem atendidos (ex: só acender a luz se for à noite).
Ação: É o comando final executado pela automação (ex: chamar um serviço, notificar o celular, ligar um interruptor).

Na minha visão, o maior erro dos iniciantes é tentar fazer tudo de uma vez. Comece simples. Uma automação que liga a luz da cozinha quando a geladeira abre já é um triunfo enorme na primeira semana.

Para entender melhor onde essas peças se encaixam na arquitetura geral do sistema, vale conferir nosso guia principal sobre Como Montar Casa Inteligente: Guia Completo 2026, que cobre desde a escolha dos hubs até a integração de protocolos como Zigbee e Matter.

Editor Visual vs. Modo YAML: Qual Usar?

O Home Assistant oferece duas formas de criar automações, e escolher a certa economiza muito tempo.

Recurso	Editor Visual	Modo YAML
Curva de Aprendizado	Baixa (botões e dropdowns)	Média (requer sintaxe correta)
Flexibilidade	Limitada a opções padrão	Total (qualquer lógica possível)
Velocidade	Rápida para regras simples	Mais rápida para quem sabe codar
Portabilidade	Baixa (difícil migrar)	Alta (fácil copiar/colar)

Dica prática: comece pelo editor visual para entender a lógica. Quando precisar de condições complexas (como verificar dois sensores ao mesmo tempo ou usar templates), mude para o modo YAML clicando em “Editar em YAML”. O sistema converte automaticamente seu trabalho anterior.

Passo a Passo: Criando Sua Primeira Automação

No painel lateral, clique em Configurações > Automações & Dispositivos.
Clique no botão azul + Criar Automção no canto superior direito.
Escolha Iniciar do Zero.
Defina um nome claro, como “Luz Hall ao anoitecer”.

Exemplo Prático 1: Iluminação Automatizada por Horário

Esta é a automação mais útil para iniciantes: acender as luzes externas quando o sol se põe e desligá-las quando ele nasce, sem depender de horários fixos que mudam durante o ano.

Código YAML Copiável

# Acende luz externa ao anoitecer
alias: "Iluminação Externa Automática"
description: "Acende a varanda ao pôr do sol e apaga ao nascer do sol"
trigger:
  - platform: sun
    event: sunset
    offset: "-00:15:00" # Acende 15 minutos ANTES do pôr do sol
  - platform: sun
    event: sunrise
    offset: "+00:05:00" # Apaga 5 minutos DEPOIS do nascer do sol
condition: []
action:
  - service: light.turn_on
    target:
      entity_id: light.varanda
  - delay: 00:00:01 # Pequena pausa para garantir execução sequencial
  - service: light.turn_off
    target:
      entity_id: light.varanda
mode: single

Explicando a lógica: Note o uso do `offset`. Isso é crucial porque dependendo da época do ano, o pôr do sol pode variar bastante. Colocar um offset negativo garante que a área esteja iluminada antes que a escuridão total chegue.

Exemplo Prático 2: Segurança Passiva com Sensores de Movimento

Vamos criar uma automação que liga a luz do corredor apenas se houver movimento E estiver escuro E não houver ninguém dormindo na casa (assumindo que os quartos estão ocupados).

Estrutura Completa

alias: "Corredor Seguro"
trigger:
  - platform: state
    entity_id: binary_sensor.movimento_corredor
    to: "on"
condition:
  - condition: time
    after: "22:00:00"
    before: "06:00:00"
  - condition: state
    entity_id: lock.porta_frente
    state: "locked"
action:
  - service: light.turn_on
    data:
      brightness_pct: 20 # Luz fraca para não acordar ninguém
    target:
      entity_id: light.corredor
  - wait_for_trigger:
      - platform: state
        entity_id: binary_sensor.movimento_corredor
        to: "off"
  - delay: 00:00:30 # Aguarda 30 segundos após parar o movimento
  - service: light.turn_off
    target:
      entity_id: light.corredor

Repare bem nesse detalhe: o bloco `wait_for_trigger` seguido de `delay` é a técnica profissional para fazer a luz desligar sozinha depois que a pessoa sai do cômodo. Sem isso, a luz ficaria acesa indefinidamente.

Exemplo Prático 3: Notificação de Janela Aberta

Muitas pessoas esquecem janelas abertas quando chove ou quando saem de casa. Esta automação envia uma notificação no celular via app Home Assistant Companion se detectar que a janela do banheiro foi aberta enquanto a máquina de lavar estava ligada.

alias: "Alerta Banheiro Molhado"
trigger:
  - platform: state
    entity_id: switch.lavadora_smart
    to: "on"
condition:
  - condition: state
    entity_id: binary_sensor.janela_banheiro
    state: "open"
action:
  - service: notify.mobile_app_iphone_alex
    data:
      title: "⚠️ Atenção!"
      message: "A janela do banheiro está aberta e a lavadora iniciou o ciclo."

Boas Práticas e Erros Comuns

Depois de meses acompanhando comunidades de usuários brasileiros, identifiquei padrões de erros que derrubam sistemas inteiros.

Loops Infinitos: Nunca crie uma automação que é disparada por uma ação que ela mesma realiza. Exemplo ruim: acender luz A quando sensor B detecta movimento, e ter outra automação que liga sensor B quando luz A acende.
Entidades Erradas: Sempre copie o `entity_id` diretamente da lista de dispositivos. Um caractere errado faz a automação falhar silenciosamente.
Falta de Teste: Use o botão Testar na interface gráfica. Ele simula o gatilho sem esperar o evento real ocorrer.

Se suas automações começarem a ficar lentas, verifique quantas instâncias estão rodando em paralelo. Para casas grandes, considere agrupar dispositivos semelhantes (todas as luzes do quarto 1 viram um grupo `light.quarto_1`) para simplificar o código.

Além disso, mantenha a privacidade em mente ao compartilhar trechos de YAML em fóruns. Remova nomes reais de devices e IDs únicos antes de postar, especialmente se você possui câmeras ou fechaduras integradas. Veja mais dicas em nosso artigo sobre Privacidade em Casa Inteligente: Como Proteger Seus Dados.

Organizando Seus Arquivos

À medida que você aprende como configurar automações no home assistant, seus arquivos vão crescer. Organize-os assim:

Coloque todas as automações principais no arquivo raiz `automations.yaml`.
Se você tiver muitas, use a diretiva `automation split` no configuration.yaml para carregar subpastas.
Nomeie cada automação com prefixo: `security_`, `lighting_`, `climate_`.

Checklist Final Antes de Ativar

Verifique se todos os IDs de entidades existem (use o botão Inspecionar Estado).
Confira se a indentação do YAML está correta (2 espaços, nunca Tab).
Salve e recarregue as automações (`Dev Tools` > `YAML` > `Recarregar`).
Monitore os logs por 24 horas para ver se há erros silenciosos.

Com essa base, você tem tudo para criar centenas de variações. O segredo não é decorar o código, mas entender a lógica condicional por trás dele.

Alberto Rogatto

Editor de Tecnologia

Acompanha o mercado de tecnologia, eletronicos e gadgets ha anos, sempre com foco em ajudar o leitor brasileiro a escolher com o melhor custo-beneficio.

Ver todos os posts de Alberto Rogatto