Send Statamic Emails Through Bento
The Bento Statamic Addon makes it quick and easy to send emails and track events in your Statamic applications. We provide powerful and customizable APIs that can be used out-of-the-box to manage subscribers, track events, and send transactional emails through your Statamic Control Panel.
Requirements
- PHP 8.0+
- Statamic 5.0+
- Laravel 10.0+
- Bento API Keys
60 Second Setup Guide
Install via composer:
composer require bentonow/bento-statamic-sdk
Run these commands:
php artisan vendor:publish --tag=bento-config
php artisan vendor:publish --tag=bento-statamic-assets
php artisan vendor:publish --tag=bento-statamic-seeders
Get your Bento API Keys from app.bentonow.com/account/teams. Fill in:
- Site UUID
- Publishable Key
- Secret Key
Key Features
Control Panel Integration
- Configure Bento directly from your Statamic CP
- Easy-to-use interface for all settings
- Test email functionality built-in
- Form event management interface
Event Management
- Create and manage custom events through CP
- Associate Bento events with Statamic forms
- Automatic event tracking on form submissions
- Track visitor behavior with optional JS injection
User Management
- Automatic subscriber creation for new users
- Split name handling into first/last name
- Configurable default tags for new users
- Flexible user sync settings
Email Integration
- Seamless integration with Laravel's mail system
- Author management through CP interface
- Support for all transactional emails
- No attachment support (falls back to default mailer)
Frontend Features
- Optional automatic injection of Bento's tracking script
- Form submission tracking
- Visitor behavior tracking
- Custom event logging
Advanced Configuration
User Registration Sync
Control automatic user registration tracking in Bento:
- Enable/disable through Advanced Settings
- Configure default tags for new users
- Automatic name splitting
- Immediate tag application on registration
Form Event Integration
Connect Statamic forms with Bento events:
- Associate forms with custom events
- Automatic event triggering on submission
- Form data included as event properties
- Manage through Form Events Manager
Environment Configuration
Configure via your .env file:
BENTO_ENABLED=true
BENTO_SITE_UUID="bento-site-uuid"
BENTO_PUBLISHABLE_KEY="bento-publishable-key"
BENTO_SECRET_KEY="bento-secret-key"
MAIL_MAILER="bento"
MAIL_FROM_ADDRESS="[email protected]"
BENTO_AUTO_USER_SYNC=true
BENTO_INJECT_JS=false
Important Notes
Email Limitations
- No support for email attachments
- Not designed for bulk email sending
- No support for no-reply addresses
- Use authorized Bento authors only
Rate Limits
- Designed for transactional emails
- Not suitable for newsletter sending
- Use Bento's main application for bulk emails
- Rate limits in place to prevent abuse
Attachment Handling
Emails with attachments automatically fall back to your configured default mail provider.
Help and Support
Need assistance? We're here to help:
- Join our Discord
- Email [email protected]
- Visit docs.bentonow.com
For comprehensive documentation and SDK reference:
The Bento Statamic Addon is open-source software licensed under the MIT license.