Umbraco.Engage.Automate 18.0.0-beta

<p align="center"> <img alt="Umbraco Automate" src="./assets/logo-128.png" width="128"> </p>

Umbraco.Engage.Automate

Umbraco Engage triggers and actions for Umbraco Automate.

Overview

Umbraco.Engage.Automate is a provider package that connects Umbraco Engage to Umbraco Automate, exposing Engage's event pipeline and service layer as first-class triggers and actions in Automate flows — for example, firing a goal when a form is submitted, or reacting when an A/B test goes live.

Key Features

• 20+ triggers — react to A/B testing, analytics, personalization, segment, customer journey, persona, goal, and campaign events
• 3 actions — score personas, score customer journey steps, and trigger goals from automation steps
• Bridged notifications — Engage events are re-published as CMS notifications so Automate's trigger infrastructure can observe them
• Zero configuration — EngageAutomateComposer self-registers with Umbraco's composition pipeline

Installation

dotnet add package Umbraco.Engage.Automate

No further wiring is required — the composer is auto-discovered by Umbraco's composition system.

Requirements

• .NET 10.0
• Umbraco CMS 18.x
• Umbraco Engage 18.x
• Umbraco.Automate 18.0+

Triggers

Fire an Automate flow when something happens in Engage.

A/B Testing

Analytics

Personalization & Segments

Customer Journey

Personas

Goals & Campaigns

Actions

Run Engage operations from an Automate flow.

How It Works

Engage publishes domain events through its own internal SystemEventService rather than Umbraco's standard IEventAggregator. Automate's trigger infrastructure observes IEventAggregator, so this package acts as a bridge:

Engage event → BridgeHandler → IEventAggregator notification → Automate trigger

On startup, EngageAutomateComponent registers lightweight bridge handlers with SystemEventService. Each handler converts the incoming Engage event into a typed CMS notification and re-publishes it via IEventAggregator. On shutdown, the component unregisters all handlers cleanly.

Development

dotnet restore
dotnet build
dotnet test

Project layout

src/
  Umbraco.Engage.Automate/           # Package source
    Actions/                         # Automate actions
    Notifications/                   # Bridge notification types
    Notifications/Handlers/          # Bridge handlers (Engage → CMS notifications)
    Triggers/                        # Automate triggers
tests/
  Umbraco.Engage.Automate.Tests.Unit/

License

MIT — see LICENSE for details.