[Index de la documentation](https://prescriptio.fr/docs/llms.txt)

# Événements et relève

Les événements de Prescriptio permettent à une automatisation de relever les nouveaux résultats de vos alertes : elle s'abonne à une alerte, lit les événements par pages de 100 au plus, acquitte chacun après traitement et peut révoquer l'abonnement ; c'est une relève, Prescriptio n'envoie rien vers votre serveur.

Une alerte Prescriptio vous signale les nouveaux résultats d'une recherche. Les événements donnent ces signalements à une automatisation (un scénario Make, un script, un service de votre équipe), qui vient les relever à son rythme.

## Le principe

Chaque notification d'alerte s'écrit aussi comme un événement, avec ses identifiants et ses dates, sans le corps des documents ni lien signé. Une automatisation s'abonne à l'alerte, relève les événements, les traite, puis acquitte chacun. Rien n'est poussé vers vous : c'est votre automatisation qui appelle.

1. **Créer l'alerte**

   Avec l’outil `evenements_alertes` ou l’opération `alertes.create`. Cet appel enregistre la définition de l’alerte, sans envoyer d’e-mail pendant son exécution. Les notifications produites ensuite suivent le traitement des alertes et les préférences du compte : voir la limite ci-dessous.

2. **S'abonner**

   `evenements_abonnement_creer` ou `events.subscribe`, avec l'identifiant de l'alerte et une clé stable par automatisation. Au premier démarrage, l'abonnement ne reçoit que les événements futurs. Vingt abonnements actifs au plus par compte et organisation.

3. **Relever**

   `evenements_lire` ou `events.poll`, avec l'identifiant de l'abonnement : 100 événements au plus par page, et `has_more` dit s'il en reste.

4. **Acquitter**

   `evenements_acquitter` ou `events.ack`, avec le `ack_token` de l'événement, seulement après l'avoir traité avec succès. Un acquittement ne couvre que l'événement désigné.

5. **Révoquer**

   `evenements_abonnement_revoquer` ou `events.revoke` : les lectures suivantes de cet abonnement sont refusées.

> **Attention :** Créer l’alerte n’envoie pas d’e-mail pendant l’appel. Cela ne garantit pas son exclusion des récapitulatifs ultérieurs : le traitement relit les préférences de notification du compte et du type d’événement. L’absence de contrôle du canal de l’alerte sur ce chemin est déduite du code local, non vérifiée par un essai d’envoi. Vérifiez **Paramètres › Notifications** ; ce réglage concerne le compte, pas seulement cette alerte.

## Les paramètres de la relève

| Nom | Type | Requis | Description |
|---|---|---|---|
| `subscription_id` | chaîne | oui | L'abonnement à relever. |
| `checkpoint` | chaîne | non | Le point de reprise rendu par la page précédente ; signé, valable sept jours. |
| `limit` | entier | non | De 1 à 100 ; 100 par défaut. |

Une page type, en données d'exemple :

**Réponse de events.poll · données d'exemple** (données d'exemple)

> ```json
> {
>   "results": [
>     {
>       "id": "evt_exemple_0001",
>       "subscription_id": "abo_exemple_01",
>       "alerte_id": "alerte_exemple_isolation_69",
>       "type": "marche_nouveau",
>       "entity_type": "marche",
>       "entity_id": "marche_exemple_42",
>       "occurred_at": "2026-10-06T05:00:00Z",
>       "recorded_at": "2026-10-06T05:00:02Z",
>       "ack_token": "jeton_exemple"
>     }
>   ],
>   "has_more": false,
>   "checkpoint": "point_de_reprise_exemple"
> }
> ```

## Deux façons de relever

| | Sans point de reprise | Avec point de reprise |
|---|---|---|
| Ce que rend la lecture | Les événements non acquittés, à chaque passage. | La suite ordonnée, après le point de reprise. |
| Ce que vous faites | Acquitter chaque événement traité. C'est le mode de Make et de Zapier. | Garder le nouveau point de reprise après traitement ; rien n'est acquitté implicitement. |
| Si le point de reprise expire | Sans objet. | Reprendre sans point de reprise, puis dédupliquer par identifiant. |

## Garanties et limites

- **Au moins une fois.** Un même événement peut revenir : dédupliquez par son identifiant.
- **Pas d'instantané.** Le robot des alertes passe toutes les trois heures ; une alerte se rejoue à chaque passage, ou au plus une fois par jour, son réglage par défaut, ou par semaine. Un événement naît à ce passage.
- **Une purge à 30 jours.** Les événements de plus de 30 jours partent, sauf ceux qu'un abonnement actif attend encore. Les événements non acquittés restent disponibles : surveillez ce qui s'accumule.
- **Aucune promesse d'exhaustivité** sur les sources : les plafonds et les fenêtres de collecte s'appliquent.
- **Aucun envoi.** S'abonner ne crée ni agent autonome, ni tâche planifiée, ni envoi d'e-mail.
- **Les portées.** Relever demande la lecture ; s'abonner, acquitter et révoquer demandent l'écriture.

## Pour aller plus loin

- [API REST](https://prescriptio.fr/docs/integrations/api-rest) : Les opérations, l'adresse et les erreurs.
- [Make](https://prescriptio.fr/docs/integrations/make) : Le déclencheur « Nouveau résultat d'alerte ».
- [Organiser une veille](https://prescriptio.fr/skills/prescriptio-gerer-veille) : Le skill qui guide votre agent sur ces outils.
- [Catalogue des outils](https://prescriptio.fr/docs/api) : Les schémas de `events.subscribe`, `events.poll`, `events.ack`, `events.revoke`.