Turbo SMS Notify

🇺🇦

This module is maintained by Ukrainian developers.
Please consider supporting Ukraine in a fight for their freedom and safety of Europe.

Drupal 10/11 module that sends SMS and Viber via TurboSMS when a Webform is submitted. Supports Token API, test send, delivery-status webhook, and logging. (≤200 chars)

Features

• Webform Handler: dispatches messages on submission save (postSave).
• Channels: SMS, Viber (transactional / promotional) with optional image and button (caption/action).
• Token API in the message template: supports [site:*], [date:*], [webform_submission:*], [webform:*], [current-user:*].
• Settings page (/admin/config/system/turbo-sms) with a “Send test” action to verify the API.
• Flexible targeting: pick the Webform by machine ID (or * for all), choose the phone field key.
• Phone normalization to E.164 (leading +).
• Webhook (POST /turbosms/webhook) for DLR/delivery statuses; optional signature verification.
• Logging to the turbo_sms_notify channel (Reports → Recent log messages).

Post-Installation

1. Enable and rebuild caches: drush en turbo_sms_notify -y && drush cr.
2. Go to Admin → Configuration → System → TurboSMS and fill in:
   • API token and Sender (alpha name) from your TurboSMS account;
   • Webform machine ID (you can temporarily use * for diagnostics);
   • Phone element key (e.g., phone);
   • Message template (Token API supported);
   • channel options (SMS/Viber) and, if needed, Webhook secret.
3. Open the target Webform → Settings → Handlers → Add handler → TurboSMS notify → Save.
4. Use “Send test” on the settings page to verify authentication and delivery.
   Note: the test has no webform_submission context, so those tokens are cleared; on real submit all tokens are resolved.

Additional Requirements

• Drupal 10/11 (PHP ≥ 8.1).
• Webform module.
• TurboSMS account with an active API token and approved alpha name.
• Token module — optional but recommended for tokenized templates.
• Server must allow outbound HTTP to api.turbosms.ua.

Recommended modules/libraries

• Token — richer tokens for message templates.
• Admin Toolbar — quicker access to the settings page.

Similar projects

There are generic SMS frameworks/gateways that require manual integration for each provider. This module works with the TurboSMS JSON API out of the box, is tightly integrated with Webform Handler, and supports Viber extras and tokens without extra glue code.