# Notificar a los usuarios sobre dispositivos obsoletos programado ### Descripción Identifica dispositivos que no han estado activos durante un número especificado 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 a seguir para el usuario. Opcionalmente, filtra usuarios incluyendo o excluyendo grupos específicos. ### Configuración relacionada con el envío de correos electrónicos Este runbook envía correos electrónicos mediante 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 [Configuración de informes por correo electrónico](https://github.com/realmjoin/realmjoin-runbooks/tree/master/docs/general/setup-email-reporting.md) documentación. ### Selección de 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 en inglés integrada 2. **DE (Alemán)**: Usa la plantilla en alemán integrada 3. **Personalizados**: 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 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é debes hacer..." } } } } } ``` **Notas importantes:** * Usa `\n` para saltos de línea en la configuración JSON * El formato Markdown (##, ###, \*\*, -) es compatible en el texto de la plantilla * Los tres parámetros de plantilla personalizada (Subject, BeforeDeviceDetails, AfterDeviceDetails) deben configurarse * Si falta algún parámetro, el runbook recurrirá automáticamente a la plantilla en inglés (EN) * Al usar la plantilla personalizada, selecciona "Custom - Use Template from Runbook Customizations" en la lista desplegable Mail Template ### Ubicación Organization → Devices → Notify Users About Stale Devices (Scheduled) **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 considerarse obsoleto (umbral mínimo). | Propiedad | Valor | | -------------------- | ----- | | Obligatorio | 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 | | -------------------- | ----- | | Obligatorio | false | | Valor predeterminado | | | Tipo | Int32 | #### Windows Incluye dispositivos Windows en los resultados. | Propiedad | Valor | | -------------------- | ------- | | Obligatorio | false | | Valor predeterminado | True | | Tipo | Boolean | #### MacOS Incluye dispositivos macOS en los resultados. | Propiedad | Valor | | -------------------- | ------- | | Obligatorio | false | | Valor predeterminado | True | | Tipo | Boolean | #### iOS Incluye dispositivos iOS en los resultados. | Propiedad | Valor | | -------------------- | ------- | | Obligatorio | false | | Valor predeterminado | True | | Tipo | Boolean | #### Android Incluye dispositivos Android en los resultados. | Propiedad | Valor | | -------------------- | ------- | | Obligatorio | false | | Valor predeterminado | True | | Tipo | Boolean | #### EmailFrom La dirección de correo electrónico del remitente. Debe configurarse en la personalización del runbook. | Propiedad | Valor | | -------------------- | ------ | | Obligatorio | false | | Valor predeterminado | | | Tipo | Cadena | #### ServiceDeskDisplayName Nombre visible del Service Desk para la información de contacto del usuario (opcional). | Propiedad | Valor | | -------------------- | ------ | | Obligatorio | 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 | | -------------------- | ------ | | Obligatorio | 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 | | -------------------- | ------ | | Obligatorio | false | | Valor predeterminado | | | Tipo | Cadena | #### UseUserScope Habilita el filtrado por ámbito de usuario para incluir o excluir usuarios según la pertenencia a grupos. | Propiedad | Valor | | -------------------- | ------- | | Obligatorio | false | | Valor predeterminado | False | | Tipo | Boolean | #### IncludeUserGroup Enviar correos solo a los usuarios que sean miembros de este grupo. Requiere que UseUserScope esté habilitado. | Propiedad | Valor | | -------------------- | ------ | | Obligatorio | false | | Valor predeterminado | | | Tipo | Cadena | #### ExcludeUserGroup No enviar correos a los usuarios que sean miembros de este grupo. Requiere que UseUserScope esté habilitado. | Propiedad | Valor | | -------------------- | ------ | | Obligatorio | 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 por comas para varios destinatarios. Perfecto para pruebas, pilotos o para enviar a sistemas de tickets. Si se deja vacío, los correos se enviarán a los usuarios finales reales. | Propiedad | Valor | | -------------------- | ------ | | Obligatorio | 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 | | -------------------- | ------ | | Obligatorio | false | | Valor predeterminado | EN | | Tipo | Cadena | #### CustomMailTemplateSubject Línea de asunto de correo personalizada (solo se usa cuando MailTemplateLanguage está establecido en 'Custom'). | Propiedad | Valor | | -------------------- | ------ | | Obligatorio | false | | Valor predeterminado | | | Tipo | Cadena | #### CustomMailTemplateBeforeDeviceDetails Texto personalizado para mostrar antes de la lista de dispositivos (solo se usa cuando MailTemplateLanguage está establecido en 'Custom'). Compatible con formato Markdown. | Propiedad | Valor | | -------------------- | ------ | | Obligatorio | false | | Valor predeterminado | | | Tipo | Cadena | #### CustomMailTemplateAfterDeviceDetails Texto personalizado para mostrar después de la lista de dispositivos (solo se usa cuando MailTemplateLanguage está establecido en 'Custom'). Compatible con formato Markdown. | Propiedad | Valor | | -------------------- | ------ | | Obligatorio | false | | Valor predeterminado | | | Tipo | Cadena | [Volver a la vista general de referencia de Runbook](https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-references)