# Regras de evento

 As regras de eventos permitem automatizar reações a eventos de dispositivos suportados. Abra **Dashboard** → **Event rules** para criar regras que monitorem eventos de inscrição, desinscrição, não conformidade e geofencing do Android, e então acionem uma ou mais ações automaticamente.

## O que uma regra de evento pode fazer

 Cada regra combina um **assunto**, um **evento** e uma ou duas **ações**. Os assuntos suportados são **Todos os dispositivos**, **Dispositivo específico** e **Política**.

- **Eventos**: dispositivo inscrito, dispositivo desinscrito, dispositivo torna-se não conforme, entrada de geofence, saída de geofence.
- **Ações do dispositivo**: desativar dispositivo, ativar dispositivo, bloquear dispositivo.
- **Ação de e-mail**: envie um e-mail de notificação para os administradores e, quando habilitado, para os gerentes delegados.

<p class="callout info"> Uma regra pode conter apenas uma ação de e-mail, apenas uma ação de dispositivo ou uma ação de dispositivo mais uma ação de e-mail. Se ambas as ações estiverem configuradas, o Cerberus Enterprise executa primeiro a ação de dispositivo e depois a ação de e-mail. </p>

## Regras de plataforma e compatibilidade

 Os eventos e ações disponíveis dependem do assunto selecionado e da plataforma aplicável a esse assunto.

- **Android** suporta inscrição, desinscrição, não conformidade e eventos de geofence.
- **Apple** suporta eventos de inscrição, desinscrição e não conformidade.
- **Desativar dispositivo** e **Ativar dispositivo** são ações exclusivas para Android.
- **Bloquear dispositivo** e **Enviar e-mail** estão disponíveis tanto no Android quanto no Apple, quando o evento selecionado os suportar.
- **Dispositivo desinscrito** suporta apenas e-mail.

## Lista de regras

 A lista de regras de Eventos é a página principal de gerenciamento para este recurso. Ela inclui uma tabela pesquisável com nome da regra, assunto, evento, ações, plataforma, estado de ativação e hora de atualização.

- Use os chips de filtro para alternar entre todas as regras, regras ativadas, regras desativadas e pesquisa de texto.
- Use o botão **Atualizar** para recarregar a visualização atual da tabela.
- Use a interruptor de ativação em cada linha para habilitar ou desabilitar temporariamente uma regra.
- Use o modo de seleção de várias linhas para excluir várias regras juntas.
- Use **Criar regra de evento** para abrir o editor de uma nova regra.

## Editor de regras

 O editor é dividido em seções de **Geral**, **Escopo**, **Gatilho** e **Ações**. Na parte inferior da página, uma barra de ações fixa mantém os botões principais visíveis enquanto você rola a página.

### Geral

- **Nome**: obrigatório, até 150 caracteres.
- **Descrição**: opcional, até 2000 caracteres.
- **Regra habilitada**: salva a regra no estado habilitado ou desabilitado.

### Escopo

 O escopo define quais dispositivos a regra pode corresponder. O editor também mostra a plataforma resolvida e, quando disponível, o contexto de política efetivo.

- **Todos os dispositivos**: a regra pode corresponder a todos os dispositivos suportados na empresa.
- **Dispositivo específico**: selecione um dispositivo gerenciado no diálogo de seleção.
- **Política**: selecione um modelo de política no diálogo de seleção.

### Acionar

 A seção de gatilho filtra automaticamente os eventos disponíveis com base no escopo e na plataforma selecionados.

#### Gatilhos de geofencing

 As regras de entrada e saída de geofence são suportadas apenas para Android e exigem um contexto de política Android válido. Para relatórios de localização e definições de geofence, consulte [**Localização e geofence**](https://enterprise.cerberusapp.com/docs/books/manual-do-usuario/page/localizacao-e-cerca-geografica "Location and geofence").

- Se o sujeito for **Todos os dispositivos**, a regra sempre se aplica a **Qualquer geofence**.
- Se o assunto for um dispositivo ou política, você pode escolher **Qualquer geofence** ou uma **Geofence específica**.
- A lista específica de geofencing é carregada a partir do contexto da política efetiva do dispositivo ou política selecionado.

### Ações

 A seção de ações permite que você escolha uma ação opcional do dispositivo e uma notificação de e-mail opcional. A interface oculta automaticamente as combinações não suportadas.

- Se nenhuma ação de dispositivo estiver disponível para o evento e escopo selecionados, você ainda pode salvar uma regra apenas por e-mail.
- Se o e-mail estiver desativado para o evento e plataforma selecionados, a alternância de e-mail não estará disponível.
- Uma regra sem nenhuma ação é inválida e não pode ser salva.

## Destinatários do e-mail

 As ações de e-mail sempre incluem usuários corporativos com a função **ADMIN** . Se a empresa for gerenciada por multi-tenancy, você pode expandir os destinatários para incluir os administradores de MT.

- **Apenas gestores principais**: inclui administradores de empresa e os contatos do gestor principal da MT.
- **Gerentes principais e gerentes de subcontas**: também adiciona os gerentes de subcontas atribuídos.
- A lista de pré-visualização mostra os endereços de e-mail reais que serão usados quando a regra for executada.
- Apenas os gestores delegados com acesso concedido à empresa estão incluídos na lista de destinatários finais.

## Comportamento de execução

 As regras de eventos são executadas imediatamente quando o Cerberus Enterprise recebe um evento suportado das integrações de backend. Regras desativadas são ignoradas automaticamente.

 As execuções bem-sucedidas e as falhas são registradas no log do sistema com mensagens legíveis por humanos.