Skip to content

Mautic ECA

The Mautic ECA module provides integration between Drupal and Mautic marketing automation platform through ECA (Events-Conditions-Actions) workflows.

Features

  • Contact Management: Create, update, delete, and retrieve contacts from Mautic
  • Segment Management: Manage contact segments and add/remove contacts from segments
  • Do Not Contact: Handle unsubscribe and bounce management with proper channel tracking
  • Webhook Integration: Receive and process Mautic webhooks for real-time event handling
  • Bulk Operations: List and manage multiple contacts/segments with filtering and pagination
  • Token Support: Full integration with ECA tokens for dynamic data handling

Prerequisites

  • Mautic instance with API access enabled
  • Mautic API module configured with connection settings
  • Valid Mautic API credentials (username/password or OAuth)
  • Proper API permissions for the operations you plan to use

Common Use Cases

  • User Synchronization: Sync Drupal users with Mautic contacts upon registration
  • Marketing Automation: Trigger marketing campaigns based on Drupal events
  • Lead Generation: Handle form submissions and convert them to Mautic leads
  • Email Preferences: Manage email preferences and handle unsubscribes
  • Event Tracking: Track user interactions and send data to Mautic for scoring
  • Content Personalization: Use Mautic contact data to personalize Drupal content

Setup Instructions

  1. After installing the module

  2. Configure Mautic Connection:

  3. Go to Configuration > Web services > Mautic API (/admin/config/services/mautic_api)
  4. Add a new connection with your Mautic instance URL and API credentials

  5. To check if the connection is working, edit the newly created connection. You should see the status of the connection displayed at the top.

  6. Create ECA Models:

  7. Use the ECA Modeller to create workflows
  8. Add Mautic actions and events to your models

Installation

1
2
composer require drupal/mautic_eca
drush pm:install mautic_eca

Instead of using Drush to enable the module, you can also go to "Administration / Extend" (/admin/modules) and enable the module Mautic ECA from there.