# Notificar Utilizadores Sobre Dispositivos Obsoletos Agendado

### Descrição

Identifica dispositivos que não estiveram ativos durante um número especificado de dias e envia notificações por e-mail personalizadas aos utilizadores principais desses dispositivos. O e-mail contém informações sobre o dispositivo e passos de ação para o utilizador. Opcionalmente, filtre utilizadores incluindo ou excluindo grupos específicos.

### Configuração relativa ao envio de e-mails

Este runbook envia e-mails usando a API do Microsoft Graph. Para enviar e-mails via a API Graph, é necessário configurar um endereço de e-mail existente na personalização do runbook.

Este processo é descrito em detalhe na [Configuração do Relatório por E-mail](https://github.com/realmjoin/realmjoin-runbooks/tree/master/docs/general/setup-email-reporting.md) documentação.

### Seleção do idioma do modelo de e-mail

Este runbook suporta três opções de modelo de e-mail:

1. **EN (Inglês - Predefinição)**: Usa o modelo inglês incorporado
2. **DE (Alemão)**: Usa o modelo alemão incorporado
3. **Personalizados**: Usa um modelo personalizado de Runbook Customizations

#### Utilizar modelos de e-mail personalizados

Para utilizar um modelo de e-mail personalizado (por exemplo, em neerlandês, espanhol ou qualquer outro idioma), precisa de configurar o texto do modelo em Runbook Customizations. Se algum parâmetro do modelo personalizado estiver em falta, o runbook fará automaticamente fallback para o modelo em inglês.

**Exemplo: modelo personalizado**

```json
{
    "Runbooks": {
        "rjgit-org_devices_notify-users-about-stale-devices_scheduled": {
            "Parameters": {
                "CustomMailTemplateSubject": {
                    "Default": "Este é um assunto personalizado - Ação necessária: Dispositivos inativos"
                },
                "CustomMailTemplateBeforeDeviceDetails": {
                    "Default": "**Isto fica acima dos detalhes do dispositivo.** \n\nCaro utilizador ..."
                },
                "CustomMailTemplateAfterDeviceDetails": {
                    "Default": "**Isto fica abaixo dos detalhes do dispositivo.** \n\n## O que deve fazer..."
                }
            }
        }
    }
}
```

**Notas importantes:**

* Use `\n` para quebras de linha na configuração JSON
* A formatação Markdown (##, ###, \*\*, -) é suportada no texto do modelo
* Todos os três parâmetros do modelo personalizado (Subject, BeforeDeviceDetails, AfterDeviceDetails) devem ser configurados
* Se algum parâmetro estiver em falta, o runbook faz automaticamente fallback para o modelo em inglês (EN)
* Ao utilizar o modelo personalizado, selecione "Custom - Use Template from Runbook Customizations" na lista suspensa Mail Template

### Localização

Organization → Devices → Notify Users About Stale Devices (Scheduled)

**Nome completo do runbook**

rjgit-org\_devices\_notify-users-about-stale-devices\_scheduled

### Permissões

#### Permissões da aplicação

* **Tipo**: Microsoft Graph
  * DeviceManagementManagedDevices.Read.All
  * Directory.Read.All
  * Device.Read.All
  * Group.Read.All
  * Mail.Send

### Parâmetros

#### Dias

Número de dias sem atividade para ser considerado obsoleto (limiar mínimo).

| Propriedade       | Valor |
| ----------------- | ----- |
| Obrigatório       | falso |
| Valor predefinido | 30    |
| Tipo              | Int32 |

#### MaxDays

Número máximo opcional de dias sem atividade. Se definido, apenas os dispositivos inativos entre Days e MaxDays serão incluídos.

| Propriedade       | Valor |
| ----------------- | ----- |
| Obrigatório       | falso |
| Valor predefinido |       |
| Tipo              | Int32 |

#### Windows

Inclui dispositivos Windows nos resultados.

| Propriedade       | Valor    |
| ----------------- | -------- |
| Obrigatório       | falso    |
| Valor predefinido | True     |
| Tipo              | Booleano |

#### MacOS

Inclui dispositivos macOS nos resultados.

| Propriedade       | Valor    |
| ----------------- | -------- |
| Obrigatório       | falso    |
| Valor predefinido | True     |
| Tipo              | Booleano |

#### iOS

Inclui dispositivos iOS nos resultados.

| Propriedade       | Valor    |
| ----------------- | -------- |
| Obrigatório       | falso    |
| Valor predefinido | True     |
| Tipo              | Booleano |

#### Android

Inclui dispositivos Android nos resultados.

| Propriedade       | Valor    |
| ----------------- | -------- |
| Obrigatório       | falso    |
| Valor predefinido | True     |
| Tipo              | Booleano |

#### EmailFrom

O endereço de e-mail do remetente. Isto precisa de ser configurado na personalização do runbook.

| Propriedade       | Valor  |
| ----------------- | ------ |
| Obrigatório       | falso  |
| Valor predefinido |        |
| Tipo              | String |

#### ServiceDeskDisplayName

Nome apresentado do Service Desk para informações de contacto do utilizador (opcional).

| Propriedade       | Valor  |
| ----------------- | ------ |
| Obrigatório       | falso  |
| Valor predefinido |        |
| Tipo              | String |

#### ServiceDeskEmail

Endereço de e-mail do Service Desk para informações de contacto do utilizador (opcional).

| Propriedade       | Valor  |
| ----------------- | ------ |
| Obrigatório       | falso  |
| Valor predefinido |        |
| Tipo              | String |

#### ServiceDeskPhone

Número de telefone do Service Desk para informações de contacto do utilizador (opcional).

| Propriedade       | Valor  |
| ----------------- | ------ |
| Obrigatório       | falso  |
| Valor predefinido |        |
| Tipo              | String |

#### UseUserScope

Ativar a filtragem do âmbito do utilizador para incluir ou excluir utilizadores com base na associação a grupos.

| Propriedade       | Valor    |
| ----------------- | -------- |
| Obrigatório       | falso    |
| Valor predefinido | Falso    |
| Tipo              | Booleano |

#### IncludeUserGroup

Enviar e-mails apenas para utilizadores que sejam membros deste grupo. Requer que UseUserScope esteja ativado.

| Propriedade       | Valor  |
| ----------------- | ------ |
| Obrigatório       | falso  |
| Valor predefinido |        |
| Tipo              | String |

#### ExcludeUserGroup

Não enviar e-mails para utilizadores que sejam membros deste grupo. Requer que UseUserScope esteja ativado.

| Propriedade       | Valor  |
| ----------------- | ------ |
| Obrigatório       | falso  |
| Valor predefinido |        |
| Tipo              | String |

#### OverrideEmailRecipient

Opcional: endereço(s) de e-mail para onde enviar todas as notificações em vez dos utilizadores finais. Pode ser separado por vírgulas para múltiplos destinatários. Perfeito para testes, pilotos ou envio para sistemas de tickets. Se for deixado em branco, os e-mails serão enviados aos utilizadores finais reais.

| Propriedade       | Valor  |
| ----------------- | ------ |
| Obrigatório       | falso  |
| Valor predefinido |        |
| Tipo              | String |

#### MailTemplateLanguage

Selecione qual modelo de e-mail usar: EN (Inglês, predefinição), DE (Alemão) ou Custom (de Runbook Customizations).

| Propriedade       | Valor  |
| ----------------- | ------ |
| Obrigatório       | falso  |
| Valor predefinido | EN     |
| Tipo              | String |

#### CustomMailTemplateSubject

Linha de assunto de e-mail personalizada (usada apenas quando MailTemplateLanguage está definido como 'Custom').

| Propriedade       | Valor  |
| ----------------- | ------ |
| Obrigatório       | falso  |
| Valor predefinido |        |
| Tipo              | String |

#### CustomMailTemplateBeforeDeviceDetails

Texto personalizado a apresentar antes da lista de dispositivos (usado apenas quando MailTemplateLanguage está definido como 'Custom'). Suporta formatação Markdown.

| Propriedade       | Valor  |
| ----------------- | ------ |
| Obrigatório       | falso  |
| Valor predefinido |        |
| Tipo              | String |

#### CustomMailTemplateAfterDeviceDetails

Texto personalizado a apresentar após a lista de dispositivos (usado apenas quando MailTemplateLanguage está definido como 'Custom'). Suporta formatação Markdown.

| Propriedade       | Valor  |
| ----------------- | ------ |
| Obrigatório       | falso  |
| Valor predefinido |        |
| Tipo              | String |

[Voltar à visão geral da referência de Runbook](https://docs.realmjoin.com/pt/automacao/runbooks/runbook-references)