SMS notification with API link

Hello,

Thank you for your message.

From the Notification Delivery menu (Setup > System Aministration), if your SMS provider doesn't require authentication (or a simple token in the URL) then you can absolutely define the URL without any credentials.

Otherwise, if the latter requires authentication via specific HTTP header (ex: Authorization) then you need to use the Execute program method from a notification template to execute a script which will perform the HTTP request.

To be able to select the script from the dropdown list, the latter must be copied on the PRTG server under "C:\Program Files (x86)\PRTG Network Monitor\Notifications\EXE".

If you have questions, do not hesitate.

Regards.

Hi,

Thanks for the info

Could you please share a sample batch file for an executable program? We have a SMS gateway with headers that need to be passed for authorization.

When I set the variables %SMSNUMBER and %SMSTEXT within a batch file, will the variables be taken into account?

=========================================================================

curl -L -X POST 'https://3v3nx1.api.infobip.com/sms/2/text/advanced' \
-H 'Authorization: App 6d2e1d1274b8c344b5be3a6066e639ce-0155c1f8-6847-47bb-9e4b-88ed2322ea19' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
  "messages": [
    {
      "destinations": [
        {
          "to": "%SMSNUMBER"
        }
      ],
      "from": "InfoSMS",
      "text": "%SMSTEXT"
    }
  ]
}'

=============================================================================

Hi,

Unfortunately, we do not have example of batch script for that.

Regarding the variables %SMSNUMBER and %SMSTEXT, those cannot be used outside of the notification delivery settings. Therefore, the phone number must be passed within the parameters in the notification template.

NOTE: the placeholders must be surrounded by quotes "" to avoid issues due to spaces

Regards.

Hi,

As a text message, I need to send the following things. What changes should I make to my PowerShell script to get the below text as an SMS and what variables should I give in PowerShell?

[%sitename] %device %name %status %down (%message)

Below is the PowerShell program for SMS notification

param(
[string] $smsnumber = "",
[string] $smstext = ""
)



$headers = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
$headers.Add("Authorization", "App ***")
$headers.Add("Content-Type", "application/json")
$headers.Add("Accept", "application/json")

$body = "{`n  `"messages`": [`n    {`n      `"destinations`": [`n        {`n          `"to`": `"+***`"`n        }`n      ],`n      `"from`": `"Info`",`n      `"text`": `"SMSTEXT145`"`n    }`n  ]`n}"

$response = Invoke-RestMethod 'http://***/sms/2/text/advanced' -Method 'POST' -Headers $headers -Body $body
$response | ConvertTo-Json

Hi,

To be able to send the values provided by the placeholders you mentioned, it is preferable to have one variable for each of them (if you desire to perform operations on them and for flexibility). Therefore, the parameters should look like the following:

param(
[string] $smsnumber = "",
[string] $sitename = "",
[string] $device = "",
[string] $name = "",
[string] $status = "",
[string] $down = "",
[string] $message = "",
)

The Parameters field under "Execute Program" in the notification template must also be updated to pass all the placeholders in the same order:

"PHONENUMBER" "[%sitename]" "%device" "%name" "%status" "%down" "(%message)"

The phone number must be passed to the script as well, after verification the placeholders %smsnumber and %smstext are only usable within the notification delivery settings.

Finally, you can use the variables within the body you send.

Regards.

Hi Team,

Thanks for the details.

I have updated the details given in script and change the parameter option in PRTG under "Execute Program" but did get the expected output in the smstext . It shows as just "smstext"

=====================================================

Updated Script
============

param(
[string] $smsnumber = "",
[string] $sitename = "",
[string] $device = "",
[string] $name = "",
[string] $status = "",
[string] $down = "",
[string] $message = ""
)

$headers = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
$headers.Add("Authorization", "App 6d2e1d1274b8c344b5be3a6066e639ce-0155c1f8-6847-47bb-9e4b-88ed2322ea19")
$headers.Add("Content-Type", "application/json")
$headers.Add("Accept", "application/json")

$body = "{`n  `"messages`": [`n    {`n      `"destinations`": [`n        {`n          `"to`": `"+971582749858`"`n        }`n      ],`n      `"from`": `"Info`",`n      `"text`": `"%smstext`"`n    }`n  ]`n}"

$response = Invoke-RestMethod 'http://3v3nx1.api.infobip.com/sms/2/text/advanced' -Method 'POST' -Headers $headers -Body $body
$response | ConvertTo-Json
=================================

I need to pass the full parameters in the SMS text field. The %smstext contains below information.

"PHONENUMBER" "[%sitename]" "%device" "%name" "%status" "%down" "(%message)"

How do we put the above information in the %smstext variable in the script? Please help

Hi,

The placeholder %smstext can not be used here I'm afraid, this is why it is not present as parameter within the script. However, this is not a problem as you can pass other placeholders such as the one configured under Send SMS/Pager Message (in the notification template).

With the parameters below defined in the Parameters field of the Execute Program action, the script will receive the corresponding value for each of them in the same order. "PHONENUMBER" "[%sitename]" "%device" "%name" "%status" "%down" "(%message)"

Of course, PHONENUMBER must be replaced by the phone number the sms must be sent to.

You will find all placeholders available here: https://www.paessler.com/manuals/prtg/list_of_placeholders_for_notifications

Hi,

Thanks for the solution.

Just one more query, how we can send SMS to multiple phone numbers or users. Where I have to do the changes?

Thanks