README

seven SMS for Magento 2

Send transactional SMS for customer registration, order submission and shipment events directly from Magento 2 using the seven.io gateway.

Features

• Event-based SMS dispatch - fired automatically on:
  • Customer registration
  • Order submission
  • Order shipment
• Configurable templates per event - edit message body, toggle per event, target internal-only recipients
• Placeholder substitution - inject order number, customer name, tracking URL etc.
• Composer-first install - standard Magento 2 module, no marketplace required

Requirements

Installation

Composer (recommended)

composer require seven.io/magento2
php bin/magento module:enable Seven_Api
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:clean

Manual

1. Download the latest release ZIP.

2. Extract its contents into app/code/Seven/Api/ (create the directory if it does not exist).

3. Enable and register the module:

   php bin/magento module:enable Seven_Api
   php bin/magento setup:upgrade
   php bin/magento setup:di:compile
   php bin/magento cache:clean

Configuration

In the Magento admin go to Stores → Configuration → seven (or Marketing → Communications → seven depending on the Magento version), paste your API key and click Save Config.

From there you can also:

• toggle individual triggers (customer registration / order submission / order shipment)
• edit the message template per event
• define additional or default recipients (comma-separated, e.g. +4915112345678,Peter)
• mark a trigger as internal (sends to the additional recipients only, not to the customer)

Template placeholders

Placeholders are substituted with a simple str_replace - missing values resolve to an empty string.

Troubleshooting

Composer fails with requires php ^7.0|^7.1|^7.2

You are pulling an old release (v1.0.0). Make sure your composer.json does not pin to that version, then run composer update seven.io/magento2.

Config section "seven" does not appear in admin

Re-run setup:upgrade and cache:clean, then log out and back into the admin once so ACL gets refreshed.

SMS is not sent on event

Check var/log/system.log - the module logs every dispatch attempt as well as reasons for skipping (missing API key, event disabled, missing phone number).

Support

Need help? Contact us or open an issue.

License

MIT