ℹ️ Info: This script can not be used on its own but requires the base installation. See main README for details.
RouterOS can receive SMS. This script forwards SMS as notification.
A broadband interface with SMS support is required.
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;
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 ofmatch(which is matched against the received message),allowed-number(which is matched against the sending phone number or name) andcommand. Formatchandallowed-numberregular 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 localglobal-config-overlayand modify it to your specific needs.
Notification settings are required for e-mail, matrix, ntfy and/or telegram.
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.
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.