mauticinsights/mautic-observer

Observes Mautic contact, email, campaign, form, page and segment events and streams them to the Mautic Insights ingest API.

5.0.0 2026-08-16 14:28 UTC

Requires

• php: >=8.0.2

Requires (Dev)

• dg/bypass-finals: ^1.9
• doctrine/dbal: ^3.8
• doctrine/orm: ^2.14
• friendsofphp/php-cs-fixer: ^3.59
• phpstan/phpstan: ^1.12
• phpunit/phpunit: ^9.6
• symfony/config: ^6.0,<6.1
• symfony/console: ^6.0,<6.1
• symfony/dependency-injection: ^6.0,<6.1
• symfony/http-client: ^6.0,<6.1
• symfony/http-kernel: ^6.0,<6.1
• symfony/translation-contracts: ^3.0
• symfony/validator: ^6.0

Suggests

• ext-redis: Optional: Redis fallback for the API event buffer when the filesystem cache directory is not writable.
• mautic/core-lib: Mautic 5.x core (required in production; not installed in this repo for standalone dev tooling).

proprietary

• plugin
• Mautic

Published on Packagist.org on 2026-08-16 14:33 UTC

README

Observes Mautic contact, email, campaign, form, page and segment events and streams them to the Mautic Insights ingest API.

Package: mauticinsights/mautic-observer on Packagist.

What this plugin does

• Listens to key Mautic events (contacts, email, campaigns, forms, page hits, segments)
• Buffers and sends outbound payloads to the Insights API (/event, /status)
• Supports bulk sync on enable, segment reconcile after batch rebuilds, and a Health panel in the plugin UI

Requirements

• PHP 8.0+
• Mautic 5.x
• Composer 2.x

Installation (Packagist)

Install from the root of your Mautic project — no custom repositories entry is required:

composer require mauticinsights/mautic-observer

Pin to the Mautic 5 line (recommended):

composer require mauticinsights/mautic-observer:^5.0

Composer installs the bundle into plugins/MauticInsightsBundle (extra.install-directory-name).

After install

php bin/console cache:clear
php bin/console mautic:plugins:reload

Then in the Mautic UI:

1. Open Settings → Plugins
2. Find Mautic Insights
3. Enter the Insights API token and required settings
4. Publish / enable the integration

Optional: development branch

Only if you need unreleased code from Packagist’s dev-main:

composer require mauticinsights/mautic-observer:dev-main -W

Verify it works

• Open the plugin Health panel after saving configuration — no errors
• Confirm events flush without warnings in Mautic logs
• Check API endpoint reachability and write access to the Insights buffer directory (var/mauticinsights-buffer under the Mautic project)

License

Proprietary — see LICENSE.