GatewayAPI

✉️ Personalized Message Templates

• Mail-merge support for campaigns and WooCommerce messages
• Use dynamic placeholders such as customer data, order data, and custom fields
• Supports both GSM and Unicode SMS
• Configurable sender ID per message

🧩 Frontend Shortcodes

• Signup: Allow users to subscribe to your SMS lists directly from your website.
• Update Profile: Enable users to update their contact details and group subscriptions.
• Unsubscribe: Provide a simple way for users to opt-out of SMS communications.
• Send SMS: Enable SMS sending from the frontend (e.g. for internal tools).

🚀 Built for Reliability & Scale

• Uses Action Scheduler (the same job system used by WooCommerce)
• Non-blocking background processing
• Suitable for very large campaigns (100,000+ recipients)
• No PHP timeouts or long-running requests

⚠️ Coming from v1.x? Some features are gone

The following features are not part of this plugin anymore:

• Receiving or processing incoming SMS messages
• Contact Form 7-integration

These features had very low usage and were removed to simplify the plugin. If you need this, consider the legacy version of the plugin (any version before 2.0).

🌍 About GatewayAPI.com

• Founded in 1999
• One of Europe’s leading SMS providers
• Offices in Copenhagen, Odense, and Aalborg, Denmark
• Hundreds of millions of SMS messages delivered yearly
• No subscriptions – pay only for what you send
• Fast and reliable SMS delivery worldwide

🔧 Installation

1. 01Create a free account at https://gatewayapi.com/
2. 02Install and activate the plugin
3. 03Go to GatewayAPI → Settings
4. 04Add your API Token from your GatewayAPI.com account
5. 05Play around! Send a test campaign or setup a WooCommerce Order hook

🚀 Getting Started

🛍️ WooCommerce Notifications

After installation, you can enable SMS notifications per WooCommerce order status. Each status can send messages to customers, internal recipients, or both.

Place a test order to confirm everything is working as expected.

📨 Campaign Messaging

You can create SMS campaigns without WooCommerce:

• Import contacts via CSV or add them manually
• Organize contacts into lists
• Create a personalized SMS campaign

🔐 Two-Factor Authentication

To add SMS-based two-factor authentication to your WordPress site:

• Go to GatewayAPI → Settings → Two-Factor
• Enable two-factor authentication
• Configure which user roles should use two-factor authentication
• Optionally limit to specific phone countries for security
• Set a grace period if needed

🧩 Shortcodes

The plugin provides shortcodes to integrate SMS features into your frontend.

📝 Common Attributes

• action: (required) One of signup, update, unsubscribe, send_sms.
• recaptcha: Set to 1 to enable Google reCAPTCHA (must be configured in settings).
• embed_css: Set to 1 to embed basic styling for the form.
• groups: Comma-separated list of group/tag IDs to target.
• allowed_countries: Comma-separated list of country codes (e.g., 45,44).

➕ Signup Form

[gatewayapi action=”signup” groups=”1,2,3″]

🔄 Update Profile

[gatewayapi action=”update”]

❌ Unsubscribe

[gatewayapi action=”unsubscribe”]

✉️ Send SMS

[gatewayapi action=”send_sms” groups=”1″]

Security Warning: The send_sms action allows sending SMS messages from your frontend. This can be dangerous if left open to the public as it could be abused to send spam or drain your GatewayAPI credits.

We strongly recommend combining this with a security system, such as: * Placing the shortcode on a password-protected page. * Restricting access to specific user roles using a membership plugin. * Always enabling recaptcha=”1″ to prevent automated abuse.

❓ Frequently Asked Questions

Can this plugin handle very large SMS campaigns?

Yes. Campaigns are processed using Action Scheduler, ensuring stable delivery, high throughput, and retries — even on shared hosting environments.

Does this plugin support personalized SMS messages?

Yes. You can use dynamic placeholders from contacts and WooCommerce orders to send fully personalized, mail-merged SMS messages.

Is WooCommerce required?

WooCommerce is only required for order-based SMS notifications. Campaign messaging and contact management work without WooCommerce.

