Aller au contenu principal
Cette page vous a-t-elle été utile ?

Référence des déclencheurs

Toutes les valeurs triggerType valides disponibles lors de la création de règles d'automatisation dans PrimeCal.

Types de déclencheurs​

Valeur enumChaîne de transportDescriptiontriggerConfig requis
EVENT_CREATEDevent.createdSe déclenche quand un nouvel événement est créé dans l'un des calendriers de l'utilisateur.Aucun
EVENT_UPDATEDevent.updatedSe déclenche quand un événement existant est modifié.Aucun
EVENT_DELETEDevent.deletedSe déclenche quand un événement est supprimé.Aucun
EVENT_STARTS_INevent.starts_inSe déclenche X minutes avant le début d'un événement.{ minutesBefore: nombre }
EVENT_ENDS_INevent.ends_inSe déclenche X minutes avant la fin d'un événement.{ minutesBefore: nombre }
RELATIVE_TIME_TO_EVENTrelative_time_to_eventSe déclenche à un moment relatif au début ou à la fin de l'événement (décalage positif ou négatif).{ offsetMinutes: nombre, anchor: 'start' | 'end' }
CALENDAR_IMPORTEDcalendar.importedSe déclenche quand un import de synchronisation de calendrier externe se termine.Aucun
SCHEDULED_TIMEscheduled.timeSe déclenche selon un planning cron, indépendamment de tout événement spécifique.{ cronExpression: chaîne }
WEBHOOK_INCOMINGwebhook.incomingSe déclenche quand une requête POST est reçue à l'URL webhook unique de la règle.Aucun
TASK_STATUS_CHANGEDtask.status_changedSe déclenche quand le champ status d'une tâche change (ex. todo → done). Pas encore sélectionnable depuis le constructeur de règles de l'interface — créez des règles l'utilisant via l'API Automatisation.Aucun
TASK_SCHEDULED_STARTtask.scheduled_startSe déclenche quand une tâche atteint son heure de début planifiée, y compris les tâches instanciées depuis un modèle de routine. Également API uniquement pour l'instant.Aucun
NOTIFICATION_DISPATCHEDnotification.dispatchedSe déclenche chaque fois qu'une notification est envoyée au propriétaire de la règle, sur n'importe quel canal — ex. une notification push event.reminder, une alerte reservation.due, ou l'action send_notification d'une autre règle.Aucun

Remarques​

  • event.starts_in / event.ends_in : Le planificateur interroge avec une résolution d'1 minute. Les valeurs minutesBefore inférieures à 1 ne sont pas fiables.

  • scheduled.time : cronExpression doit être une expression cron valide à 5 champs (minute heure jour mois jour de la semaine). Le planificateur évalue les expressions cron éligibles chaque minute.

  • webhook.incoming : Chaque règle utilisant ce type de déclencheur se voit attribuer un webhookToken unique (hexadécimal, 64 caractères). Le jeton est accessible dans la vue détaillée de la règle et peut être régénéré via POST /api/automation/rules/:id/webhook/regenerate.

  • relative_time_to_event : Introduit pour des décalages temporels plus fins non couverts par event.starts_in/event.ends_in. Utilise offsetMinutes (négatif = avant, positif = après).

  • task.status_changed / task.scheduled_start : Types de déclencheurs reconnus par le backend, pas encore exposés dans le sélecteur de déclencheur du constructeur de règles. task.scheduled_start est ce qui pilote le schéma « une tâche de routine déclenche un appel REST domotique à son heure planifiée » — voir Automatisation domotique.

  • notification.dispatched : Le sens inverse de l'action send_notification — au lieu qu'une règle envoie une notification, une règle peut réagir à l'envoi d'une notification (depuis n'importe quelle source : le planificateur de rappels, une autre règle d'automatisation, une alerte de réservation, etc.). Utilisez les champs de condition notification.type et notification.channel (voir Référence des conditions) pour restreindre les notifications auxquelles une règle réagit. Cela permet à une notification d'orchestrer un système externe plutôt que de simplement alerter l'utilisateur — par exemple, une notification in-app event.reminder de 5 minutes peut déclencher une action webhook qui active une scène domotique « mode réunion » :

    {
      "triggerType": "notification.dispatched",
      "conditionLogic": "AND",
      "conditions": [
        { "field": "notification.type", "operator": "equals", "value": "event.reminder" },
        { "field": "notification.channel", "operator": "contains", "value": "inapp" },
        { "field": "notification.data.minutesBefore", "operator": "equals", "value": "5" }
      ],
      "actions": [
        { "type": "webhook", "config": { "url": "https://smarthome.local/api/scene/meeting-mode" } }
      ]
    }

    Comme ce déclencheur se déclenche depuis le DomainEventBus partagé plutôt qu'un appel de service direct, il fonctionne pour n'importe quel eventType de notification du catalogue (voir API Notifications) — pas seulement les rappels d'événements.

Exigence de forfait​

Les points de terminaison d'automatisation nécessitent un forfait PrimeCal incluant la fonctionnalité d'automatisation. Voir Forfaits et tarifs pour les détails des forfaits.