mirror of
https://github.com/eworm-de/routeros-scripts
synced 2024-05-14 08:04:19 +00:00
... for sending notifications via Ntfy (https://ntfy.sh/). TODO: use proper formatting once supported in Android app: https://github.com/binwiederhier/ntfy/issues/889
91 lines
2.8 KiB
Markdown
91 lines
2.8 KiB
Markdown
Forward received SMS
|
||
====================
|
||
|
||
[⬅️ Go back to main README](../README.md)
|
||
|
||
> ℹ️ **Info**: This script can not be used on its own but requires the base
|
||
> installation. See [main README](../README.md) 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](sms-forward.d/notification.avif)
|
||
|
||
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`](../global-config.rsc) (the one without `-overlay`) to
|
||
> your local `global-config-overlay` and modify it to your specific needs.
|
||
|
||
Notification settings are required for
|
||
[e-mail](mod/notification-email.md),
|
||
[matrix](mod/notification-matrix.md),
|
||
[ntfy](mod/notification-ntfy.md) and/or
|
||
[telegram](mod/notification-telegram.md).
|
||
|
||
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.
|
||
|
||
See also
|
||
--------
|
||
|
||
* [Act on received SMS](sms-action.md)
|
||
|
||
---
|
||
[⬅️ Go back to main README](../README.md)
|
||
[⬆️ Go back to top](#top)
|