Automações

Script

Script é uma lista ordenada de ações que organiza a lógica complexa de forma reutilizável dentro de automação residencial. Diferente de uma automação, não possui gatilho (Trigger) próprio; ele aguarda ser 'chamado' (invocado). Assim, funciona como a fundação para comportamentos sofisticados e automações modulares, sob a categoria Lógica de Sequenciamento.


Definição Técnica

Um Script é uma lista ordenada de ações. Diferente de uma Automação, o Script não possui um Gatilho (Trigger); ele aguarda ser 'chamado' (invocado). Isso o torna ideal para rotinas que você deseja disparar de vários lugares diferentes (como um botão físico, um comando de voz e uma automação de horário) sem duplicar a lógica.

Tipos Comuns de Gatilhos

Script Sequencial

Executa ações uma após a outra. Ex: Desliga TV, espera 2s, desliga luzes.

Script com Variáveis

Scripts que aceitam parâmetros externos para mudar seu comportamento.

Script de Verificação

Scripts que verificam estados antes de prosseguir com uma manutenção ou rotina.

Script de Loop

Executa uma ação repetidamente até que uma condição seja atingida.

Considerações Técnicas de Implementação

⚠️
Scripts Paralelos

Cuidado ao rodar o mesmo script múltiplas vezes simultaneamente. Defina o modo de execução (single, restart, queued ou parallel) para evitar comportamentos inesperados.

ℹ️
Depuração (Debug)

Use logs de execução para rastrear onde um script parou, especialmente se ele envolver esperas (wait_templates) por sensores externos.

Conceitos Relacionados

Automação

Scripts não têm gatilhos próprios, automações têm.

Função

Conceito de programação para blocos reutilizáveis.

Dispositivos Geradores

Scripts organizam a lógica complexa de forma reutilizável.

Categoria
Lógica de Sequenciamento

A fundação para comportamentos sofisticados e automações modulares.