> 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 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 do dispositivo e passos de ação para o utilizador. Opcionalmente, filtre utilizadores incluindo ou excluindo grupos específicos.

### Configuração relativa ao envio de emails

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 a partir de `RJReport.EmailSender` configuração do tenant.

Este runbook envia emails utilizando a API do Microsoft Graph. Para enviar emails através da API Graph, é necessário configurar um endereço de email existente na personalização do runbook.

Consulte a [documentação das Definiçõ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 - Padrão)**: Usa o modelo inglês integrado
2. **DE (Alemão)**: Usa o modelo alemão integrado
3. **Personalizado**: Usa um modelo personalizado das 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 faltar qualquer parâmetro do modelo personalizado, o runbook fará automaticamente recurso ao 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:**

* Utilize `\n` para quebras de linha na configuração JSON
* A formatação Markdown (##, ###, \*\*, -) é suportada no texto do modelo
* 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 recurso ao modelo em inglês (EN)
* Ao utilizar o modelo personalizado, selecione "Personalizado - Usar modelo das Personalizações do Runbook" na lista suspensa de Modelos 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 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 |

#### Máx. Dias

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

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

#### Windows

Incluir dispositivos Windows nos resultados.

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

#### MacOS

Incluir dispositivos macOS nos resultados.

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

#### iOS

Incluir dispositivos iOS nos resultados.

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

#### Android

Incluir dispositivos Android nos resultados.

| Propriedade       | Valor      |
| ----------------- | ---------- |
| Obrigatório       | falso      |
| Valor predefinido | 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       | falso                |
| Valor predefinido |                      |
| Tipo              | Cadeia de caracteres |

#### ServiceDeskDisplayName

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

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | falso                |
| Valor predefinido |                      |
| 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       | falso                |
| Valor predefinido |                      |
| Tipo              | Cadeia de caracteres |

#### ServiceDeskPhone

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

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | falso                |
| Valor predefinido |                      |
| Tipo              | Cadeia de caracteres |

#### ServiceDeskPortalUrl

URL do portal do Service Desk para informações de contacto do utilizador, apresentada como uma ligação clicável (opcional).

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | falso                |
| Valor predefinido |                      |
| Tipo              | Cadeia de caracteres |

#### ServiceDeskTicketUrl

Ligação direta para um ticket do Service Desk, apresentada como uma ligação clicável (opcional). Vazio por predefinição, por isso não é adicionada nenhuma ligação de ticket.

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | falso                |
| Valor predefinido |                      |
| Tipo              | Cadeia de caracteres |

#### UseUserScope

Ativar a filtragem por â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 a utilizadores que sejam membros deste grupo. Requer que UseUserScope esteja ativado.

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | falso                |
| Valor predefinido |                      |
| 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       | falso                |
| Valor predefinido |                      |
| Tipo              | Cadeia de caracteres |

#### OverrideEmailRecipient

Opcional: endereço(s) de e-mail para 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 envio para sistemas de tickets. Se ficar vazio, os e-mails serão enviados aos utilizadores finais reais.

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | falso                |
| Valor predefinido |                      |
| Tipo              | Cadeia de caracteres |

#### MailTemplateLanguage

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

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | falso                |
| Valor predefinido | EN                   |
| Tipo              | Cadeia de caracteres |

#### CustomMailTemplateSubject

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

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | falso                |
| Valor predefinido |                      |
| Tipo              | Cadeia de caracteres |

#### CustomMailTemplateBeforeDeviceDetails

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

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | falso                |
| Valor predefinido |                      |
| Tipo              | Cadeia de caracteres |

#### CustomMailTemplateAfterDeviceDetails

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

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | falso                |
| Valor predefinido |                      |
| 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.