🔗 External services

This plugin connects to the GatewayAPI.com service to send SMS messages. This external service is required for the plugin’s primary functionality, which is delivering transactional and campaign SMS messages.

When sending an SMS, the plugin transmits the recipient phone number, message content, and related metadata (such as sender ID) to GatewayAPI.com. For WooCommerce notifications, order-related data may be used to generate the message content before it is sent.

No data is sent to GatewayAPI.com unless an SMS is actively being sent by the site administrator or triggered by configured WooCommerce events.

This service is provided by GatewayAPI ApS.

Privacy policy, terms and conditions, data processing agreement, and security certifications (including ISAE 3000 and ISAE 3402) are available at: https://gatewayapi.com/security-and-compliance/

📋 Changelog

2.1.4

• Improved UI for tag dropdowns when there are many items.

2.1.3

• New bulk actions for all contacts matching current filters: Delete/deactivate/activate contact + add/remove tag.
• Contacts list UI update, more sleek import/export buttons.

2.1.2

• Improved contact import: Papa Parse CSV parser with auto-delimiter detection and auto-created meta fields from unknown columns.
• Fallback support: Support for our previous (<v2.0) CSV format support.

2.1.1

• Bugfix: The recipient tags were not properly sent to the campaign creation UI.

2.1.0

• New feature: Shortcodes for signup, updating contact details, and unsubscription.
• New feature: Shortcode for sending SMS from the frontend (use with caution and combine with security-system).
• Bugfix: Contacts filtering by tag didn’t work.

2.0.8

• The migration tool should now be available to all users of the 1.x-versions, as some were missing it.

2.0.7

• Tool for easy and automatic migration of old contacts, contact fields and contact groups included.
• Automatically migrates and uses old OAuth key.

2.0.5

• Bugfix: For users upgrading from 1.x, a missing capability upgrade made the plugin unavailable until deactivate + reactivate.

2.0.4

• Two-factor authentication has been re-added to the plugin.

2.0.2-2.0.3

• No changes. These versions exist because we have been working on automating release processes.

2.0.1

• Minor modifications to ensure best-practices as per WordPress guidelines.

2.0.0

• Complete rewrite of the plugin!

1.8.3

• Compability up to WordPress 6.3.1.

1.8.2

• Bugfix: Built in shortcode defaulted to the posts title as the name of the new recipient. Now defaults to ”, as expected.

1.8.1

• Bugfix: Built in shortcode for signup did not work properly, when allowing the user to select groups.

1.8.0

• Support for using our GatewayAPI.eu-setup!
• Bugfix: 2FA login security could fail on PHP 7.4+.

1.7.6

• Bugfix: Fixing that GatewayAPI Shortcode for signup had stopped saving some meta-fields since 1.7.2.

1.7.5

• Bugfix: Default country code did not apply correctly in the country drop downs.

1.7.4

Compability with Contact Form 7.

• Bugfix: Signup via Contact Form 7 works again (upgraded to being compatible with CF7’s newer window.fetch based approach of AJAX).
• Bugfix: Notices in CF7-integration (PHP) and a typo, causing an exception in frontend JS on CF7-forms.

1.7.3

Bugfix release.

• Bugfix: Saving recipient details using the UI and via Excel-importer, works properly again.
• Bugfix: SMS Reply-feature works again.

1.7.2

This release strengthens the overall security, thanks to input from an external security audit.

We highly recommend upgrading to this version, as it hardens the security of our plugin, especially on WordPress-installation with multiple users which may have users of lower roles than editor.

• Consistent use of nonce’s in AJAX requests, to prevent CSRF and prevent privilege escalation.
• Enforce correct roles for various actions, preventing potential privilege escalation.
• Improved sanitizing, validation and escaping of input and output.
• All PHP-files are now secured from direct access.
• Refactored function prefixes from gwapi_ , _gwapi_ and _gatewayapi_ to gatewayapi_ only.

1.7.1

• Bugfix: Notifications were not sent.

1.7.0

• New: Notification module