Webhooks

1. 1. Install the SMSTunnel app from Google Play on your Android phone and sign in.
2. 2. In your dashboard, open Apps → Webhooks and click New webhook.
3. 3. Pick what will call it: Grafana, Uptime Kuma, Healthchecks, Gatus, Alertmanager, Odoo Online, or Something else (a script, a cron job, any other tool). That fills in the name and, where the tool needs one, the text of the message.
4. 4. Add the numbers that get the texts, with + and the country code: up to 10, and each one gets its own text. Change Calls an hour, at most if 20 doesn't suit you, and click Create the webhook.
5. 5. Copy the address. For the tool you picked, the dashboard shows its setup steps with the address already in them, and Send a test, which texts the webhook's numbers and counts toward its hour.

Make a webhook

It opens New webhook with Something else picked; pick your tool instead if it's in the list. Each setup below has a button that picks its tool.

The tool's own words

Leave the text of the message empty, and SMSTunnel writes the text from the call:

• Prometheus Alertmanager and Grafana: status, alert name and summary, like [FIRING] DiskFull - Disk 95% full: /volume1, with "(+2 more)" for a group.
• Uptime Kuma: its alert already starts with the monitor's name, so picking Uptime Kuma sets the text of the message to {{msg}}. Without it, the name shows twice.
• Any other tool: the first of its message, text, msg, title, body, content, summary or subject fields.

Your own words

Write the Text of the message (messageTemplate in the API), up to 500 characters, and put the call's fields between double braces. A dot goes one level into the JSON, a number picks an item of a list, and a field missing from the call stays empty:

[{{status}}] {{alerts.0.labels.alertname}} on {{alerts.0.labels.instance}}

Texts are cut at 480 characters: alerts should be short, and it keeps one noisy call from becoming several SMS.

Uptime Kuma

Settings → Notifications → Set Up Notification: Notification Type Webhook, Post URL the address, Request Body Preset - application/json. Picking Uptime Kuma sets the webhook's text of the message to {{msg}}.

Make a webhook for Uptime Kuma The Uptime Kuma guide

Grafana

Alerting → Contact points → + Add contact point, Integration Webhook, with the address in URL and the other fields as they are. Any Grafana version, Grafana Cloud too.

Make a webhook for Grafana The Grafana guide

Prometheus Alertmanager

A receiver with the address, on any Alertmanager version. Route the alerts that deserve a text to it:

receivers:
  - name: sms
    webhook_configs:
      - url: https://smstunnel.io/api/v1/webhook/<token>

Make a webhook for Prometheus Alertmanager The Prometheus Alertmanager guide

Healthchecks.io

Integrations → Add Integration → Webhook, with GET and the address plus the words, when a check goes down and when it goes up:

https://smstunnel.io/api/v1/webhook/<token>?message=$NAME+is+DOWN
https://smstunnel.io/api/v1/webhook/<token>?message=$NAME+is+back+up

Make a webhook for Healthchecks.io The Healthchecks.io guide

Gatus

The custom alerting provider, with the address, the Content-Type line and a body with only the words:

alerting:
  custom:
    url: "https://smstunnel.io/api/v1/webhook/<token>"
    method: "POST"
    headers:
      Content-Type: "application/json"
    body: |
      {"message": "[ALERT_TRIGGERED_OR_RESOLVED]: [ENDPOINT_NAME] - [ALERT_DESCRIPTION]"}

Make a webhook for Gatus The Gatus guide

Odoo Online

An automation rule with the action Send Webhook Notification, and a text of the message like New order {{name}}: {{amount_total}}. Texts to your own numbers, never to the customer of the record.

Make a webhook for Odoo Online The Odoo Online guide

GitHub Actions

A step that runs when a job fails, with the address in the repository secret SMS_WEBHOOK:

- name: Notify on failure
  if: failure()
  run: |
    curl -X POST "${{ secrets.SMS_WEBHOOK }}" \
      -H "Content-Type: application/json" \
      -d '{"message":"Build failed on ${{ github.repository }}"}'

Make a webhook for it The GitHub Actions guide

Cron or any script

A text when the nightly job fails. In crontab the whole command stays on one line: cron doesn't join lines that end with a backslash.

0 3 * * * /opt/backup.sh || curl -s -X POST https://smstunnel.io/api/v1/webhook/<token> -H 'Content-Type: application/json' -d '{"message":"Nightly backup FAILED"}'

Make a webhook for it

Apps → Webhooks lists your webhooks with the numbers they text, when each was last used, its calls this hour and, if its last call sent no text, why. For each one:

• Address and setup shows the address again, ready to copy, with the steps for each tool and Send a test.
• Edit changes the name, the numbers, the text of the message and the calls an hour. The address stays the same, so your tools keep working.
• Stop refuses its calls until you Start again.
• New address replaces the address: the current one stops working at once, so put the new one in every tool that calls it.
• Delete removes it, and its address stops working.