import {
  TimelineContainer
} from '@/components/docs/TimelineContainer'


export const bentoStatamicSettingsImg = '/docs/images/article_resources/bento_statamic_speedrun.webp'
export const bentoStatamicEmailConfigImg = '/docs/images/article_resources/email-config-statamic.webp'
export const bentoUserSyncImg = '/docs/images/article_resources/user-sync-statamic.webp'
export const bentoStatamicEventConfigImg = '/docs/images/article_resources/form-event-config-statamic.webp'


export const exampleFile = 'statamic-examples'

# Send Statamic Emails Through Bento
The Bento Statamic Addon lets you send transactional emails, manage subscribers, and track events from your Statamic Control Panel. This guide covers setup and configuration.


## Requirements
- PHP 8.0+
- Statamic 5.0+
- Laravel 10.0+
- Bento API keys

## 60 Second Setup Guide


  
    
    
 Install via composer: <code>composer require bentonow/bento-statamic-sdk</code> 

    
    
      Run these commands:
      

    

    
    Access the Bento configuration page in your Statamic Control Panel under Tools &gt; Bento

    
    
      Get your Bento API keys from [app.bentonow.com/account/teams](https://app.bentonow.com/account/teams). Fill in:
      - Site UUID
      - Publishable Key
      - Secret Key
    

    
    Enable Bento through the Control Panel interface

    
    Select an authorized Bento author from the dropdown. Note: Bento does not support no-reply sender addresses.

    
    Use the 'Send Test Email' button to verify your configuration. The test will be sent to your admin email address.
  


---

## 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:


---

## 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
You will need to configure a fallback email driver for sending emails with attachments.

---

## Help and Support

Need assistance? We're here to help:
- Join our [Discord](https://discord.gg/ssXXFRmt5F)
- Email jesse@bentonow.com
- Visit [docs.bentonow.com](https://docs.bentonow.com)

For comprehensive documentation and SDK reference:
- [Integration guides](https://docs.bentonow.com)
- [SDK reference](https://docs.bentonow.com/subscribers)

*The Bento Statamic Addon is open-source software licensed under the MIT license.*