> 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 desatualizados agendada
{% hint style="info" %}
Este é um runbook agendado. Ele foi projetado para ser executado em um agendamento recorrente, em vez de ser acionado para um único objeto. Veja [Agendamento](/pt/automacao/runbooks/scheduling.md) para detalhes sobre como configurar os agendamentos do runbook.
{% endhint %}
### 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 sobre o dispositivo e passos de ação para o utilizador. Opcionalmente, filtre utilizadores incluindo ou excluindo grupos específicos. Estão disponíveis três destinos de encaminhamento opcionais: um destinatário de substituição global que redireciona TODAS as notificações (para testes e pilotos), um destinatário dedicado para utilizadores cujo UPN corresponda a um padrão de nome (por exemplo, contas do Device Enrollment Manager) e um destinatário dedicado que recebe um e-mail combinado para dispositivos desatualizados sem utilizador principal.
### Configuração relativa ao envio de e-mail
O envio de um relatório por e-mail é opcional e só acontece quando um destinatário (`EmailTo`) é fornecido. O endereço do remetente é obtido da configuração de tenant `RJReport.EmailSender` .
Este runbook envia e-mails usando a API do Microsoft Graph. Para enviar e-mails via API do Graph, é necessário configurar um endereço de e-mail existente na personalização do runbook.
Consulte a [documentação das Configurações de Relatório RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para detalhes.
#### Branding do e-mail
O e-mail do relatório respeita as configurações opcionais `RJReport.Branding.*` do tenant: uma imagem de cabeçalho personalizada, uma imagem de rodapé personalizada (URLs HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada), um link de rodapé personalizado e cores personalizadas de destaque e de texto (valores hexadecimais de 6 dígitos, por ex. `#0052cc`). Quando essas configurações não estão definidas, são usadas as imagens e cores padrão do RealmJoin. Uma imagem de branding que não possa ser transferida por download ou validada, ou um valor de cor que não seja uma cor hex válida, nunca impede o e-mail do relatório - em vez disso, é usado o padrão correspondente.
Consulte a [documentação das Configurações de Relatório RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para detalhes de configuração.
### 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 - predefinição)**: Usa o modelo em inglês incorporado
2. **DE (Alemão)**: Usa o modelo em alemão incorporado
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 algum parâmetro do modelo personalizado estiver em falta, o runbook recorrerá automaticamente 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 aparece acima dos detalhes do dispositivo.** \n\nCaro utilizador ..."
},
"CustomMailTemplateAfterDeviceDetails": {
"Default": "**Isto aparece abaixo dos detalhes do dispositivo.** \n\n## O que deve fazer..."
}
}
}
}
}
```
**Notas importantes:**
* Use `\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 recorre automaticamente ao modelo em inglês (EN)
* Ao usar o modelo personalizado, selecione "Custom - Use Template from Runbook Customizations" no menu pendente Mail Template
### Encaminhamento de e-mail
O runbook conhece três destinos de encaminhamento independentes, verificados por esta ordem de precedência:
1. **Substituição global (testes):** Um `OverrideEmailRecipient` redireciona **TODOS OS** e-mails - notificações de utilizador, notificações encaminhadas por padrão e o e-mail combinado para dispositivos sem utilizador principal - para esse endereço. Nenhum utilizador final recebe um e-mail. Use isto para testes, pilotos ou para encaminhar tudo para uma caixa de correio partilhada ou sistema de tickets. É registado um aviso em cada execução enquanto a substituição estiver ativa.
2. **Utilizadores correspondentes ao padrão:** Quando `OverrideUserNamePattern` está definido, as notificações dos utilizadores cujo UPN corresponda ao padrão são enviadas para `UserNamePatternEmailRecipient` em vez do utilizador. Todos os outros utilizadores recebem a notificação diretamente. Uso típico: contas do Device Enrollment Manager ou kiosk (`DEM-*`, `KIOSK-*`) cujas caixas de correio ninguém lê.
3. **Dispositivos sem utilizador principal:** Quando `SendNoPrimaryUserDevicesToOverride` está ativado, os dispositivos desatualizados sem utilizador principal são reunidos num **único** e-mail combinado para `NoPrimaryUserEmailRecipient`. Caso contrário, estes dispositivos são ignorados. Esta configuração nunca altera a forma como as notificações dos utilizadores são encaminhadas.
As configurações incompletas interrompem o runbook com um erro em vez de enviarem silenciosamente e-mails aos utilizadores finais:
* `SendNoPrimaryUserDevicesToOverride` ativado sem `NoPrimaryUserEmailRecipient` (e sem uma substituição global) - erro.
* `OverrideUserNamePattern` definido sem `UserNamePatternEmailRecipient` (e sem uma substituição global) - erro.
* Um destinatário definido sem a respetiva funcionalidade (`NoPrimaryUserEmailRecipient` sem o alternador, `UserNamePatternEmailRecipient` sem um padrão) - aviso, o destinatário é ignorado.
Enquanto a substituição global estiver ativa, os destinatários dedicados não precisam de ser definidos - de qualquer forma, tudo é enviado para o destinatário da substituição.
#### Padrão do nome de utilizador
`OverrideUserNamePattern` aceita um ou mais padrões wildcard (separados por vírgulas) comparados com o UPN do utilizador principal, por exemplo `DEM-*` para contas do Device Enrollment Manager ou `DEM-*,KIOSK-*` para vários padrões. A correspondência não é sensível a maiúsculas/minúsculas e usa a sintaxe wildcard do PowerShell (`*`, `?`). Quando o encaminhamento por padrão está ativo, o runbook regista um aviso indicando qual padrão é redirecionado para qual destinatário.
**Notas importantes:**
* Todos os parâmetros de destinatário aceitam vários endereços separados por vírgulas
* Os dispositivos sem utilizador principal ignoram a filtragem do âmbito de utilizadores (não têm um utilizador com quem corresponder aos grupos)
* Os utilizadores correspondentes ao padrão continuam sujeitos primeiro à filtragem do âmbito de utilizadores; utilizadores excluídos pelo âmbito não produzem qualquer notificação
* O e-mail combinado para dispositivos sem utilizador principal usa uma redação administrativa (sem passos de ação para o utilizador final), independentemente dos modelos personalizados
* As notificações redirecionadas indicam o utilizador afetado no assunto e no corpo do e-mail
### Localização
Organização → Dispositivos → Notificar Utilizadores Sobre Dispositivos Desatualizados (Agendado)
**Nome completo do runbook**
rjgit-org\_devices\_notify-users-about-stale-devices\_scheduled
### Detalhes
| Propriedade | Valor |
| ------------------- | --------------------------------------------------------------------------------------- |
| Versão | 1.7.0 |
| Módulos necessários | RealmJoin.RunbookHelper (>= 0.8.9)
Microsoft.Graph.Authentication (>= 2.39.0)
|
| Agendável | sim |
### Notas
Este runbook envia automaticamente notificações personalizadas por e-mail aos utilizadores que têm dispositivos que não sincronizaram durante um número especificado de dias. O e-mail é enviado diretamente para o endereço de e-mail do utilizador principal e inclui informações detalhadas sobre cada dispositivo inativo.
Pré-requisitos:
* O parâmetro EmailFrom deve ser configurado na personalização do runbook (definição RJReport.EmailSender)
* Opcional: as informações de contacto do Service Desk podem ser configuradas (ServiceDesk\_DisplayName, ServiceDesk\_EMail, ServiceDesk\_Phone, ServiceDesk\_PortalUrl)
Casos de uso comuns:
* Lembretes automáticos aos utilizadores sobre dispositivos inativos para incentivar verificações regulares dos dispositivos
* Gestão proativa do ciclo de vida dos dispositivos, alertando os utilizadores antes de os dispositivos serem reformados
* Segurança e conformidade, garantindo que os utilizadores estão cientes de todos os dispositivos registados em seu nome
* Utilizar o parâmetro MaxDays para notificações faseadas (por exemplo, primeiro lembrete aos 30 dias, aviso final aos 60 dias)
* Filtragem do âmbito de utilizadores para direcionar departamentos específicos ou excluir contas de serviço
* Tratar centralmente dispositivos sem utilizador principal ou pertencentes a contas do Device Enrollment Manager (por exemplo, DEM-\*) através de destinatários dedicados
Opções de piloto e teste:
* Use o parâmetro OverrideEmailRecipient para enviar todas as notificações para uma caixa de correio de teste em vez de utilizadores finais
* Perfeito para validar o conteúdo do e-mail e testar filtros antes de implementar em produção
* Enviar notificações para sistemas de tickets ou caixas de correio partilhadas para tratamento centralizado
### Permissões
#### Permissões de aplicação
* **Tipo**: Microsoft Graph
* DeviceManagementManagedDevices.Read.All
* *Lê dispositivos geridos pelo Intune filtrados por lastSyncDateTime para encontrar dispositivos desatualizados e os respetivos utilizadores principais*
* Directory.Read.All
* *Lê o nome do tenant para o rodapé do e-mail e resolve IDs de utilizador para a filtragem do âmbito de grupos*
* Group.Read.All
* *Lista os membros dos grupos de inclusão/exclusão para filtrar quais os utilizadores principais que recebem notificações*
* Mail.Send
* *Envia os e-mails de notificação de dispositivos desatualizados para cada utilizador principal ou para o destinatário da substituição*
### Parâmetros
#### Dias
Número de dias sem atividade para ser considerado desatualizado (limiar mínimo).
| Propriedade | Valor |
| -------------------------- | -------------------------- |
| Obrigatório | falso |
| Valor padrão | 30 |
| Tipo | Int32 |
| Nome de exibição no portal | Dias mínimos sem atividade |
#### MaxDays
Número máximo opcional de dias sem atividade. Se definido, apenas os dispositivos inativos entre Days e MaxDays serão incluídos.
| Propriedade | Valor |
| -------------------------- | --------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | Int32 |
| Nome de exibição no portal | (Opcional) Máximo de dias sem atividade |
#### Windows
Incluir dispositivos Windows nos resultados.
| Propriedade | Valor |
| -------------------------- | ---------------------------- |
| Obrigatório | falso |
| Valor padrão | Verdadeiro |
| Tipo | Booleano |
| Nome de exibição no portal | Incluir Dispositivos Windows |
#### MacOS
Incluir dispositivos macOS nos resultados.
| Propriedade | Valor |
| -------------------------- | -------------------------- |
| Obrigatório | falso |
| Valor padrão | Verdadeiro |
| Tipo | Booleano |
| Nome de exibição no portal | Incluir Dispositivos macOS |
#### iOS
Incluir dispositivos iOS nos resultados.
| Propriedade | Valor |
| -------------------------- | ------------------------ |
| Obrigatório | falso |
| Valor padrão | Verdadeiro |
| Tipo | Booleano |
| Nome de exibição no portal | Incluir Dispositivos iOS |
#### Android
Incluir dispositivos Android nos resultados.
| Propriedade | Valor |
| -------------------------- | ---------------------------- |
| Obrigatório | falso |
| Valor padrão | Verdadeiro |
| Tipo | Booleano |
| Nome de exibição no portal | Incluir Dispositivos Android |
#### EmailFrom
O endereço de e-mail do remetente. Isto precisa ser configurado na personalização do runbook.
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido via personalização do runbook) |
#### BrandingHeaderImageUrl
URL HTTPS pública opcional de uma imagem de cabeçalho personalizada (PNG/JPEG/GIF, máx. 200 KB) para o e-mail do relatório. Obtida da configuração do tenant RJReport.Branding.HeaderImageUrl. Quando vazia, é usada a imagem padrão de cabeçalho do RealmJoin.
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido via personalização do runbook) |
#### BrandingFooterImageUrl
URL HTTPS pública opcional de uma imagem de rodapé personalizada (PNG/JPEG/GIF, máx. 200 KB) para o e-mail do relatório. Obtida da configuração do tenant RJReport.Branding.FooterImageUrl. Quando vazia, é usada a imagem padrão de rodapé do RealmJoin.
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido via personalização do runbook) |
#### BrandingFooterLink
URL opcional para onde a imagem de rodapé aponta. Obtida da configuração do tenant RJReport.Branding.FooterLink. Quando vazia, é usado o link padrão ().
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido via personalização do runbook) |
#### BrandingAccentColor
Substituição opcional da cor de destaque (hexadecimal de 6 dígitos, por ex. '#0052cc') para o modelo de e-mail do relatório. Obtida da configuração do tenant RJReport.Branding.AccentColor. Quando vazia ou inválida, é usada a cor de destaque padrão do RealmJoin.
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido via personalização do runbook) |
#### BrandingTextColor
Substituição opcional da cor do texto (hexadecimal de 6 dígitos) para o modelo de e-mail do relatório. Obtida da configuração do tenant RJReport.Branding.TextColor. Quando vazia ou inválida, é usada a cor de texto padrão do RealmJoin.
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido via personalização do runbook) |
#### ServiceDeskDisplayName
Nome de apresentação do Service Desk para informações de contacto do utilizador (opcional).
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido via personalização do runbook) |
#### ServiceDeskEmail
Endereço de e-mail do Service Desk para informações de contacto do utilizador (opcional).
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido via personalização do runbook) |
#### ServiceDeskPhone
Número de telefone do Service Desk para informações de contacto do utilizador (opcional).
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido via personalização do runbook) |
#### 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 padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido via personalização do runbook) |
#### ServiceDeskTicketUrl
Ligação direta para um ticket do Service Desk, apresentada como uma ligação clicável (opcional). Vazia por predefinição, por isso não é adicionado nenhum link para o ticket.
| Propriedade | Valor |
| ---------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Oculto no portal | sim (predefinido via personalização do runbook) |
#### UseUserScope
Ative a filtragem do âmbito de utilizadores para incluir ou excluir utilizadores com base na associação a grupos.
| Propriedade | Valor |
| -------------------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | Falso |
| Tipo | Booleano |
| Nome de exibição no portal | Usar filtragem do âmbito de utilizador |
| Oculto no portal | sim (predefinido via personalização do runbook) |
#### IncludeUserGroup
Envie e-mails apenas para utilizadores que sejam membros deste grupo. Requer que UseUserScope esteja ativado.
| Propriedade | Valor |
| -------------------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Nome de exibição no portal | Utilizadores a incluir (Grupo) |
| Oculto no portal | sim (predefinido via personalização do runbook) |
#### ExcludeUserGroup
Não envie e-mails a utilizadores que sejam membros deste grupo. Requer que UseUserScope esteja ativado.
| Propriedade | Valor |
| -------------------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Nome de exibição no portal | Utilizadores a excluir (Grupo) |
| Oculto no portal | sim (predefinido via personalização do runbook) |
#### OverrideEmailRecipient
Opcional: substituição global - quando definida, TODAS as notificações (notificações de utilizador, notificações encaminhadas por padrão e o e-mail combinado para dispositivos sem utilizador principal) são enviadas para este endereço em vez dos respetivos destinatários normais. Pode ser separada por vírgulas para vários destinatários. Perfeito para testes e pilotos, ou para encaminhar tudo para um sistema de tickets. Se for deixada em branco, aplica-se o encaminhamento normal.
| Propriedade | Valor |
| -------------------------- | ----------------------------------------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Nome de exibição no portal | Redirecionar \* TODOS \* os e-mails para o(s) destinatário(s) da substituição |
#### OverrideUserNamePattern
Padrão(s) opcional(is) wildcard correspondidos com o UPN do utilizador principal (separados por vírgulas, por exemplo 'DEM-*,KIOSK-*', sem distinção entre maiúsculas e minúsculas). As notificações dos utilizadores correspondentes são redirecionadas para UserNamePatternEmailRecipient; todos os outros utilizadores recebem e-mails diretamente. Não é avaliado separadamente enquanto a substituição global (OverrideEmailRecipient) estiver ativa, uma vez que, de qualquer forma, todas as notificações são redirecionadas.
| Propriedade | Valor |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Nome de exibição no portal | (Opcional) Padrão do nome do utilizador principal - redirecionar utilizadores correspondentes (por exemplo, 'DEM-\*') |
#### UserNamePatternEmailRecipient
Endereço(s) de e-mail que recebem as notificações dos utilizadores correspondentes a OverrideUserNamePattern. Podem ser separados por vírgulas. Necessário quando OverrideUserNamePattern está definido, a menos que OverrideEmailRecipient esteja definido.
| Propriedade | Valor |
| -------------------------- | ----------------------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Nome de exibição no portal | Destinatário(s) para utilizadores correspondentes ao padrão |
#### SendNoPrimaryUserDevicesToOverride
Se ativado, os dispositivos desatualizados sem utilizador principal são reunidos num único e-mail para NoPrimaryUserEmailRecipient (ou para OverrideEmailRecipient enquanto a substituição global estiver ativa). Não altera a forma como as notificações dos utilizadores são encaminhadas. Os dispositivos sem utilizador principal ignoram a filtragem do âmbito de utilizadores.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------------------------------ |
| Obrigatório | falso |
| Valor padrão | Falso |
| Tipo | Booleano |
| Nome de exibição no portal | Enviar dispositivos sem utilizador principal como e-mail combinado |
| Oculto no portal | sim (predefinido via personalização do runbook) |
#### NoPrimaryUserEmailRecipient
Endereço(s) de e-mail que recebem o e-mail combinado para dispositivos desatualizados sem utilizador principal. Podem ser separados por vírgulas. Necessário quando SendNoPrimaryUserDevicesToOverride está ativado, a menos que OverrideEmailRecipient esteja definido.
| Propriedade | Valor |
| -------------------------- | ---------------------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Nome de exibição no portal | Destinatário(s) para dispositivos sem utilizador principal |
| Oculto no portal | sim (predefinido via personalização do runbook) |
#### MailTemplateLanguage
Selecione qual modelo de e-mail utilizar: EN (Inglês, predefinição), DE (Alemão) ou Custom (das Personalizações do Runbook).
| Propriedade | Valor |
| -------------------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | EN |
| Tipo | String |
| Nome de exibição no portal | Modelo de e-mail |
| Oculto no portal | sim (predefinido via personalização do runbook) |
#### CustomMailTemplateSubject
Linha de assunto de e-mail personalizada (apenas usada quando MailTemplateLanguage está definido como 'Custom').
| Propriedade | Valor |
| -------------------------- | ----------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Nome de exibição no portal | Personalizado: assunto do e-mail |
| Oculto no portal | sim (predefinido via personalização do runbook) |
#### CustomMailTemplateBeforeDeviceDetails
Texto personalizado a apresentar antes da lista de dispositivos (apenas usado quando MailTemplateLanguage está definido como 'Custom'). Suporta formatação Markdown.
| Propriedade | Valor |
| -------------------------- | --------------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Nome de exibição no portal | Personalizado: texto antes da lista de dispositivos |
| Oculto no portal | sim (predefinido via personalização do runbook) |
#### CustomMailTemplateAfterDeviceDetails
Texto personalizado a apresentar após a lista de dispositivos (apenas usado quando MailTemplateLanguage está definido como 'Custom'). Suporta formatação Markdown.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------------- |
| Obrigatório | falso |
| Valor padrão | |
| Tipo | String |
| Nome de exibição no portal | Personalizado: texto após a lista de dispositivos |
| Oculto no portal | sim (predefinido via personalização do runbook) |
[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=&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.