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

# Notifier les utilisateurs au sujet des appareils obsolètes planifié

Envoyer un e-mail aux utilisateurs au sujet des appareils qu'ils n'ont pas utilisés depuis un moment

{% hint style="info" %}
Il s'agit d'un runbook planifié. Il est conçu pour s'exécuter selon une planification récurrente plutôt que d'être déclenché pour un seul objet. Voir [Planification](/fr/automatisation/runbooks/scheduling.md) pour plus de détails sur la configuration des planifications de runbook.
{% endhint %}

### Description

Trouve des appareils Intune qui n’ont pas été actifs depuis un certain nombre de jours. Chaque utilisateur principal reçoit un e-mail सूचीant ses appareils obsolètes et ce qu’il faut faire à leur sujet. Les utilisateurs peuvent être inclus ou exclus par groupe. Les e-mails peuvent être redirigés : tous vers une adresse de remplacement pour les tests, ou ceux des comptes correspondant à un motif de nom vers un destinataire dédié. Les appareils obsolètes sans utilisateur principal peuvent être regroupés dans un seul e-mail combiné.

### Cas d’utilisation courants

* Rappels automatisés aux utilisateurs concernant les appareils inactifs pour encourager des vérifications régulières des appareils
* Gestion proactive du cycle de vie des appareils en avertissant les utilisateurs avant la mise hors service des appareils
* Sécurité et conformité en garantissant que les utilisateurs connaissent tous les appareils enregistrés à leur nom
* Notifications progressives via le `MaxDays` paramètre, par exemple un premier rappel à 30 jours et un avis final à 60 jours
* Filtrage du périmètre utilisateur pour cibler des départements spécifiques ou exclure des comptes de service
* Gestion centralisée des appareils sans utilisateur principal ou appartenant à des comptes Device Enrollment Manager (par exemple `DEM-*`) via des destinataires dédiés

### Configuration de l’envoi d’e-mails

L’envoi d’un rapport par e-mail est facultatif et n’a lieu que lorsqu’un destinataire (`EmailTo`) est renseignée. L’adresse de l’expéditeur est prise dans le `RJReport.EmailSender` paramètre Tenant.

Ce runbook envoie des e-mails à l’aide de l’API Microsoft Graph. Pour envoyer des e-mails via l’API Graph, vous devez configurer une adresse e-mail existante dans la personnalisation du runbook.

Voir la [documentation des paramètres de rapport RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) pour plus de détails sur tous les paramètres disponibles.

#### Branding des e-mails

L’e-mail du rapport prend en compte l’optionnel `RJReport.Branding.*` paramètres Tenant :

* **Image d’en-tête et de pied de page** – URL HTTPS publiques, PNG/JPEG/GIF, 200 Ko max. chacune
* **Lien de pied de page** – cible de l’image de pied de page
* **Couleur d’accent et de texte** – valeurs hexadécimales à 6 chiffres, par ex. `#0052cc`

Lorsque ces paramètres ne sont pas configurés, les graphismes et couleurs par défaut de RealmJoin sont utilisés. Une image qui ne peut pas être téléchargée ou validée, ou une valeur de couleur non valide, n’empêche jamais l’envoi de l’e-mail du rapport : le défaut correspondant est utilisé à la place.

