> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/pt/automacao/runbooks/runbook-references/org/devices/notify-users-about-stale-devices_scheduled.md).

# Notificar utilizadores sobre dispositivos desatualizados agendado

### Descrição

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

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

O envio de um relatório por e-mail é opcional e só acontece quando é fornecido um destinatário (`EmailTo`) é fornecido. O endereço do remetente é obtido da `RJReport.EmailSender` definição do Tenant.

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

Consulte a [documentação das Configurações de Relatório do RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para mais detalhes.

### 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 em inglês incorporado
2. **DE (Alemão)**: Usa o modelo em alemão incorporado
3. **Personalizados**: Usa um modelo personalizado de Personalizações do Runbook

#### Utilizar modelos de e-mail personalizados

Para usar um modelo de e-mail personalizado (por exemplo, em neerlandês, espanhol ou qualquer outro idioma), precisa de configurar o texto do modelo nas Personalizações do Runbook. Se algum parâmetro de modelo personalizado estiver em falta, o runbook recuará automaticamente 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 está acima dos Detalhes do Dispositivo.** \n\nCaro utilizador ..."
                },
                "CustomMailTemplateAfterDeviceDetails": {
                    "Default": "**Isto está 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 de modelo personalizado (Subject, BeforeDeviceDetails, AfterDeviceDetails) devem ser configurados
* Se algum parâmetro estiver em falta, o runbook recua automaticamente para o modelo em inglês (EN)
* Ao utilizar o modelo personalizado, selecione "Personalizado - Usar modelo das Personalizações do Runbook" no menu suspenso de Modelo de e-mail

### Localização

Organização → Dispositivos → Notificar utilizadores sobre dispositivos inativos (Agendado)

**Nome completo do runbook**

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

### Permissões

#### Permissões de 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 inativo (limiar mínimo).

| Propriedade  | Valor |
| ------------ | ----- |
| Obrigatório  | false |
| Valor padrão | 30    |
| Tipo         | Int32 |

#### MaxDays

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

| Propriedade  | Valor |
| ------------ | ----- |
| Obrigatório  | false |
| Valor padrão |       |
| Tipo         | Int32 |

#### Windows

Incluir dispositivos Windows nos resultados.

| Propriedade  | Valor      |
| ------------ | ---------- |
| Obrigatório  | false      |
| Valor padrão | Verdadeiro |
| Tipo         | Booleano   |

#### MacOS

Incluir dispositivos macOS nos resultados.

| Propriedade  | Valor      |
| ------------ | ---------- |
| Obrigatório  | false      |
| Valor padrão | Verdadeiro |
| Tipo         | Booleano   |

#### iOS

Incluir dispositivos iOS nos resultados.

| Propriedade  | Valor      |
| ------------ | ---------- |
| Obrigatório  | false      |
| Valor padrão | Verdadeiro |
| Tipo         | Booleano   |

#### Android

Incluir dispositivos Android nos resultados.

| Propriedade  | Valor      |
| ------------ | ---------- |
| Obrigatório  | false      |
| Valor padrão | Verdadeiro |
| 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  | false                |
| Valor padrão |                      |
| Tipo         | Cadeia de caracteres |

#### ServiceDeskDisplayName

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

| Propriedade  | Valor                |
| ------------ | -------------------- |
| Obrigatório  | false                |
| Valor padrão |                      |
| Tipo         | Cadeia de caracteres |

#### ServiceDeskEmail

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

| Propriedade  | Valor                |
| ------------ | -------------------- |
| Obrigatório  | false                |
| Valor padrão |                      |
| Tipo         | Cadeia de caracteres |

#### ServiceDeskPhone

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

| Propriedade  | Valor                |
| ------------ | -------------------- |
| Obrigatório  | false                |
| Valor padrão |                      |
| Tipo         | Cadeia de caracteres |

#### UseUserScope

Ative a filtragem de âmbito de utilizadores para incluir ou excluir utilizadores com base na pertença a grupos.

| Propriedade  | Valor    |
| ------------ | -------- |
| Obrigatório  | false    |
| Valor padrão | Falso    |
| Tipo         | Booleano |

#### IncludeUserGroup

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

| Propriedade  | Valor                |
| ------------ | -------------------- |
| Obrigatório  | false                |
| Valor padrão |                      |
| Tipo         | Cadeia de caracteres |

#### ExcludeUserGroup

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

| Propriedade  | Valor                |
| ------------ | -------------------- |
| Obrigatório  | false                |
| Valor padrão |                      |
| Tipo         | Cadeia de caracteres |

#### OverrideEmailRecipient

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

| Propriedade  | Valor                |
| ------------ | -------------------- |
| Obrigatório  | false                |
| Valor padrão |                      |
| Tipo         | Cadeia de caracteres |

#### MailTemplateLanguage

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

| Propriedade  | Valor                |
| ------------ | -------------------- |
| Obrigatório  | false                |
| Valor padrão | EN                   |
| Tipo         | Cadeia de caracteres |

#### CustomMailTemplateSubject

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

| Propriedade  | Valor                |
| ------------ | -------------------- |
| Obrigatório  | false                |
| Valor padrão |                      |
| Tipo         | Cadeia de caracteres |

#### CustomMailTemplateBeforeDeviceDetails

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

| Propriedade  | Valor                |
| ------------ | -------------------- |
| Obrigatório  | false                |
| Valor padrão |                      |
| Tipo         | Cadeia de caracteres |

#### CustomMailTemplateAfterDeviceDetails

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

| Propriedade  | Valor                |
| ------------ | -------------------- |
| Obrigatório  | false                |
| Valor padrão |                      |
| Tipo         | Cadeia de caracteres |

[Voltar à visão geral da referência do runbook](/pt/automacao/runbooks/runbook-references.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.realmjoin.com/pt/automacao/runbooks/runbook-references/org/devices/notify-users-about-stale-devices_scheduled.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.