> 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
{% hint style="info" %}
Este es un runbook programado. Está diseñado para ejecutarse según una programación recurrente en lugar de activarse para un único objeto. Consulte [Programación](/es/automatizacion/runbooks/scheduling.md) para obtener detalles sobre cómo configurar las programaciones del runbook.
{% endhint %}
### Descripción
Identifica dispositivos que no han estado activos durante un número especificado de días y envía notificaciones personalizadas por correo electrónico a los usuarios primarios 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. Hay tres destinos de enrutamiento opcionales disponibles: un destinatario de anulación global que redirige TODAS las notificaciones (para pruebas y pilotos), un destinatario dedicado para usuarios cuyo UPN coincide con un patrón de nombre (p. ej., cuentas de Device Enrollment Manager), y un destinatario dedicado que recibe un único correo electrónico combinado para dispositivos inactivos sin usuario primario.
### Configuración relacionada con el envío de correos electrónicos
El envío de un informe por correo electrónico es opcional y solo se realiza cuando se proporciona un destinatario (`EmailTo`). La dirección del remitente se toma de la `RJReport.EmailSender` configuración de Tenant.
Este runbook envía correos electrónicos usando la API de Microsoft Graph. Para enviar correos electrónicos mediante Graph API, debes configurar una dirección de correo electrónico existente en la personalización del runbook.
Consulta la [documentación de RealmJoin Report Settings](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para obtener más detalles.
#### Branding del correo electrónico
El correo electrónico del informe tiene en cuenta la configuración opcional `RJReport.Branding.*` de Tenant: una imagen de encabezado personalizada, una imagen de pie de página personalizada (URL HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada una), un enlace personalizado en el pie de página y colores personalizados de acento y de texto (valores hexadecimales de 6 dígitos, p. ej. `#0052cc`). Cuando estas configuraciones no están definidas, se usan los gráficos y colores predeterminados de RealmJoin. Una imagen de branding que no se pueda descargar o validar, o un valor de color que no sea un color hexadecimal válido, nunca impide el envío del correo del informe; en su lugar, se usa el valor predeterminado correspondiente.
Consulta la [documentación de RealmJoin Report Settings](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para ver los detalles de configuració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. **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 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é deberías hacer..."
}
}
}
}
}
```
**Notas importantes:**
* Use `\n` para los saltos de línea en la configuración JSON
* El formato Markdown (##, ###, \*\*, -) es compatible con el texto de la plantilla
* Se deben configurar los tres parámetros de plantilla personalizados (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 "Custom - Use Template from Runbook Customizations" en el desplegable de Plantilla de correo
### Enrutamiento de correo electrónico
El runbook conoce tres destinos de enrutamiento independientes, comprobados en este orden de precedencia:
1. **Anulación global (pruebas):** Un valor configurado de `OverrideEmailRecipient` redirige **TODOS** los correos electrónicos: notificaciones de usuario, notificaciones redirigidas por patrón y el correo electrónico combinado para dispositivos sin usuario primario, a esa dirección. Ningún usuario final recibe un correo electrónico. Úsalo para pruebas, pilotos o para redirigir todo a un buzón compartido o sistema de tickets. Se registra una advertencia en cada ejecución mientras la anulación esté activa.
2. **Usuarios que coinciden con el patrón:** Cuando `OverrideUserNamePattern` está establecido, las notificaciones de los usuarios cuyo UPN coincide con el patrón se envían a `UserNamePatternEmailRecipient` en lugar del usuario. Todos los demás usuarios reciben su notificación directamente. Uso típico: cuentas de Device Enrollment Manager o de quiosco (`DEM-*`, `KIOSK-*`) cuyos buzones nadie revisa.
3. **Dispositivos sin usuario primario:** Cuando `SendNoPrimaryUserDevicesToOverride` está habilitado, los dispositivos inactivos sin usuario primario se agrupan en **un** correo electrónico combinado a `NoPrimaryUserEmailRecipient`. De lo contrario, estos dispositivos se omiten. Este ajuste nunca cambia cómo se enrutan las notificaciones de usuario.
Las configuraciones incompletas detienen el runbook con un error en lugar de enviar correos silenciosamente a los usuarios finales:
* `SendNoPrimaryUserDevicesToOverride` habilitado sin `NoPrimaryUserEmailRecipient` (y sin una anulación global) - error.
* `OverrideUserNamePattern` configurado sin `UserNamePatternEmailRecipient` (y sin una anulación global) - error.
* Un destinatario configurado sin su función (`NoPrimaryUserEmailRecipient` sin el interruptor, `UserNamePatternEmailRecipient` sin un patrón) - advertencia, el destinatario se ignora.
Mientras la anulación global está activa, no es necesario establecer los destinatarios dedicados: todo va al destinatario de anulación de todos modos.
#### Patrón de nombre de usuario
`OverrideUserNamePattern` acepta uno o más patrones comodín (separados por comas) comparados con el UPN del usuario primario, p. ej. `DEM-*` para cuentas de Device Enrollment Manager o `DEM-*,KIOSK-*` para varios patrones. La coincidencia no distingue mayúsculas/minúsculas y usa la sintaxis de comodines de PowerShell (`*`, `?`). Cuando el enrutamiento por patrón está activo, el runbook registra una advertencia indicando qué patrón se redirige a qué destinatario.
**Notas importantes:**
* Todos los parámetros de destinatario aceptan varias direcciones separadas por comas
* Los dispositivos sin usuario primario omiten el filtrado del ámbito de usuarios (no tienen un usuario con el que coincidir con grupos)
* Los usuarios que coinciden con el patrón siguen estando sujetos primero al filtrado del ámbito de usuarios; los usuarios excluidos por el ámbito no generan ninguna notificación
* El correo electrónico combinado para dispositivos sin usuario primario usa un lenguaje administrativo (sin pasos de acción para el usuario final), independiente de las plantillas personalizadas
* Las notificaciones redirigidas indican al usuario afectado en el asunto y en el cuerpo del correo electrónico
### 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
### Detalles
| Propiedad | Valor |
| ------------------ | --------------------------------------------------------------------------------------- |
| Versión | 1.7.0 |
| Módulos requeridos | RealmJoin.RunbookHelper (>= 0.8.9)
Microsoft.Graph.Authentication (>= 2.39.0)
|
| Programable | sí |
### Notas
Este runbook envía automáticamente notificaciones personalizadas por correo electrónico a los usuarios que tienen dispositivos que no se han sincronizado durante un número específico de días. El correo electrónico se envía directamente a la dirección de correo del usuario primario e incluye información detallada sobre cada dispositivo inactivo.
Requisitos previos:
* El parámetro EmailFrom debe configurarse en la personalización del runbook (configuración RJReport.EmailSender)
* Opcional: se puede configurar la información de contacto del Service Desk (ServiceDesk\_DisplayName, ServiceDesk\_EMail, ServiceDesk\_Phone, ServiceDesk\_PortalUrl)
Casos de uso comunes:
* Recordatorios automáticos a los usuarios sobre dispositivos inactivos para fomentar comprobaciones regulares del dispositivo
* Gestión proactiva del ciclo de vida del dispositivo mediante alertas a los usuarios antes de que los dispositivos se retiren
* Seguridad y cumplimiento garantizando que los usuarios conozcan todos los dispositivos registrados a su nombre
* Uso del parámetro MaxDays para notificaciones escalonadas (p. ej., primer recordatorio a los 30 días, aviso final a los 60 días)
* Filtrado del ámbito de usuarios para dirigirse a departamentos específicos o excluir cuentas de servicio
* Gestión centralizada de dispositivos sin usuario primario o pertenecientes a cuentas de Device Enrollment Manager (p. ej. DEM-\*) mediante destinatarios dedicados
Opciones de piloto y pruebas:
* Usa el parámetro OverrideEmailRecipient para enviar todas las notificaciones a un buzón de prueba en lugar de a los usuarios finales
* Perfecto para validar el contenido del correo electrónico y probar filtros antes de desplegar en producción
* Enviar notificaciones a sistemas de tickets o buzones compartidos para una gestión centralizada
### Permisos
#### Permisos de aplicación
* **Tipo**: Microsoft Graph
* DeviceManagementManagedDevices.Read.All
* *Lee los dispositivos administrados por Intune filtrados por lastSyncDateTime para encontrar dispositivos inactivos y sus usuarios primarios*
* Directory.Read.All
* *Lee el nombre del tenant para el pie del correo y resuelve los IDs de usuario para el filtrado del ámbito de grupo*
* Group.Read.All
* *Enumera los miembros de los grupos de inclusión/exclusión para filtrar qué usuarios primarios reciben notificación*
* Mail.Send
* *Envía los correos de notificación de dispositivos inactivos a cada usuario primario o al destinatario de anulación*
### Parámetros
#### Días
Número de días sin actividad a considerar inactivo (umbral mínimo).
| Propiedad | Valor |
| -------------------------------- | -------------------------- |
| Requerido | falso |
| Valor predeterminado | 30 |
| Tipo | Int32 |
| Nombre para mostrar en el portal | Días mínimos sin actividad |
#### 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 | falso |
| Valor predeterminado | |
| Tipo | Int32 |
| Nombre para mostrar en el portal | (Opcional) Días máximos sin actividad |
#### Windows
Incluye dispositivos Windows en los resultados.
| Propiedad | Valor |
| -------------------------------- | ---------------------------- |
| Requerido | falso |
| Valor predeterminado | True |
| Tipo | Booleano |
| Nombre para mostrar en el portal | Incluir dispositivos Windows |
#### MacOS
Incluye dispositivos macOS en los resultados.
| Propiedad | Valor |
| -------------------------------- | -------------------------- |
| Requerido | falso |
| Valor predeterminado | True |
| Tipo | Booleano |
| Nombre para mostrar en el portal | Incluir dispositivos macOS |
#### iOS
Incluye dispositivos iOS en los resultados.
| Propiedad | Valor |
| -------------------------------- | ------------------------ |
| Requerido | falso |
| Valor predeterminado | True |
| Tipo | Booleano |
| Nombre para mostrar en el portal | Incluir dispositivos iOS |
#### Android
Incluye dispositivos Android en los resultados.
| Propiedad | Valor |
| -------------------------------- | ---------------------------- |
| Requerido | falso |
| Valor predeterminado | True |
| Tipo | Booleano |
| Nombre para mostrar en el portal | Incluir dispositivos Android |
#### EmailFrom
La dirección de correo electrónico del remitente. Esto debe configurarse en la personalización del runbook.
| Propiedad | Valor |
| -------------------- | -------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preestablecido mediante personalización del runbook) |
#### BrandingHeaderImageUrl
URL HTTPS pública opcional de una imagen de encabezado personalizada (PNG/JPEG/GIF, máx. 200 KB) para el correo del informe. Procede de la configuración de Tenant RJReport.Branding.HeaderImageUrl. Cuando está vacía, se usa la imagen de encabezado predeterminada de RealmJoin.
| Propiedad | Valor |
| -------------------- | -------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preestablecido mediante personalización del runbook) |
#### BrandingFooterImageUrl
URL HTTPS pública opcional de una imagen de pie de página personalizada (PNG/JPEG/GIF, máx. 200 KB) para el correo del informe. Procede de la configuración de Tenant RJReport.Branding.FooterImageUrl. Cuando está vacía, se usa la imagen de pie de página predeterminada de RealmJoin.
| Propiedad | Valor |
| -------------------- | -------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preestablecido mediante personalización del runbook) |
#### BrandingFooterLink
URL opcional a la que enlaza la imagen del pie de página. Procede de la configuración de Tenant RJReport.Branding.FooterLink. Cuando está vacía, se usa el enlace predeterminado ().
| Propiedad | Valor |
| -------------------- | -------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preestablecido mediante personalización del runbook) |
#### BrandingAccentColor
Reemplazo opcional del color de acento (hex de 6 dígitos, p. ej. '#0052cc') para la plantilla del correo del informe. Procede de la configuración de Tenant RJReport.Branding.AccentColor. Cuando está vacío o es inválido, se usa el color de acento predeterminado de RealmJoin.
| Propiedad | Valor |
| -------------------- | -------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preestablecido mediante personalización del runbook) |
#### BrandingTextColor
Reemplazo opcional del color de texto (hex de 6 dígitos) para la plantilla del correo del informe. Procede de la configuración de Tenant RJReport.Branding.TextColor. Cuando está vacío o es inválido, se usa el color de texto predeterminado de RealmJoin.
| Propiedad | Valor |
| -------------------- | -------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preestablecido mediante personalización del runbook) |
#### ServiceDeskDisplayName
Nombre para mostrar del Service Desk para la información de contacto del usuario (opcional).
| Propiedad | Valor |
| -------------------- | -------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preestablecido mediante personalización del runbook) |
#### ServiceDeskEmail
Dirección de correo electrónico del Service Desk para la información de contacto del usuario (opcional).
| Propiedad | Valor |
| -------------------- | -------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preestablecido mediante personalización del runbook) |
#### ServiceDeskPhone
Número de teléfono del Service Desk para la información de contacto del usuario (opcional).
| Propiedad | Valor |
| -------------------- | -------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preestablecido mediante personalización del runbook) |
#### 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 | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preestablecido mediante personalización del runbook) |
#### ServiceDeskTicketUrl
Enlace directo a un ticket de Service Desk, renderizado como un enlace en el que se puede hacer clic (opcional). Vacío por defecto, por lo que no se añade ningún enlace al ticket.
| Propiedad | Valor |
| -------------------- | -------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preestablecido mediante personalización del runbook) |
#### UseUserScope
Habilita el filtrado del ámbito de usuarios para incluir o excluir usuarios según su pertenencia a grupos.
| Propiedad | Valor |
| -------------------------------- | -------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | Falso |
| Tipo | Booleano |
| Nombre para mostrar en el portal | Usar filtrado de alcance de usuarios |
| Oculto en el portal | sí (preestablecido mediante personalización del runbook) |
#### IncludeUserGroup
Envía correos solo a usuarios que sean miembros de este grupo. Requiere que UseUserScope esté habilitado.
| Propiedad | Valor |
| -------------------------------- | -------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar en el portal | Usuarios a incluir (Grupo) |
| Oculto en el portal | sí (preestablecido mediante personalización del runbook) |
#### ExcludeUserGroup
No envíes correos a usuarios que sean miembros de este grupo. Requiere que UseUserScope esté habilitado.
| Propiedad | Valor |
| -------------------------------- | -------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar en el portal | Usuarios a excluir (Grupo) |
| Oculto en el portal | sí (preestablecido mediante personalización del runbook) |
#### OverrideEmailRecipient
Opcional: anulación global: cuando está establecido, TODAS las notificaciones (notificaciones de usuario, notificaciones redirigidas por patrón y el correo electrónico combinado para dispositivos sin usuario primario) se envían a esta dirección en lugar de a sus destinatarios normales. Puede ir separada por comas para varios destinatarios. Perfecto para pruebas y pilotos, o para dirigirlo todo a un sistema de tickets. Si se deja vacío, se aplica el enrutamiento normal.
| Propiedad | Valor |
| -------------------------------- | ----------------------------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar en el portal | Redirigir \* TODOS \* los correos electrónicos a destinatario(s) de anulación |
#### OverrideUserNamePattern
Patrón(es) comodín opcional(es) comparados con el UPN del usuario primario (separados por comas, p. ej. 'DEM-*,KIOSK-*', sin distinción de mayúsculas/minúsculas). Las notificaciones de los usuarios coincidentes se redirigen a UserNamePatternEmailRecipient; todos los demás usuarios reciben el correo directamente. No se evalúa por separado mientras la anulación global (OverrideEmailRecipient) esté activa, ya que todas las notificaciones se redirigen de todos modos.
| Propiedad | Valor |
| -------------------------------- | --------------------------------------------------------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar en el portal | (Opcional) Patrón de nombre del usuario primario - redirige a los usuarios coincidentes (p. ej. 'DEM-\*') |
#### UserNamePatternEmailRecipient
Dirección(es) de correo electrónico que reciben las notificaciones de los usuarios que coinciden con OverrideUserNamePattern. Pueden ir separadas por comas. Necesarias cuando OverrideUserNamePattern está establecido, a menos que OverrideEmailRecipient esté establecido.
| Propiedad | Valor |
| -------------------------------- | --------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar en el portal | Destinatario(s) para usuarios que coinciden con el patrón |
#### SendNoPrimaryUserDevicesToOverride
Si se habilita, los dispositivos inactivos sin usuario primario se agrupan en un único correo electrónico a NoPrimaryUserEmailRecipient (o a OverrideEmailRecipient mientras la anulación global esté activa). No cambia cómo se enrutan las notificaciones de usuario. Los dispositivos sin usuario primario omiten el filtrado del ámbito de usuarios.
| Propiedad | Valor |
| -------------------------------- | -------------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | Falso |
| Tipo | Booleano |
| Nombre para mostrar en el portal | Enviar dispositivos sin usuario primario como correo combinado |
| Oculto en el portal | sí (preestablecido mediante personalización del runbook) |
#### NoPrimaryUserEmailRecipient
Dirección(es) de correo electrónico que reciben el correo combinado para dispositivos inactivos sin usuario primario. Pueden ir separadas por comas. Necesarias cuando SendNoPrimaryUserDevicesToOverride está habilitado, a menos que OverrideEmailRecipient esté establecido.
| Propiedad | Valor |
| -------------------------------- | -------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar en el portal | Destinatario(s) para dispositivos sin usuario primario |
| Oculto en el portal | sí (preestablecido mediante personalización del runbook) |
#### MailTemplateLanguage
Seleccione qué plantilla de correo electrónico usar: EN (inglés, predeterminado), DE (alemán) o Custom (de Runbook Customizations).
| Propiedad | Valor |
| -------------------------------- | -------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | EN |
| Tipo | Cadena |
| Nombre para mostrar en el portal | Plantilla de correo |
| Oculto en el portal | sí (preestablecido mediante personalización del runbook) |
#### CustomMailTemplateSubject
Línea de asunto personalizada del correo electrónico (solo se usa cuando MailTemplateLanguage está establecido en 'Custom').
| Propiedad | Valor |
| -------------------------------- | -------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar en el portal | Asunto personalizado del correo electrónico |
| Oculto en el portal | sí (preestablecido mediante personalización del runbook) |
#### CustomMailTemplateBeforeDeviceDetails
Texto personalizado que se mostrará antes de la lista de dispositivos (solo se usa cuando MailTemplateLanguage está establecido en 'Custom'). Admite formato Markdown.
| Propiedad | Valor |
| -------------------------------- | -------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar en el portal | Texto personalizado antes de la lista de dispositivos |
| Oculto en el portal | sí (preestablecido mediante personalización del runbook) |
#### CustomMailTemplateAfterDeviceDetails
Texto personalizado que se mostrará después de la lista de dispositivos (solo se usa cuando MailTemplateLanguage está establecido en 'Custom'). Admite formato Markdown.
| Propiedad | Valor |
| -------------------------------- | -------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar en el portal | Texto personalizado después de la lista de dispositivos |
| Oculto en el portal | sí (preestablecido mediante personalización del runbook) |
[Volver a la vista general de la referencia del 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=&goal=
```
`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.