v20.0

Notifuse/notifusev20.0Dec 22, 2025by pierre-b

AI Summary

Notifuse v20.0 introduces a powerful marketing automation system with a visual drag-and-drop workflow builder, enabling users to create automated contact journeys triggered by events like email opens, clicks, list subscriptions, and custom API events. The release includes 9 node types for building complex workflows, full lifecycle management from draft to active/paused states, and comprehensive contact journey tracking with audit trails.

Key Highlights

Visual Workflow Builder with drag-and-drop canvas, node positioning, and real-time validation
Event-Driven Triggers based on contact, list, segment, email, and custom events with configurable frequency
9 Automation Node Types: Trigger, Delay, Email, Branch, Filter, Add to List, Remove from List, A/B Test, and Webhook
Full lifecycle management with Draft, Active, Paused, and Deleted states including PostgreSQL trigger creation on activation
Contact Journey Tracking with complete audit trail, status tracking (active, completed, exited, failed), and node execution logging

New Features

Marketing automation system for building automated contact journeys
Visual workflow builder with drag-and-drop canvas and type-specific configuration panels
Event-driven triggers: Contact events (created, updated), List events (subscribed, unsubscribed, confirmed), Segment events (joined, left), Email events (sent, opened, clicked, bounced, complained), Custom events via API
9 automation node types with deterministic A/B testing using FNV-32a hashing
Lifecycle management: Draft, Active (creates PostgreSQL triggers), Paused, Deleted (soft-delete with recovery)
Contact journey tracking with timestamps, execution duration, exit reasons, and node output logging
New API endpoints under /api/automations.* for CRUD operations and journey audit trails
Database schema with 4 new tables: automations, contact_automations, automation_node_executions, automation_trigger_log

Full Release Notes

# Notifuse v20.0 Release Notes

**Release Date:** December 22, 2025

## Marketing Automations

Version 20 introduces a powerful marketing automation system, enabling you to build automated contact journeys that respond to user behavior in real-time.

<img width="1706" height="964" alt="automation" src="https://github.com/user-attachments/assets/1842e7e6-2241-4bfe-8189-3068f2b45b92" />

---

## What's New

### Visual Workflow Builder

Design sophisticated automation workflows with an intuitive drag-and-drop canvas:

- **Node positioning** with visual connections between steps
- **Type-specific configuration panels** for each node
- **Real-time validation** to catch errors before activation

### Event-Driven Triggers

Automations start based on contact timeline events:

- **Contact events**: Created, updated (with field-specific triggers)
- **List events**: Subscribed, unsubscribed, confirmed
- **Segment events**: Joined, left
- **Email events**: Sent, opened, clicked, bounced, complained
- **Custom events**: Any event you track via the API

Configure trigger frequency as `once` (first occurrence only) or `every_time` for repeat enrollments.

### Automation Nodes

Build complex workflows with 9 node types:

| Node | Description |
|------|-------------|
| **Trigger** | Entry point based on timeline events with configurable conditions |
| **Delay** | Pause workflow for minutes, hours, or days |
| **Email** | Send templated emails with full tracking |
| **Branch** | Conditional branching with multiple paths based on segment conditions |
| **Filter** | Pass/fail routing based on contact attributes |
| **Add to List** | Subscribe contacts to additional lists |
| **Remove from List** | Unsubscribe contacts from lists |
| **A/B Test** | Deterministic variant selection using FNV-32a hashing |
| **Webhook** | POST contact data to external URLs with authorization headers |

### Lifecycle Management

Control your automations with clear state transitions:

- **Draft**: Build and test your workflow
- **Active**: Go live and start enrolling contacts (creates PostgreSQL triggers)
- **Paused**: Stop new enrollments while in-progress journeys continue
- **Deleted**: Soft-delete with recovery capability

### Contact Journey Tracking

Full visibility into each contact's path through your automations:

- Complete audit trail with timestamps and execution duration
- Contact status tracking: `active`, `completed`, `exited`, `failed`
- Exit reasons for debugging failed or exited journeys
- Node execution output logging

---

## API Reference

New endpoints under `/api/automations.*`:

| Endpoint | Description |
|----------|-------------|
| `automations.create` | Create a new automation |
| `automations.get` | Get automation details |
| `automations.list` | List all automations |
| `automations.update` | Update automation configuration |
| `automations.delete` | Soft-delete an automation |
| `automations.activate` | Activate a draft automation |
| `automations.pause` | Pause an active automation |
| `automations.nodeExecutions` | Get contact journey audit trail |

---

## Database Schema Changes

Migration v20.0 adds 4 new workspace tables:

| Table | Purpose |
|-------|---------|
| `automations` | Workflow definitions with trigger config, nodes, and statistics |
| `contact_automations` | Tracks each contact's journey through automations |
| `automation_node_executions` | Audit log of node executions for debugging |
| `automation_trigger_log` | Trigger event logging |

---

## Upgrade Instructions

1. Stop the Notifuse server
2. Pull the latest version: `docker pull notifuse/notifuse:v20`
3. Start the server - migrations run automatically
4. Verify the upgrade by checking the version in Settings

The migration is non-destructive and creates new tables without modifying existing data.

---

## Getting Started

1. Navigate to **Automations** in your workspace
2. Click **Create Automation**
3. Configure your trigger event
4. Add nodes to build your workflow
5. Save as draft and test
6. Activate when ready