RouterOS Scripts
a collection of scripts for MikroTik RouterOS

Forward received SMS

⬅️ Go back to main README

ℹ️ Info: This script can not be used on its own but requires the base installation. See main README for details.

Description

RouterOS can receive SMS. This script forwards SMS as notification.

A broadband interface with SMS support is required.

Sample notification

sms-forward notification

Requirements and installation

Just install the script:

$ScriptInstallUpdate sms-forward;

… and add a scheduler to run it periodically:

/system/scheduler/add interval=2m name=sms-forward on-event="/system/script/run sms-forward;" start-time=startup;

Configuration

You have to enable receiving of SMS:

/tool/sms/set receive-enabled=yes;

The configuration goes to global-config-overlay, this is the only parameter:

SmsForwardHooks: an array with pre-defined hooks, where each hook consists of match (which is matched against the received message), allowed-number (which is matched against the sending phone number or name) and command. For match and allowed-number regular expressions are supported. Actual phone number ($Phone) and message ($Message) are available for the hook.

ℹ️ Info: Copy relevant configuration from global-config (the one without -overlay) to your local global-config-overlay and modify it to your specific needs.

Notification settings are required for e-mail, gotify, matrix, ntfy and/or telegram.

Tips & Tricks

Take care of harmful commands!

It is easy to fake the sending phone number! So make sure you do not rely on that number for potentially harmful commands. Add a shared secret to match into the text instead, for example: reboot-53cr3t-5tr1n9 instead of just reboot.

Order new volume

Most broadband providers include a volume limit for their data plans. The hook functionality can be used to order new volume automatically.

Let’s assume an imaginary provider ABC sends a message when the available volume is about to deplete. The message is sent from ABC and the text contains the string 80%. New volume can be ordered by sending a SMS back to the phone number 1234 with the text data-plan.

:global SmsForwardHooks {
  { match="80%";
    allowed-number="ABC";
    command="/tool/sms/send lte1 phone-number=1234 message=\"data-plan\";" };
};

Adjust the values to your own needs.