Magento sms plugin documentation

Requirements

Before installing the plugin, make sure your environment meets the following requirements:

Installation

Follow these steps to install the RCSzilla plugin on your Magento store:

1. 1 Run composer require rcszilla/module-sms in your Magento root — see Packagist for all versions.
2. 2 Run php bin/magento module:enable RCSZilla_Sms.
3. 3 Run php bin/magento setup:upgrade && php bin/magento setup:di:compile && php bin/magento cache:flush.
4. 4 In the Magento admin, go to Stores → Configuration → RCSzilla SMS.
5. 5 Enter your RCS Zilla API Token (from the Devices page in your RCS Zilla admin), choose the default Channel (SMS or WhatsApp), and set the module to Enabled.
6. 6 Configure notification events: order status changes, new customer welcome SMS, and admin order alerts.
7. 7 Run php bin/magento cache:flush again, then place a test order to verify delivery.

Configuration

After installation, open the RCSzilla settings panel inside your store's admin. You will find the following sections:

• 1Order notifications — choose which order statuses trigger an SMS or RCS message: order placed, payment confirmed, order shipped, delivered, cancelled, or refunded. Each status has its own toggle and message template.
• 2Abandoned cart reminders — enable automatic SMS reminders to customers who added items to their cart but did not check out. Set the delay (e.g. 30 minutes or 2 hours) and customise the message with a direct link back to the cart.
• 3New customer welcome — send a welcome SMS automatically when a customer creates a new account. Great for first-purchase incentives and brand introductions.
• 4Message templates — personalise each message using dynamic placeholders: {{order_id}}, {{customer_name}}, {{order_total}}, {{store_name}}, {{tracking_url}}, and more.
• 5Sender ID — set the sender name or number that appears in outgoing messages. Alphanumeric sender IDs (e.g. MyShop) require activation for some countries.
• 6Delivery window — restrict sending to business hours (e.g. 09:00–20:00) to avoid sending messages at night. Messages queued outside the window are sent at the next opening time.
• 7Admin alerts — receive an SMS on your own phone every time a new order is placed, so you're always informed even when away from your dashboard.

Finding your API Key

Your API key is available in the RCSzilla dashboard under Account → API Keys. Click Create new key, give it a descriptive label (e.g. Magento Store) and copy the key shown. Treat it like a password — do not share it or commit it to version control.

Testing the integration

Use the Send Test Message button in the plugin settings to verify that your API key is valid and messages are delivered correctly. Enter a real phone number you have access to (in international format, e.g. +40712345678) and click the button — you should receive the SMS within a few seconds.

For a full end-to-end test, place a real or test order in your store and verify that the order placed notification arrives. Then change the order status to Shipped in your admin and confirm a second SMS is received. This validates the entire webhook pipeline.

Troubleshooting

• 1API key invalid / authentication error — check for leading or trailing spaces when pasting the key. Try regenerating a new key in the RCSzilla dashboard and re-entering it. Make sure the key belongs to an active account with an active plan.
• 2SMS not sending after an order status change — confirm the relevant status is enabled in the plugin's Order Notifications tab and the plugin itself is set to Active. Check the debug log for any HTTP error responses from the API.
• 3Abandoned cart reminders not sending — verify the feature is enabled and the delay is configured. The check runs on a scheduled interval; make sure your store's cron (WP-Cron, OpenCart cron, etc.) is running correctly. Customers must be logged in when they add items to cart.
• 4Messages delivered but with wrong content — review your message templates and check that placeholders are spelled exactly as documented (e.g. {{order_id}}, not {order_id}). Test with a real order to see the resolved values.
• 5Plugin not appearing after upload — ensure the ZIP archive is not double-nested. The ZIP should contain the plugin folder at the top level, not a parent folder wrapping it.
• 6PHP errors on activation — verify your server meets the PHP version requirement. Check your store's error log for the exact error message and contact support if needed.
• 7Customers receiving duplicate messages — check that you have not installed the plugin on multiple environments (dev + production) sharing the same API key. Use separate API keys per environment.

If the issue persists, contact our support team via the contact form and include your debug log output and the RCSzilla account email address.

Changelog

• 11.0.0.1 — Current release. Improved webhook reliability, added delivery-window setting, abandoned cart reminder improvements, updated compatibility with the latest Magento version.
• 2Previous version — Added multi-template support, sender ID customisation, and admin order alert SMS.
• 3Initial release — Core integration: API key authentication, order event hooks, SMS and RCS delivery.