Événements et relève

Les mêmes gestes existent en outils du connecteur (evenements_*) et en opérations de l'API REST (events.*), avec la même autorisation et les mêmes quotas.

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. 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. 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. 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. 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. 5

   Révoquer

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

Les paramètres de la relève

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

{
  "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

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