Getting Started

Minimal Setup

Install the Package
```
composer require symfony/mailer symfony/sendinblue-mailer
```
(Note: symfony/mailer is a dependency, so install both.)
Configure in config/mail.php Add Sendinblue as a transport in Laravel’s mail config:
```
'transports' => [
    'sendinblue' => [
        'dsn' => 'sendinblue://default:your_sendinblue_api_key@default',
    ],
],
```
(Replace your_sendinblue_api_key with your actual API key from Sendinblue.)
Set Default Transport In .env:
```
MAIL_MAILER=sendinblue
```

First Test Email

use Illuminate\Support\Facades\Mail;

Mail::send([], [], function ($message) {
    $message->to('recipient@example.com')
            ->subject('Test Email')
            ->text('Hello from Laravel + Sendinblue!');
});

Where to Look First

Symfony Mailer Docs (Core functionality)
Sendinblue API Docs (For advanced use cases)
Laravel Mail Documentation (For template integration with Blade/Markdown)

Implementation Patterns

1. Sending Emails

Basic Email

Mail::to('user@example.com')->send(new OrderShipped($order));

(Use Laravel’s Mailable classes for structured emails.)

Async Sending (Queue)

Mail::to('user@example.com')->later(now()->addMinutes(5))->send(new WelcomeEmail());

(Requires MAIL_MAILER=sendinblue + queue driver configured.)

Attachments & Embeds

$message = (new OrderShipped($order))->to('user@example.com');
$message->attach(storage_path('app/invoice.pdf'));
$message->embed(storage_path('app/logo.png'), 'logo_id');

2. Templates & Personalization

Using Blade Templates

Mail::send('emails.welcome', ['user' => $user], function ($message) {
    $message->to($user->email)->subject('Welcome!');
});

Markdown Emails

Mail::markdown('emails.notification', ['data' => $data])
    ->to($user->email)
    ->subject('Your Notification');

Dynamic Recipients

$recipients = ['user1@example.com', 'user2@example.com'];
Mail::to($recipients)->send(new Newsletter());

3. Transactional Emails (Sendinblue-Specific)

Using Sendinblue Templates

$message = (new OrderConfirmation($order))->to('user@example.com');
$message->sendinblueTemplateId(12345); // Your Sendinblue template ID

Tracking & Analytics

Sendinblue automatically tracks opens/clicks. Access data via:

Sendinblue Dashboard (link)
Webhooks (Configure in Sendinblue → Settings → Webhooks)

4. Integration with Laravel Events

// In an Event Listener
public function handle(UserRegistered $event) {
    Mail::to($event->user->email)->send(new WelcomeEmail($event->user));
}

5. Testing

Mocking in Tests

public function test_welcome_email() {
    Mail::fake();

    $this->actingAs($user)
         ->post('/register');

    Mail::assertSent(WelcomeEmail::class);
}

Using Sendinblue Sandbox

Enable Sandbox Mode in Sendinblue settings.
Use a dedicated test API key in .env:
```
SENDINBLUE_API_KEY=sandbox_key_here
```

Gotchas and Tips

Pitfalls

API Key Exposure
- Never commit .env to version control.
- Use Laravel’s .env or environment variables securely.
Rate Limits
- Sendinblue has rate limits (e.g., 9,000 emails/day for free tier).
- Queue emails during peak times to avoid throttling.
Template Mismatches
- Ensure sendinblueTemplateId matches your Sendinblue template ID.
- Debug with dd($message->getSendinblueTemplateId()).
Async Delays
- Emails sent via queues may delay if the queue worker is down.
- Monitor failed_jobs table for stuck emails.

HTML vs. Text Parts

Sendinblue prefers HTML emails. Ensure your Mailable includes both:

public function build() {
    $this->subject('Hello')
         ->html('view.welcome')
         ->text('plain.welcome');
}

Debugging Tips

Check Raw Message

$message = (new WelcomeEmail())->to('user@example.com');
dd($message->getSymfonyMessage()->toString());

Enable Symfony Mailer Debug

// In a test or debug route
$mailer = app(\Symfony\Component\Mailer\Mailer::class);
$mailer->getTransport()->getLogger()->setLevel(\Psr\Log\LogLevel::DEBUG);

Sendinblue API Errors
- Check response in failed_jobs table for exception field.
- Common errors:
  - 401 Unauthorized: Invalid API key.
  - 400 Bad Request: Invalid template ID or recipient.

Extension Points

Custom Transport Extend Symfony’s Transport for custom logic:

use Symfony\Component\Mailer\Transport\AbstractTransport;

class CustomSendinblueTransport extends AbstractTransport {
    protected function doSend(Swift_Mime_SimpleMessage $message) {
        // Custom logic (e.g., retry failed sends)
    }
}

Webhook Handling Use Laravel’s route:webhook to handle Sendinblue events (e.g., email opens):

Route::post('/sendinblue/webhook', function (Request $request) {
    // Validate and process webhook payload
});

Bulk Emails For large campaigns, use Sendinblue’s SMTP Relay or their Transactional API directly.

Config Quirks

DSN Format
- Correct format: sendinblue://api_key@default
- Avoid extra spaces or special characters.
Default vs. Custom Transports
- Use mailer key in .env to switch between transports dynamically:
```
MAIL_MAILER=sendinblue
MAIL_SENDINBLUE_TRANSPORT=custom_sendinblue
```
SSL/TLS
- Sendinblue uses TLS by default. No need to configure SSL unless using a self-signed cert.

Pro Tips

Use Laravel Notifications Combine with Illuminate\Notifications for unified email/SMS logic:
```
$user->notify(new WelcomeNotification());
```

Localization Support multiple languages in emails:

$message->subject(__('Welcome!'));
$message->markdown('emails.welcome', ['user' => $user], fn ($m) => $m->locale($user->locale));

Monitor with Laravel Horizon Track email queue performance:
```
php artisan horizon
```

Sendinblue SMTP Fallback If using SMTP, ensure your Laravel mail.php has:

'sendinblue' => [
    'transport' => 'smtp',
    'host' => 'smtp.sendinblue.com',
    'port' => 587,
    'encryption' => 'tls',
    'auth_mode' => 'login',
    'username' => 'your@email.com',
    'password' => 'your_sendinblue_smtp_password',
],

Sendinblue Mailer Laravel Package