joeykeller/mautic-kumomta-callback

A Mautic 5/6 plugin to handle KumoMTA feedback loops and mark contacts as Do Not Contact.

v1.0.0 2025-11-16 08:51 UTC

Requires

• php: >=8.0
• mautic/core-lib: >=5.0

MIT

• Joey Keller

• plugin
• email
• bounce
• Mautic
• deliverability
• kumomta

README

Supported Mautic Version: 5.xx This Plugins processes an 5xx requests sent by Kumo MTA via webhook and markes contact as bounced if nesseccary.

Supported mailer schemes:

smtp

Installation

To install the Mautic Kumo MTA plugin, follow these steps:

1. Run the following command to add the plugin to your Mautic installation:

   composer require jos0405/kumomtacallback

2. Clear the Mautic cache to ensure the plugin is recognized:

   php bin/console cache:clear

3. Enable Webhook processing in Kumo MTA, make sure you replace your Mautic URL at YOURMAUTIC

   -- Load DKIM config (uses /opt/kumomta/etc/dkim_data.toml)
   local dkim_signer = dkim_sign:setup{ '/opt/kumomta/etc/dkim_data.toml' }
   
   -- Configure webhook.site log hook (must be BEFORE queue_helper)
   log_hooks:new_json{
     name = 'webhook',
     url  = 'YOURMAUTIC/mailer/callback',
     log_parameters = {
       headers = { 'Date', 'Message-Id', 'Subject', 'From', 'To' },
    },
    queue_config = {
       retry_interval     = '1m',
       max_retry_interval = '20m',
     },
   }
   
   -- Load the queue helper, which reads queues.toml
   local queue_helper = queue_module:setup{ '/opt/kumomta/etc/policy/queues.toml' }
   

4. After updating the init.lua file, don't forget to restart kumo MTA. Check status if everything is still crisp and curry. bash systemctl restart kumomta systemctl status kumomta

Contributing

Plz feel free to submit PRs, bugs and suggestions.