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


  <div>
    
    <br/> 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.
  </div>


---

## 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.*