# Notificar a los usuarios sobre dispositivos obsoletos programado

### Descripción

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

### Configuración relativa al envío de correo electrónico

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

Este proceso se describe en detalle en la [Configurar informes por correo electrónico](https://github.com/realmjoin/realmjoin-runbooks/tree/master/docs/general/setup-email-reporting.md) documentación.

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

Este runbook admite tres opciones de plantilla de correo electrónico:

1. **EN (Inglés - Predeterminado)**: Usa la plantilla integrada en inglés
2. **DE (Alemán)**: Usa la plantilla integrada en alemán
3. **Custom**: 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 recurrirá 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é deberías hacer..."
                }
            }
        }
    }
}
```

**Notas importantes:**

* Usa `\n` para saltos de línea en la configuración JSON
* El formato Markdown (##, ###, \*\*, -) es compatible con el texto de la plantilla
* Los tres parámetros de la plantilla personalizada (Subject, BeforeDeviceDetails, AfterDeviceDetails) deben configurarse
* Si falta algún parámetro, el runbook recurre automáticamente a la plantilla en inglés (EN)
* Al usar la plantilla personalizada, selecciona "Custom - Use Template from Runbook Customizations" en el menú desplegable Mail Template

### Ubicación

Organización → Dispositivos → Notificar a los usuarios sobre dispositivos obsoletos (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

#### Días

Número de días sin actividad para considerarlo obsoleto (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 establece, solo se incluirán los dispositivos inactivos entre Days y MaxDays.

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

#### Windows

Incluir dispositivos Windows en los resultados.

| Propiedad            | Valor   |
| -------------------- | ------- |
| Requerido            | false   |
| Valor predeterminado | True    |
| Tipo                 | Boolean |

#### MacOS

Incluir dispositivos macOS en los resultados.

| Propiedad            | Valor   |
| -------------------- | ------- |
| Requerido            | false   |
| Valor predeterminado | True    |
| Tipo                 | Boolean |

#### iOS

Incluir dispositivos iOS en los resultados.

| Propiedad            | Valor   |
| -------------------- | ------- |
| Requerido            | false   |
| Valor predeterminado | True    |
| Tipo                 | Boolean |

#### Android

Incluir dispositivos Android en los resultados.

| Propiedad            | Valor   |
| -------------------- | ------- |
| Requerido            | false   |
| Valor predeterminado | True    |
| Tipo                 | Boolean |

#### 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 del 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 del 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 del Service Desk para la información de contacto del usuario (opcional).

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

#### UseUserScope

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

| Propiedad            | Valor   |
| -------------------- | ------- |
| Requerido            | false   |
| Valor predeterminado | False   |
| Tipo                 | Boolean |

#### IncludeUserGroup

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

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

#### ExcludeUserGroup

No enviar 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(es) de correo electrónico a las que enviar todas las notificaciones en lugar de a los usuarios finales. Puede separarse con 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, predeterminado), DE (alemán) o Custom (de Runbook Customizations).

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

#### CustomMailTemplateSubject

Asunto personalizado del correo electrónico (solo se usa cuando MailTemplateLanguage está configurado en 'Custom').

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

#### CustomMailTemplateBeforeDeviceDetails

Texto personalizado que se muestra 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 muestra 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 referencia del runbook](/es/automatizacion/runbooks/runbook-references.md)


---

# Agent Instructions: 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/es/automatizacion/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.