> 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/es/automatizacion/runbooks/runbook-references/org/devices/notify-users-about-stale-devices_scheduled.md).

# Notificar a los usuarios sobre dispositivos obsoletos programado

### Descripción

Identifica dispositivos que no han estado activos durante un número determinado de días y envía notificaciones de correo electrónico personalizadas a los usuarios principales de esos dispositivos. El correo contiene información del dispositivo y pasos de acción para el usuario. Opcionalmente, filtra a los usuarios incluyendo o excluyendo grupos específicos.

### Configuración sobre el envío de correos electrónicos

Enviar un informe por correo electrónico es opcional y solo ocurre cuando se proporciona un destinatario (`EmailTo`) se proporciona. La dirección del remitente se toma de la `RJReport.EmailSender` configuración de Tenant.

Este runbook envía correos electrónicos mediante la API de Microsoft Graph. Para enviar correos electrónicos a través de la API de Microsoft Graph, debe configurar una dirección de correo electrónico existente en la personalización del runbook.

Consulte la [documentación de configuración de informes de RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para más detalles.

### Selección del idioma de la plantilla de correo

Este runbook admite tres opciones de plantilla de correo:

1. **EN (Inglés - Predeterminado)**: Usa la plantilla integrada en inglés
2. **DE (Alemán)**: Usa la plantilla integrada en alemán
3. **Personalizado**: Usa una plantilla personalizada de Runbook Customizations

#### Uso de plantillas de correo personalizadas

Para usar una plantilla de correo personalizada (por ejemplo, en neerlandés, español o cualquier otro idioma), debes configurar el texto de la plantilla en Runbook Customizations. Si falta algún parámetro de la plantilla personalizada, el runbook volverá automáticamente a la plantilla en inglés.

**Ejemplo: plantilla personalizada**

```json
{
    "Runbooks": {
        "rjgit-org_devices_notify-users-about-stale-devices_scheduled": {
            "Parameters": {
                "CustomMailTemplateSubject": {
                    "Default": "Este es un asunto personalizado - Acción requerida: dispositivos inactivos"
                },
                "CustomMailTemplateBeforeDeviceDetails": {
                    "Default": "**Esto está encima de los detalles del dispositivo.** \\n\\nEstimado usuario ..."
                },
                "CustomMailTemplateAfterDeviceDetails": {
                    "Default": "**Esto está debajo de los detalles del dispositivo.** \\n\\n## Qué debes hacer..."
                }
            }
        }
    }
}
```

**Notas importantes:**

* Usa `\\n` para los saltos de línea en la configuración JSON
* Se admite formato Markdown (##, ###, \*\*, -) en el texto de la plantilla
* Deben configurarse los tres parámetros de la plantilla personalizada (Subject, BeforeDeviceDetails, AfterDeviceDetails)
* Si falta algún parámetro, el runbook vuelve automáticamente a la plantilla en inglés (EN)
* Al usar la plantilla personalizada, selecciona "Personalizado - Usa plantilla de Runbook Customizations" en el desplegable de plantilla de correo

### Ubicación

Organización → Dispositivos → Notificar a los usuarios sobre dispositivos inactivos (Programado)

**Nombre completo del Runbook**

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

### Permisos

#### Permisos de aplicación

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

### Parámetros

#### Days

Número de días sin actividad para considerarse inactivo (umbral mínimo).

| Propiedad            | Valor |
| -------------------- | ----- |
| Requerido            | false |
| Valor predeterminado | 30    |
| Tipo                 | Int32 |

#### MaxDays

Número máximo opcional de días sin actividad. Si se define, solo se incluirán los dispositivos inactivos entre Days y MaxDays.

| Propiedad            | Valor |
| -------------------- | ----- |
| Requerido            | false |
| Valor predeterminado |       |
| Tipo                 | Int32 |

#### Windows

Incluye dispositivos Windows en los resultados.

| Propiedad            | Valor     |
| -------------------- | --------- |
| Requerido            | false     |
| Valor predeterminado | Verdadero |
| Tipo                 | Booleano  |

#### MacOS

Incluye dispositivos macOS en los resultados.

| Propiedad            | Valor     |
| -------------------- | --------- |
| Requerido            | false     |
| Valor predeterminado | Verdadero |
| Tipo                 | Booleano  |

#### iOS

Incluye dispositivos iOS en los resultados.

| Propiedad            | Valor     |
| -------------------- | --------- |
| Requerido            | false     |
| Valor predeterminado | Verdadero |
| Tipo                 | Booleano  |

#### Android

Incluye dispositivos Android en los resultados.

| Propiedad            | Valor     |
| -------------------- | --------- |
| Requerido            | false     |
| Valor predeterminado | Verdadero |
| Tipo                 | Booleano  |

#### EmailFrom

La dirección de correo electrónico del remitente. Esto debe configurarse en la personalización del runbook.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | false  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### ServiceDeskDisplayName

Nombre para mostrar de Service Desk para la información de contacto del usuario (opcional).

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | false  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### ServiceDeskEmail

Dirección de correo electrónico de Service Desk para la información de contacto del usuario (opcional).

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | false  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### ServiceDeskPhone

Número de teléfono de Service Desk para la información de contacto del usuario (opcional).

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | false  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### ServiceDeskPortalUrl

URL del portal de Service Desk para la información de contacto del usuario, mostrada como un enlace en el que se puede hacer clic (opcional).

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | false  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### ServiceDeskTicketUrl

Enlace directo a un ticket del Service Desk, presentado como enlace en el que se puede hacer clic (opcional). Vacío de forma predeterminada, por lo que no se añade ningún enlace al ticket.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | false  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### UseUserScope

Habilita el filtrado por ámbito de usuarios para incluir o excluir usuarios según su pertenencia a grupos.

| Propiedad            | Valor    |
| -------------------- | -------- |
| Requerido            | false    |
| Valor predeterminado | Falso    |
| Tipo                 | Booleano |

#### IncludeUserGroup

Envía correos solo a los usuarios que sean miembros de este grupo. Requiere que UseUserScope esté habilitado.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | false  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### ExcludeUserGroup

No envíes correos a usuarios que sean miembros de este grupo. Requiere que UseUserScope esté habilitado.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | false  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### OverrideEmailRecipient

Opcional: dirección o direcciones de correo electrónico a las que enviar todas las notificaciones en lugar de a los usuarios finales. Puede separarse por comas para varios destinatarios. Perfecto para pruebas, pilotos o envío a sistemas de tickets. Si se deja vacío, los correos se enviarán a los usuarios finales reales.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | false  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### MailTemplateLanguage

Selecciona qué plantilla de correo usar: EN (inglés, predeterminada), DE (alemán) o Personalizado (de Runbook Customizations).

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | false  |
| Valor predeterminado | EN     |
| Tipo                 | Cadena |

#### CustomMailTemplateSubject

Línea de asunto personalizada del correo (solo se usa cuando MailTemplateLanguage está configurado en 'Custom').

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | false  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### CustomMailTemplateBeforeDeviceDetails

Texto personalizado que se mostrará antes de la lista de dispositivos (solo se usa cuando MailTemplateLanguage está configurado en 'Custom'). Admite formato Markdown.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | false  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

#### CustomMailTemplateAfterDeviceDetails

Texto personalizado que se mostrará después de la lista de dispositivos (solo se usa cuando MailTemplateLanguage está configurado en 'Custom'). Admite formato Markdown.

| Propiedad            | Valor  |
| -------------------- | ------ |
| Requerido            | false  |
| Valor predeterminado |        |
| Tipo                 | Cadena |

[Volver a la vista general de la referencia de Runbook](/es/automatizacion/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/es/automatizacion/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.
