README

Provider-agnostic customer engagement and marketing automation for Laravel 10, 11, and 12.

Applications call Cleyverson\Engage\Facades\Engage; provider adapters own all Brevo-specific code, so future providers such as Customer.io, ActiveCampaign, HubSpot, or Mailchimp can be added without changing application code.

Installation

composer require cleyverson/brevo-engage
composer require sarfrazrizwan/laravel-brevo
php artisan vendor:publish --tag=engage-config
php artisan vendor:publish --tag=engage-migrations
php artisan migrate

Configuration

return [
    'provider' => env('ENGAGE_PROVIDER', 'brevo'),
    'queue' => true,
    'track_events' => true,
    'sync_contacts' => true,
    'templates' => [
        'welcome' => 12,
        'inactive_user' => 15,
        'subscription_started' => 22,
    ],
    'lists' => [
        'premium-users' => 42,
    ],
];

Usage

use Cleyverson\Engage\Facades\Engage;

Engage::identify($user);

Engage::identify($user, [
    'plan' => 'premium',
    'country' => 'ES',
    'language' => 'es',
]);

Engage::track('login', $user);

Engage::track('course_completed', $user, [
    'course_id' => 123,
    'course_name' => 'Laravel Fundamentals',
]);

Engage::sendTemplate('welcome', $user, [
    'first_name' => $user->name,
]);

Engage::addToList('premium-users', $user);
Engage::removeFromList('premium-users', $user);

All outbound provider communication is performed by queued jobs.