Download the PHP package tvalimaa/mautic-bounce-webhook-bundle without Composer

On this page you can find all versions of the php package tvalimaa/mautic-bounce-webhook-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package mautic-bounce-webhook-bundle

Mautic Bounce Webhook Bundle

An unofficial Mautic plugin that processes mailer transport webhook callbacks for bounce and spam events, automatically adding contacts to the Do Not Contact (DNC) list.

Supports Mailjet, SendGrid, and Mailgun out of the box. Adding new providers requires only implementing a single interface.

How it works

  1. Your mailer sends a webhook POST to Mautic's transport callback endpoint.
  2. The bundle selects the correct provider based on the MAILER_BOUNCE_PROVIDER env var.
  3. The provider fingerprints the payload to confirm it matches the expected format.
  4. Bounce, spam, and unsubscribe events are recorded via Mautic's TransportCallback, which marks the contact as DNC.

Hard bounces and permanent failures add contacts with DoNotContact::BOUNCED. Spam complaints and unsubscribes use DoNotContact::UNSUBSCRIBED. Soft bounces are logged and skipped.

Requirements

Installation

Copy or clone the bundle into your Mautic plugins/ directory:

Then clear the Mautic cache and reload the plugins:

Configuration

Set the following environment variables (e.g. in .env.local):

Variable Required Description
MAILER_BOUNCE_PROVIDER Yes Active provider: mailjet, sendgrid, or mailgun
MAILER_CALLBACK_SECRET No Secret token appended as ?token= to the webhook URL. When unset the endpoint is unrestricted (useful for local dev).

Example

Webhook URL

Configure your mailer to POST events to:

Supported providers

Mailjet

Handles bounce (hard only), blocked, and spam events from the Mailjet Event API.

SendGrid

Handles bounce (hard only), spamreport, unsubscribe, and group_unsubscribe events from the SendGrid Event Webhook.

Mailgun

Handles failed (permanent only), complained, and unsubscribed events from the Mailgun Webhook API v3.

Adding a custom provider

  1. Create a class implementing BounceProviderInterface in the Provider/ directory.
  2. Add it as a constructor argument in BounceProviderRegistry.
  3. Register it with a key in $this->providers.
  4. Set MAILER_BOUNCE_PROVIDER to the new key.

License

GPL-3.0-only

All versions of mautic-bounce-webhook-bundle with dependencies

PHP Build Version
Package Version
Requires php Version ^8.1
ext-json Version *
mautic/core-lib Version ^5.0|^6.0|^7.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package tvalimaa/mautic-bounce-webhook-bundle contains the following files

Loading the files please wait ...