README

seven SMS for Bagisto

Send transactional and marketing SMS to your Bagisto customers and customer groups via the seven gateway.
seven.io · API Docs · Integration Docs · Packagist

Features

• Send to Customer - Trigger an SMS for any customer with one click from the admin panel
• Send to Customer Group - Broadcast a message to every customer in a Bagisto group
• Property Placeholders - Use {{first_name}}, {{last_name}} (and any other customer property) in your message body
• Two Configuration Modes - Configure the API key in the admin UI or via .env
• Native Service Provider - Auto-discovered Laravel service provider, no manual wiring required

Prerequisites

• Bagisto 1.2 or 1.3
• PHP 7.4 or 8.x
• A seven account with API key (How to get your API key)

Installation

1. Install via Composer

composer require seven.io/bagisto

2. Register the service provider

The provider is auto-discovered. If you have disabled package discovery, add it manually to config/app.php:

'providers' => [
    // ...
    Seven\Bagisto\Providers\SevenServiceProvider::class,
],

3. Run migrations

php artisan cache:clear
php artisan migrate

Configuration

You can supply your API key either through the admin UI or via environment variable. The admin-UI value takes precedence.

Option A: Admin panel

Navigate to Dashboard > Configure > seven, enter your API key and click Save.

Option B: Environment variable

Add the key to your .env:

SEVEN_API_KEY=your-seven-api-key

Then reference it in config/services.php:

return [
    // ...
    'seven' => [
        'api_key' => env('SEVEN_API_KEY'),
    ],
];

Cache the configuration:

php artisan cache:clear && php artisan config:cache

Note: When the API key is set in the admin UI, it overrides the environment variable. The .env value is intentionally not displayed in the configuration form.

Usage

Send to a single customer

Go to Customers, locate the row of the recipient and click the seven icon in the Actions column.

Send to a customer group

Go to Groups and click the seven icon next to the target group.

Use placeholders

Any property defined on the customer can be referenced in the message body. Example:

Hi {{first_name}}, your order is on its way!

Unresolved placeholders remain as plain text in the outgoing SMS.

Troubleshooting

Support

Need help? Feel free to contact us or open an issue.

License

MIT