> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unicontrol.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Gatilhos (Triggers)

> Tipos de gatilhos disponíveis para suas automações

# Gatilhos (Triggers)

Gatilhos definem **quando** uma automação deve ser disparada. Você pode combinar multiplos gatilhos — a automação será disparada quando **qualquer um** deles ocorrer.

<AccordionGroup>
  <Accordion title="Mudança de Estado">
    Dispara quando o estado de uma entidade muda.

    **Parâmetros:**

    * `entity_id` — Entidade a monitorar
    * `from` (opcional) — Estado anterior esperado
    * `to` (opcional) — Novo estado esperado
    * `for` (opcional) — Tempo em segundos que o estado deve permanecer antes de disparar

    **Exemplo:** Quando a porta (`binary_sensor.porta`) mudar de `off` para `on` por 5 segundos.
  </Accordion>

  <Accordion title="Estado Numérico">
    Dispara quando um valor numérico cruza um limite.

    **Parâmetros:**

    * `entity_id` — Entidade a monitorar
    * `attribute` (opcional) — Atributo específico a monitorar
    * `above` (opcional) — Valor mínimo
    * `below` (opcional) — Valor máximo
    * `for` (opcional) — Tempo de permanencia

    **Exemplo:** Quando a temperatura (`sensor.temperatura`) ficar acima de 30°C.
  </Accordion>

  <Accordion title="Horário">
    Dispara em um horário específico.

    **Parâmetros:**

    * `at` — Horário no formato HH:MM:SS
    * `days` — Dias da semana (seg, ter, qua, qui, sex, sab, dom)

    **Exemplo:** Todo dia as 07:00 de segunda a sexta.
  </Accordion>

  <Accordion title="Evento">
    Dispara quando um evento específico e emitido no sistema.

    **Parâmetros:**

    * `event_type` — Tipo do evento
    * `event_data` (opcional) — Dados adicionais para filtrar

    **Exemplo:** Quando o evento `automation.trigger` for emitido.
  </Accordion>

  <Accordion title="Webhook">
    Dispara quando uma requisição HTTP chega no webhook configurado.

    **Parâmetros:**

    * `webhook_id` — Identificador único do webhook

    **Exemplo:** Quando um sistema externo enviar uma requisição para o webhook.
  </Accordion>

  <Accordion title="Serviço">
    Dispara quando um serviço específico e chamado.

    **Parâmetros:**

    * `domain` — Domínio do serviço
    * `service` — Nome do serviço

    **Exemplo:** Quando o serviço `light.turn_on` for chamado.
  </Accordion>

  <Accordion title="Mensagem MQTT">
    Dispara quando uma mensagem MQTT e recebida em um tópico.

    **Parâmetros:**

    * `topic` — Tópico MQTT a monitorar
    * `payload` (opcional) — Payload esperado

    **Exemplo:** Quando uma mensagem for recebida no tópico `sensores/movimento`.
  </Accordion>

  <Accordion title="Tag (NFC/QR Code)">
    Dispara quando uma tag NFC ou QR code e escaneada.

    **Parâmetros:**

    * `tag_id` — ID da tag registrada

    **Exemplo:** Quando a tag da porta de entrada for escaneada.
  </Accordion>

  <Accordion title="Ação de Notificação (Aplicativo Móvel)">
    Dispara quando o usuário responde a uma notificação no Aplicativo Móvel.

    **Parâmetros:**

    * `action` — Identificador da ação na notificação
    * `device_id` — Dispositivo mobile que respondeu

    **Exemplo:** Quando o usuário clicar em "Abrir portao" na notificação.
  </Accordion>
</AccordionGroup>