O que você vai precisar
Passo a passo
2. Crie uma nova automação com Script Editor
Clique em adicionar nova automação e escolha a opção de script. O editor vai abrir um arquivo com estrutura em YAML, geralmente dividido entre metadata e automations.
Dica: Se a opção não aparecer, confira se sua conta está no Public Preview e se o recurso já foi liberado para sua região.3. Escreva a metadata da automação
Comece pelo nome e descrição. Use algo curto e funcional. Exemplo: Luz do hall por botão. A descrição pode dizer quando roda e o que muda.
Dica: Nome de dispositivo é diferente de nome de automação. Não misture.4. Defina o starter
Starter é o que inicia a automação. Pode ser um botão, interruptor, horário, estado de dispositivo ou presença. Para este exemplo, use um botão ou interruptor que já esteja no Google Home.
Dica: O dispositivo precisa aparecer no autocomplete do editor. Se não aparece, talvez não exponha esse tipo de evento ao Google Home.5. Adicione uma condição de horário
Use uma condition para limitar a automação à noite. Condição é filtro: ela não inicia nada sozinha; apenas decide se a ação roda depois do starter.
Dica: Essa distinção evita muita automação quebrada. Evento começa, condição autoriza.6. Defina a ação de luz
Action é o comando. Para acender luz, use comando OnOff ou brilho quando suportado. O nome do dispositivo deve bater com o formato aceito pelo Google Home, incluindo cômodo quando necessário.
Dica: Copie o nome pelo autocomplete. Digitar de memória é pedir erro bobo.7. Use um YAML base para começar
Use este modelo como ponto de partida, trocando nomes de dispositivos pelos seus:
Home Assistant (YAML)metadata: name: Luz do hall por botão description: Acende a luz do hall quando o botão é pressionado à noite. automations: - starters: - type: device.state.OnOff device: Botão Hall - Entrada state: on is: true condition: type: time.between after: 18:00 before: 06:00 actions: - type: device.command.OnOff devices: - Luz Hall - Entrada on: trueDica: Se o editor acusar tipo inválido, procure a ação pelo autocomplete. O modelo mostra lógica, não garante suporte do seu dispositivo.8. Valide antes de salvar
Clique em Validate. O Google Home não ativa script com erro. Leia as mensagens: normalmente elas apontam indentação, dispositivo inexistente ou ação não suportada.
Dica: Erro em YAML costuma estar dois espaços acima de onde você está olhando.9. Salve e teste com o dispositivo real
Salve a automação, pressione o botão e veja se a luz acende. Depois teste fora do horário permitido para confirmar se a condição bloqueia a ação.
Dica: Teste o bloqueio. Automação que só foi testada quando deve funcionar ainda não foi testada.10. Consulte o histórico se algo falhar
Abra os logs de automação quando disponíveis. Eles mostram se o starter disparou, se a condição passou e se a ação falhou. É o raio-x da rotina.
Dica: Sem log, você fica chutando entre Wi-Fi, app e nome errado.
O Script Editor parece coisa de desenvolvedor. Não é bem assim. Ele é uma forma menos infantil de dizer ao Google Home: quando isso acontecer, se essa condição for verdadeira, faça aquilo.
Só que a liberdade cobra entrada.
1. YAML não aceita bagunça#
Espaços importam. Dois espaços fora do lugar podem quebrar a automação inteira. É chato, mas é justamente essa estrutura que deixa o script legível depois.
2. Nem todo dispositivo expõe tudo#
Uma lâmpada pode ligar e ajustar brilho, mas não aceitar cor pelo editor. Um botão pode aparecer no app e não oferecer evento útil. O Google Home depende do que o fabricante expõe.
3. Validação é parte do tutorial#
Validar não é burocracia. É o momento em que o editor diz se sua casa entendeu a ordem antes de você apertar o botão na parede.
Você criou uma automação YAML com metadata, starter, condição de horário, action, validação e teste real. A primeira dá trabalho; a segunda sai em metade do tempo.