Instructions de configuration et exigences relatives aux images : [Branding des e-mails](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

#### Informations de contact du Service Desk

Les paramètres facultatifs `RJReport.ServiceDesk_DisplayName`, `RJReport.ServiceDesk_EMail`, `RJReport.ServiceDesk_Phone` et `RJReport.ServiceDesk_PortalUrl` les paramètres du Tenant ajoutent un bloc de contact à la fin de chaque e-mail de notification. `ServiceDeskTicketUrl` peut en outre créer un lien vers un ticket.

### Sélection de la langue du modèle de mail

Ce runbook prend en charge trois options de modèle d'e-mail :

1. **EN (anglais - par défaut)**: utilise le modèle anglais intégré
2. **DE (allemand)**: utilise le modèle allemand intégré
3. **Personnalisé**: utilise un modèle personnalisé provenant des personnalisations du runbook

#### Utilisation de modèles de mail personnalisés

Pour utiliser un modèle de mail personnalisé (par exemple en néerlandais, espagnol ou toute autre langue), vous devez configurer le texte du modèle dans les personnalisations du runbook. Si un paramètre de modèle personnalisé est manquant, le runbook reviendra automatiquement au modèle anglais.

**Exemple : modèle personnalisé**

```json
{
    "Runbooks": {
        "rjgit-org_devices_notify-users-about-stale-devices_scheduled": {
            "Parameters": {
                "CustomMailTemplateSubject": {
                    "Default": "Il s'agit d'un objet personnalisé - Action requise : appareils inactifs"
                },
                "CustomMailTemplateBeforeDeviceDetails": {
                    "Default": "**Ceci est au-dessus des détails de l'appareil.** \n\nCher utilisateur ..."
                },
                "CustomMailTemplateAfterDeviceDetails": {
                    "Default": "**Ceci est sous les détails de l'appareil.** \n\n## Ce que vous devez faire..."
                }
            }
        }
    }
}
```

**Remarques importantes :**

* Utilisez `\n` pour les sauts de ligne dans la configuration JSON
* La mise en forme Markdown (##, ###, \*\*, -) est prise en charge dans le texte du modèle
* Les trois paramètres de modèle personnalisé (Subject, BeforeDeviceDetails, AfterDeviceDetails) doivent être configurés
* Si un paramètre est manquant, le runbook revient automatiquement au modèle anglais (EN)
* Lorsque vous utilisez le modèle personnalisé, sélectionnez "Custom - Use Template from Runbook Customizations" dans la liste déroulante Mail Template

### Routage des e-mails

Le runbook connaît trois cibles de routage indépendantes, vérifiées dans cet ordre de priorité :

1. **Remplacement global (test) :** Une valeur renseignée `OverrideEmailRecipient` redirige **TOUT** les e-mails - notifications aux utilisateurs, notifications routées par motif et l'e-mail combiné pour les appareils sans utilisateur principal - vers cette adresse. Aucun utilisateur final ne reçoit d'e-mail. Utilisez cela pour les tests, les pilotes ou pour tout rediriger vers une boîte aux lettres partagée ou un système de tickets. Un avertissement est consigné à chaque exécution tant que le remplacement est actif.
2. **Utilisateurs correspondant au motif :** Lorsque `OverrideUserNamePattern` est défini, les notifications des utilisateurs dont le UPN correspond au motif sont envoyées à `UserNamePatternEmailRecipient` au lieu de l'utilisateur. Tous les autres utilisateurs reçoivent leur notification directement. Utilisation typique : comptes Device Enrollment Manager ou comptes kiosque (`DEM-*`, `KIOSK-*`) dont personne ne lit les boîtes aux lettres.
3. **Appareils sans utilisateur principal :** Lorsque `SendNoPrimaryUserDevicesToOverride` est activé, les appareils obsolètes sans utilisateur principal sont regroupés dans **un** e-mail combiné vers `NoPrimaryUserEmailRecipient`. Sinon, ces appareils sont ignorés. Ce paramètre ne modifie jamais la manière dont les notifications aux utilisateurs sont acheminées.

Les configurations incomplètes arrêtent le runbook avec une erreur au lieu d'envoyer silencieusement des e-mails aux utilisateurs finaux :

* `SendNoPrimaryUserDevicesToOverride` activé sans `NoPrimaryUserEmailRecipient` (et sans remplacement global) - erreur.
* `OverrideUserNamePattern` défini sans `UserNamePatternEmailRecipient` (et sans remplacement global) - erreur.
* Un destinataire défini sans sa fonctionnalité (`NoPrimaryUserEmailRecipient` sans l'option, `UserNamePatternEmailRecipient` sans motif) - avertissement, le destinataire est ignoré.

Tant que le remplacement global est actif, il n'est pas nécessaire de définir les destinataires dédiés - tout est de toute façon envoyé au destinataire de remplacement.

#### Motif du nom d'utilisateur

`OverrideUserNamePattern` accepte un ou plusieurs motifs génériques (séparés par des virgules) comparés au UPN de l'utilisateur principal, par ex. `DEM-*` pour les comptes Device Enrollment Manager ou `DEM-*,KIOSK-*` pour plusieurs motifs. La correspondance n'est pas sensible à la casse et utilise la syntaxe de caractères génériques PowerShell (`*`, `?` ). Lorsque le routage par motif est actif, le runbook enregistre un avertissement indiquant quel motif est redirigé vers quel destinataire.

**Remarques importantes :**

* Tous les paramètres de destinataire acceptent plusieurs adresses séparées par des virgules
* Les appareils sans utilisateur principal contournent le filtrage du périmètre utilisateur (ils n'ont aucun utilisateur à comparer aux groupes)
* Les utilisateurs correspondant au motif restent d'abord soumis au filtrage du périmètre utilisateur ; les utilisateurs exclus par le périmètre ne génèrent aucune notification
* L'e-mail combiné pour les appareils sans utilisateur principal utilise une formulation administrative (aucune étape d'action pour l'utilisateur final), indépendamment des modèles personnalisés
* Les notifications redirigées indiquent l'utilisateur concerné dans l'objet et le corps de l'e-mail

### Emplacement

Organisation → Appareils → Notifier les utilisateurs au sujet des appareils obsolètes (planifié)

**Nom complet du runbook**

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

### Détails

| Propriété      | Valeur                                                                                   |
| -------------- | ---------------------------------------------------------------------------------------- |
| Version        | 1.7.0                                                                                    |
| Modules requis | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)</p> |
| Planifiable    | oui                                                                                      |

### Autorisations

#### Autorisations d’application

* **Type**: Microsoft Graph
  * DeviceManagementManagedDevices.Read.All
    * *Lit les appareils gérés par Intune filtrés par lastSyncDateTime pour trouver les appareils obsolètes et leurs utilisateurs principaux*
  * Directory.Read.All
    * *Lit le nom du Tenant pour le pied de page de l'e-mail et résout les identifiants d'utilisateur pour le filtrage du périmètre des groupes*
  * Group.Read.All
    * *Liste les membres des groupes d'inclusion/exclusion afin de filtrer quels utilisateurs principaux reçoivent une notification*
  * Mail.Send
    * *Envoie les e-mails de notification des appareils obsolètes à chaque utilisateur principal ou au destinataire de remplacement*

### Paramètres

#### Jours

Les appareils inactifs depuis au moins ce nombre de jours sont considérés comme obsolètes.

| Propriété                  | Valeur              |
| -------------------------- | ------------------- |
| Obligatoire                | faux                |
| Valeur par défaut          | 30                  |
| Type                       | Int32               |
| Nom d’affichage du portail | Jours sans activité |

#### MaxDays

Seuls les appareils inactifs depuis au plus ce nombre de jours sont inclus. Laissez vide pour ne pas définir de limite supérieure.

| Propriété                  | Valeur                                |
| -------------------------- | ------------------------------------- |
| Obligatoire                | faux                                  |
| Valeur par défaut          |                                       |
| Type                       | Int32                                 |
| Nom d’affichage du portail | Nombre maximal de jours sans activité |

#### Windows

Inclut les appareils Windows.

| Propriété                  | Valeur                          |
| -------------------------- | ------------------------------- |
| Obligatoire                | faux                            |
| Valeur par défaut          | Vrai                            |
| Type                       | Booléen                         |
| Nom d’affichage du portail | Inclure les appareils Windows ? |

#### macOS

Inclut les appareils macOS.

| Propriété                  | Valeur                        |
| -------------------------- | ----------------------------- |
| Obligatoire                | faux                          |
| Valeur par défaut          | Vrai                          |
| Type                       | Booléen                       |
| Nom d’affichage du portail | Inclure les appareils macOS ? |

#### iOS

Inclut les appareils iOS et iPadOS.

| Propriété                  | Valeur                      |
| -------------------------- | --------------------------- |
| Obligatoire                | faux                        |
| Valeur par défaut          | Vrai                        |
| Type                       | Booléen                     |
| Nom d’affichage du portail | Inclure les appareils iOS ? |

#### Android

Inclut les appareils Android.

| Propriété                  | Valeur                          |
| -------------------------- | ------------------------------- |
| Obligatoire                | faux                            |
| Valeur par défaut          | Vrai                            |
| Type                       | Booléen                         |
| Nom d’affichage du portail | Inclure les appareils Android ? |

#### EmailFrom

Adresse d'expéditeur de l'e-mail de notification. Provient du paramètre Tenant RJReport.EmailSender.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### BrandingHeaderImageUrl

Image d’en-tête de l’e-mail du rapport (URL HTTPS, PNG/JPEG/GIF, 200 Ko max.). Prise dans le paramètre Tenant RJReport.Branding.HeaderImageUrl ; l’en-tête RealmJoin par défaut est utilisé si vide.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### BrandingFooterImageUrl

Image de pied de page de l’e-mail du rapport (URL HTTPS, PNG/JPEG/GIF, 200 Ko max.). Prise dans le paramètre Tenant RJReport.Branding.FooterImageUrl ; le pied de page RealmJoin par défaut est utilisé si vide.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### BrandingFooterLink

Lien derrière l’image de pied de page de l’e-mail du rapport. Pris dans le paramètre Tenant RJReport.Branding.FooterLink ; realmjoin.com est utilisé si vide.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### BrandingAccentColor

Couleur d’accent de l’e-mail du rapport sous forme de valeur hexadécimale à 6 chiffres. Prise dans le paramètre Tenant RJReport.Branding.AccentColor ; la valeur par défaut RealmJoin est utilisée si vide ou non valide.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### BrandingTextColor

Couleur du texte de l’e-mail du rapport sous forme de valeur hexadécimale à 6 chiffres. Prise dans le paramètre Tenant RJReport.Branding.TextColor ; la valeur par défaut RealmJoin est utilisée si vide ou non valide.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### ServiceDeskDisplayName

Nom d'affichage du service desk affiché dans l'e-mail. Provient du paramètre Tenant RJReport.ServiceDesk\_DisplayName.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### ServiceDeskEmail

Adresse e-mail du service desk affichée dans l'e-mail. Provient du paramètre Tenant RJReport.ServiceDesk\_EMail.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### ServiceDeskPhone

Numéro de téléphone du service desk affiché dans l'e-mail. Provient du paramètre Tenant RJReport.ServiceDesk\_Phone.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### ServiceDeskPortalUrl

Lien vers le portail du service desk affiché dans l'e-mail. Provient du paramètre Tenant RJReport.ServiceDesk\_PortalUrl.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### ServiceDeskTicketUrl

Lien vers le ticket du service desk affiché dans l'e-mail. Laisser vide pour aucun lien.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### UseUserScope

Indique si les utilisateurs sont filtrés par appartenance à un groupe. Défini par le choix « Filtrer les utilisateurs par groupe ? ».

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      | Faux                                               |
| Type                   | Booléen                                            |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### IncludeUserGroup

Seuls les utilisateurs de ce groupe sont notifiés.

| Propriété                  | Valeur                                             |
| -------------------------- | -------------------------------------------------- |
| Obligatoire                | faux                                               |
| Valeur par défaut          |                                                    |
| Type                       | Chaîne                                             |
| Nom d’affichage du portail | Inclure les utilisateurs du groupe                 |
| Masqué dans le portail     | oui (prédéfini via la personnalisation du runbook) |

#### ExcludeUserGroup

Les utilisateurs de ce groupe ne sont pas notifiés.

| Propriété                  | Valeur                                             |
| -------------------------- | -------------------------------------------------- |
| Obligatoire                | faux                                               |
| Valeur par défaut          |                                                    |
| Type                       | Chaîne                                             |
| Nom d’affichage du portail | Exclure les utilisateurs du groupe                 |
| Masqué dans le portail     | oui (prédéfini via la personnalisation du runbook) |

#### OverrideEmailRecipient

Envoie chaque e-mail, y compris ceux routés par motif et l'e-mail combiné, à ces adresses au lieu des destinataires normaux. Pour les tests, les pilotes ou un système de tickets.

| Propriété                  | Valeur                          |
| -------------------------- | ------------------------------- |
| Obligatoire                | faux                            |
| Valeur par défaut          |                                 |
| Type                       | Chaîne                          |
| Nom d’affichage du portail | Rediriger tous les e-mails vers |

#### OverrideUserNamePattern

Motifs génériques pour les noms d'utilisateur, séparés par des virgules, par exemple DEM-*,KIOSK-*. Les e-mails des utilisateurs correspondants sont envoyés au « Destinataire pour les utilisateurs correspondant au motif » à la place.

| Propriété                  | Valeur                                  |
| -------------------------- | --------------------------------------- |
| Obligatoire                | faux                                    |
| Valeur par défaut          |                                         |
| Type                       | Chaîne                                  |
| Nom d’affichage du portail | Motif du nom de l'utilisateur principal |

#### UserNamePatternEmailRecipient

Adresses qui reçoivent les e-mails des utilisateurs correspondant au motif, séparées par des virgules. Requis lorsqu'un motif est défini et qu'aucun remplacement n'est actif.

| Propriété                  | Valeur                                                    |
| -------------------------- | --------------------------------------------------------- |
| Obligatoire                | faux                                                      |
| Valeur par défaut          |                                                           |
| Type                       | Chaîne                                                    |
| Nom d’affichage du portail | Destinataire pour les utilisateurs correspondant au motif |

#### SendNoPrimaryUserDevicesToOverride

Regroupe les appareils obsolètes qui n'ont pas d'utilisateur principal dans un e-mail combiné destiné au « Destinataire pour les appareils sans utilisateur principal ». Ces appareils ignorent le filtre utilisateur.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | faux                                               |
| Valeur par défaut      | Faux                                               |
| Type                   | Booléen                                            |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### NoPrimaryUserEmailRecipient

Adresses pour l'e-mail combiné, séparées par des virgules. Requis lorsque l'e-mail combiné est activé et qu'aucun remplacement n'est défini.

| Propriété                  | Valeur                                                     |
| -------------------------- | ---------------------------------------------------------- |
| Obligatoire                | faux                                                       |
| Valeur par défaut          |                                                            |
| Type                       | Chaîne                                                     |
| Nom d’affichage du portail | Destinataire pour les appareils sans utilisateur principal |
| Masqué dans le portail     | oui (prédéfini via la personnalisation du runbook)         |

#### MailTemplateLanguage

Anglais, allemand ou le modèle personnalisé de la personnalisation du runbook ; l'anglais est utilisé lorsque le modèle personnalisé est vide.

| Propriété                  | Valeur                                             |
| -------------------------- | -------------------------------------------------- |
| Obligatoire                | faux                                               |
| Valeur par défaut          | EN                                                 |
| Type                       | Chaîne                                             |
| Nom d’affichage du portail | Modèle de mail                                     |
| Masqué dans le portail     | oui (prédéfini via la personnalisation du runbook) |

#### CustomMailTemplateSubject

Objet de l'e-mail lorsque le modèle personnalisé est utilisé.

| Propriété                  | Valeur                                             |
| -------------------------- | -------------------------------------------------- |
| Obligatoire                | faux                                               |
| Valeur par défaut          |                                                    |
| Type                       | Chaîne                                             |
| Nom d’affichage du portail | Sujet de l'e-mail personnalisé                     |
| Masqué dans le portail     | oui (prédéfini via la personnalisation du runbook) |

#### CustomMailTemplateBeforeDeviceDetails

Texte au-dessus de la liste des appareils lorsque le modèle personnalisé est utilisé. Markdown autorisé.

| Propriété                  | Valeur                                             |
| -------------------------- | -------------------------------------------------- |
| Obligatoire                | faux                                               |
| Valeur par défaut          |                                                    |
| Type                       | Chaîne                                             |
| Nom d’affichage du portail | Texte personnalisé avant la liste des appareils    |
| Masqué dans le portail     | oui (prédéfini via la personnalisation du runbook) |

#### CustomMailTemplateAfterDeviceDetails

Texte sous la liste des appareils lorsque le modèle personnalisé est utilisé. Markdown autorisé.

| Propriété                  | Valeur                                             |
| -------------------------- | -------------------------------------------------- |
| Obligatoire                | faux                                               |
| Valeur par défaut          |                                                    |
| Type                       | Chaîne                                             |
| Nom d’affichage du portail | Texte personnalisé après la liste des appareils    |
| Masqué dans le portail     | oui (prédéfini via la personnalisation du runbook) |

[Retour à l’aperçu de la référence du runbook](/fr/automatisation/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/fr/automatisation/runbooks/runbook-references/org/devices/notify-users-about-stale-devices_scheduled.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
