---
title: "Uptime Kuma Telefonanrufe: So klingelt Ihr Handy bei Ausfällen"
description: "Uptime Kuma bietet über 90 Benachrichtigungswege, aber keinen Anruf. So ergänzen Sie Telefonalarme bei Ausfällen mit einem einzigen Webhook."
date: 2026-08-28
author: Nooc
authorAvatarLink: /images/avatars/nooc.webp
authorLink: https://nooc.me
tags:
  - Uptime Kuma
  - Self-Hosted Monitoring
  - Telefonalarme
  - Webhook-Benachrichtigungen
  - Verfügbarkeitsüberwachung
  - Bereitschaftsdienst
---

# Uptime Kuma Telefonanrufe: So klingelt Ihr Handy bei Ausfällen

Uptime Kuma unterstützt über 90 Benachrichtigungsanbieter, aber keiner davon bringt Ihr Telefon zum Klingeln. Um bei einem Ausfall angerufen zu werden, senden Sie die **Webhook**-Benachrichtigung von Uptime Kuma an einen Echobell-Kanal mit dem Benachrichtigungstyp **Anruf**. Dieser Leitfaden zeigt den genauen Custom Body, wie Sie Ausfall- und Wiederherstellungsmeldungen trennen, und die beiden Fehler, die das Setup stillschweigend unbrauchbar machen.

[Uptime Kuma](https://github.com/louislam/uptime-kuma) ist das mit Abstand verbreitetste selbst gehostete Uptime-Monitoring — rund 90.000 GitHub-Sterne, Version 2.5.0 erschien im August 2026. Es prüft HTTP-Endpunkte, TCP-Ports, DNS-Einträge, Docker-Container und mehr, und es erkennt Ausfälle wirklich zuverlässig.

Die Lücke liegt auf der letzten Meile: die Meldung zu einem Menschen zu bringen, der schläft.

## Warum Uptime Kuma Sie nicht selbst anrufen kann

Die Liste der Benachrichtigungswege ist lang — Telegram, Discord, Slack, E-Mail, Gotify, ntfy und Dutzende mehr — aber sie alle liefern eine *Nachricht*. Nachrichten unterliegen dem Klingelschalter Ihres Telefons, „Nicht stören“ und den iOS-Fokusmodi. Um 3 Uhr morgens heißt das: Die Meldung kommt an, und nichts passiert.

Einen hauseigenen Anbieter nach dem Motto „ruf mich an“ gibt es nicht. Die üblichen Auswege sind:

- **Twilio** — Sprachanrufe lassen sich darauf aufbauen, aber der Twilio-Anbieter in Uptime Kuma verschickt SMS. Für Anrufe müssten Sie einen Bridge-Dienst schreiben, eine Nummer kaufen und pro Anruf zahlen.
- **PagerDuty, Zenduty, Spike.sh, Splunk On-Call** — diese rufen tatsächlich an, sind aber vollwertige Incident-Management-Plattformen mit entsprechender Preisgestaltung pro Nutzer. Die richtige Wahl, wenn Sie Rotationen und Eskalationsrichtlinien brauchen; überdimensioniert, wenn nur ein Telefon klingeln soll.
- **SMS-Gateways** — eine SMS bleibt eine Nachricht, und unter iOS durchbricht sie den Fokusmodus nur, wenn der Absender auf Ihrer Ausnahmeliste steht.

Im Uptime-Kuma-Repository ist seit Längerem ein [Feature-Request für VoIP-Anrufe](https://github.com/louislam/uptime-kuma/issues/3812) offen. Bis dahin ist der generische **Webhook**-Anbieter der Ausweg — er kann beliebige Daten an eine beliebige URL senden, und mehr braucht es nicht.

## Voraussetzungen

- Eine laufende Uptime-Kuma-Instanz (dieser Leitfaden bezieht sich auf 2.x; der Custom Body funktioniert auch ab 1.23)
- Echobell installiert ([App Store](https://apps.apple.com/app/apple-store/id6743597198?pt=128151925&ct=blog-uptime-kuma-phone-call-alerts-de&mt=8) / [Google Play](https://play.google.com/store/apps/details?id=one.echobell.echobellandroid))
- Fünf Minuten

Ihre Uptime-Kuma-Instanz braucht ausgehendes HTTPS zu `hook.echobell.one`. Sie muss **nicht** aus dem Internet erreichbar sein — es handelt sich um einen ausgehenden Webhook, also funktioniert auch ein Monitor auf einem Heimserver oder in einem privaten Netz.

## Schritt 1 — Einen Kanal anlegen, der Sie anruft

Legen Sie in Echobell einen Kanal an, etwa `Production Down`. Setzen Sie den Benachrichtigungstyp des Abonnements auf **Anruf**. Genau diese Einstellung ist entscheidend: Anruf-Alarme erscheinen als eingehender Anruf und klingeln durch iOS-Fokusmodi und „Nicht stören“ hindurch — was eine Push-Benachrichtigung nicht tut.

Setzen Sie die Vorlagen auf:

```
Titel: 🔴 {{monitor}} ist ausgefallen
Text: {{message}}
Ziel: {{target}}
```

Kopieren Sie anschließend die **Webhook-URL** des Kanals. Sie sieht so aus:

```
https://hook.echobell.one/t/<channel-token>
```

Behandeln Sie diese URL wie ein Geheimnis — wer sie hat, kann Ihr Telefon klingeln lassen.

## Schritt 2 — Echobell als Webhook-Benachrichtigung eintragen

Gehen Sie in Uptime Kuma zu **Settings → Notifications → Setup Notification** und füllen Sie aus:

| Feld | Wert |
| --- | --- |
| Notification Type | `Webhook` |
| Friendly Name | `Echobell — Down` |
| Post URL | Ihre Echobell-Webhook-URL |
| Request Body | `Custom Body` |

**Additional Headers** bleibt leer.

## Schritt 3 — Ein Payload senden, das sich filtern lässt

Diesen Schritt überspringen die meisten Anleitungen, und er entscheidet darüber, ob Sie ein Alarmsystem oder eine Lärmmaschine bauen.

Fügen Sie Folgendes in **Custom Body** ein:

```json
{
  "monitor": "{{name}}",
  "target": "{{hostnameOrURL}}",
  "message": "{{ msg | strip_newlines }}",
  "up": "{{ heartbeatJSON['status'] }}"
}
```

Uptime Kuma rendert Custom Bodies mit Liquid und stellt diese Variablen bereit:

| Variable | Inhalt |
| --- | --- |
| `{{name}}` | Der Anzeigename des Monitors |
| `{{hostnameOrURL}}` | Der geprüfte Hostname oder die URL |
| `{{status}}` | `🔴 Down`, `✅ Up` oder `⚠️ Test` |
| `{{msg}}` | Der lesbare Grund, z. B. `connect ECONNREFUSED 10.0.0.4:443` |
| `{{ monitorJSON['...'] }}` | Das vollständige Monitor-Objekt |
| `{{ heartbeatJSON['...'] }}` | Das vollständige Heartbeat-Objekt |

Zwei Details in diesem Payload sind Absicht:

**`strip_newlines` auf `msg`.** Die Meldung von Uptime Kuma enthält oft Zeilenumbrüche, und ein roher Zeilenumbruch in einem JSON-String ist ungültiges JSON. Ohne den Filter schlägt Ihr Webhook sporadisch fehl — und zwar nur bei den Fehlern, deren Text zufällig umbricht. Wenn Ihre Uptime-Kuma-Version den Liquid-Filter `json` kennt, ist `"message": {{ msg | json }}` (Achtung: ohne umschließende Anführungszeichen) noch sicherer, weil er auch Anführungszeichen maskiert.

**`heartbeatJSON['status']` statt `{{status}}`.** Die Variable `status` liefert Text mit Emoji, was sich schlecht vergleichen lässt. Der Heartbeat-Status ist dagegen eine schlichte Zahl:

- `0` — ausgefallen
- `1` — erreichbar
- `2` — ausstehend
- `3` — Wartung

Auch die Anführungszeichen (`"up": "{{ ... }}"`) sind wichtig; warum, erklärt Schritt 5.

## Schritt 4 — Keine Anrufe bei der Wiederherstellung

Eine einzelne Uptime-Kuma-Benachrichtigung feuert sowohl beim Ausfall *als auch* bei der Wiederherstellung. Unverändert ruft dieses Setup Sie an, wenn der Dienst kaputtgeht, und ruft erneut an, wenn er sich selbst repariert. Der zweite Anruf ist der, der Menschen beibringt, den ersten zu ignorieren.

Trennen Sie beides über Echobell-**Bedingungen**, die vor jeder Zustellung ausgewertet werden:

**Im Kanal `Production Down`** (Benachrichtigungstyp **Anruf**) setzen Sie die Bedingung:

```
up == "0"
```

**Legen Sie einen zweiten Kanal** namens `Production Recovered` an, setzen Sie seinen Benachrichtigungstyp auf **Normal** und die Bedingung auf:

```
up == "1"
```

Mit den Vorlagen:

```
Titel: ✅ {{monitor}} ist wieder erreichbar
Text: {{message}}
```

Fügen Sie dann in Uptime Kuma eine zweite Webhook-Benachrichtigung hinzu — gleicher Custom Body, gleiche Monitore, nur mit der URL des Wiederherstellungskanals. Beide Benachrichtigungen erhalten alle Ereignisse; jeder Kanal verwirft die Hälfte, die ihn nicht betrifft.

Das Ergebnis: Ausfälle klingeln, Wiederherstellungen kommen als stille Push-Meldung, die Sie morgens lesen.

## Schritt 5 — Den Monitor so einstellen, dass er nicht falschen Alarm schlägt

Ein Anruf, der sich als zwei Sekunden Netzwerkzucken entpuppt, ist schlimmer als gar kein Anruf, weil der nächste ebenfalls weggewischt wird. Drei Einstellungen am Monitor selbst erledigen den Großteil der Arbeit:

- **Retries** — auf `2` oder `3` setzen. Uptime Kuma markiert den Monitor erst nach so vielen aufeinanderfolgenden Fehlversuchen als ausgefallen und filtert damit einzelne verlorene Pakete heraus.
- **Heartbeat Retry Interval** — wie schnell im Fehlerfall erneut geprüft wird. 20 bis 30 Sekunden sind ein guter Kompromiss; zusammen mit 3 Wiederholungen erkennen Sie einen echten Ausfall in etwa einer Minute.
- **Resend Notification if Down X times consecutively** — auf etwa `10` gesetzt ruft Uptime Kuma erneut an, wenn der Dienst nach zehn weiteren Prüfungen immer noch ausgefallen ist. Eine grobe Eskalationsrichtlinie, die aber funktioniert.

Soll ein unbeantworteter Anruf sofort erneut versucht werden statt auf die Wiederholung zu warten, aktivieren Sie in den Echobell-App-Einstellungen **Fehlgeschlagene Anrufe wiederholen**.

## Nur außerhalb der Arbeitszeit klingeln

Tagsüber schauen Sie ohnehin auf ein Dashboard, und ein klingelndes Telefon ist eine Unterbrechung, die Sie nicht brauchten. Mit Echobells Systemzeit-Variablen (alle in UTC) verhält sich ein Kanal je nach Stunde anders:

```
up == "0" && (hour >= 17 || hour < 9)
```

Diese Bedingung ruft Sie nur außerhalb von 09:00–17:00 UTC an. Für tagsüber richten Sie einen zweiten Kanal vom Typ Normal mit der umgekehrten Bedingung ein:

```
up == "0" && hour >= 9 && hour < 17
```

Denken Sie an die Umrechnung in Ihre Zeitzone — diese Variablen werden immer in UTC berechnet. Ausführlicher steht das in [Zeitfenster-Benachrichtigungen mit UTC-Bedingungen](/de/blog/time-window-notifications-using-utc-conditions).

## Den Alarm im Team teilen

Ein Echobell-Kanal lässt sich per Abonnement-Link mit Kolleginnen und Kollegen teilen, und jede Person wählt ihren eigenen Benachrichtigungstyp. Derselbe Monitor kann also das Telefon der diensthabenden Person klingeln lassen und bei allen anderen als normale Push-Meldung ankommen — ohne Preise pro Nutzer und ohne zusätzliche Routing-Regeln in Uptime Kuma.

Das passt auch zur Datenschutzhaltung, aus der heraus Sie überhaupt selbst hosten: Ihre Monitore bleiben auf Ihrer Infrastruktur, und Echobell hält Benachrichtigungsinhalte und -verlauf auf dem Gerät statt auf seinen Servern.

## Was dieses Setup nicht leistet

Die Grenze offen zu benennen erspart Ihnen später eine schlechte Migration. Echobell ist eine Zustellschicht, keine Incident-Management-Plattform. Es bietet nicht:

- Bereitschaftspläne oder Follow-the-Sun-Übergaben
- Eskalationsbäume, die automatisch eine zweite Person alarmieren
- Incident-Zeitleisten, Bestätigungsverfolgung oder Postmortem-Werkzeuge

Braucht Ihr Team das, brauchen Sie PagerDuty, Grafana Cloud IRM oder Vergleichbares. Dieses Setup schließt die konkrete Lücke, die Uptime Kuma offen lässt: einen erkannten Ausfall in ein tatsächlich klingelndes Telefon zu übersetzen. Für Einzelbetreiber, kleine Teams und Homelabs ist das meist die gesamte Anforderung.

## Fehlersuche

**Der Test-Button macht nichts.** Mit dem obigen Payload ist das erwartetes Verhalten, und es verwirrt beim ersten Mal jeden. Beim Klick auf Test gibt es keinen Heartbeat zum Rendern, also wird `{{ heartbeatJSON['status'] }}` zu einem leeren String, und keine der Bedingungen trifft zu. Zum echten Testen legen Sie einen Wegwerf-TCP-Monitor auf einen Port ohne Dienst an (`127.0.0.1:9`) und lassen ihn scheitern.

**Der Webhook schlägt sporadisch fehl.** Fast immer das Zeilenumbruch-Problem — prüfen Sie, ob `msg` durch `strip_newlines` läuft. Es bricht nur bei Fehlermeldungen, die zufällig einen Umbruch enthalten, deshalb wirkt es zufällig.

**Echobell antwortet mit HTTP 200 und `success: false`.** Das Kanal-Token ist falsch oder der Kanal wurde gelöscht. Echobell antwortet auch bei einem unbekannten Token mit gültiger Länge mit `200` — prüfen Sie also den JSON-Body, nicht den Statuscode.

**HTTP 405.** Am Kanal ist **POST Only** aktiv und etwas hat ein GET geschickt. Uptime Kuma sendet per POST, das heißt meist: Sie haben die URL im Browser aufgerufen.

**Es klingelt nicht, aber die Benachrichtigung kommt an.** Der Benachrichtigungstyp des Abonnements ist Normal oder Zeitkritisch statt Anruf. Der Typ wird pro Abonnent gewählt — prüfen Sie ihn also auf dem Gerät, das nicht klingelt.

## Häufige Fragen

### Kann Uptime Kuma von sich aus anrufen?

Nein. Uptime Kuma hat über 90 Benachrichtigungsanbieter, aber alle liefern Nachrichten. Für Anrufe muss ein Webhook an einen Dienst gehen, der telefonieren kann — etwa Echobell — oder Sie nutzen eine kostenpflichtige Incident-Management-Plattform.

### Funktioniert das mit einem selbst gehosteten Uptime Kuma hinter einer Firewall?

Ja. Der Webhook ist eine ausgehende HTTPS-Anfrage Ihrer Uptime-Kuma-Instanz und muss nur `hook.echobell.one` erreichen. Eine öffentliche Adresse braucht die Instanz nicht.

### Durchbricht der Anruf „Nicht stören“?

Ja. Der Echobell-Benachrichtigungstyp Anruf erscheint als eingehender Anruf und klingelt durch iOS-Fokusmodi und „Nicht stören“ hindurch. Details und die beteiligten Einstellungen finden Sie unter [iOS-Fokusmodus für kritische Alarme umgehen](/de/blog/how-to-bypass-ios-focus-mode-for-critical-alerts).

### Wie verhindere ich Anrufe bei der Wiederherstellung?

Nutzen Sie zwei Kanäle mit Bedingungen — `up == "0"` für den Anruf-Kanal und `up == "1"` für einen Wiederherstellungskanal mit normaler Priorität — und richten Sie je eine Webhook-Benachrichtigung darauf. Schritt 4 oben zeigt es im Detail.

### Können mehrere Personen für denselben Monitor angerufen werden?

Ja. Teilen Sie den Kanal mit Ihrem Team; jede abonnierende Person wählt ihren eigenen Benachrichtigungstyp. Alle, die den Anruf-Kanal abonniert haben, werden angerufen.

## Fazit

Das Setup besteht aus einem Webhook, einem Custom Body und zwei Bedingungen. Ihre Uptime-Kuma-Monitore, die Retry-Logik und die Statusseiten bleiben unverändert, und die Lücke zwischen „das Monitoring hat es bemerkt“ und „ein Mensch hat es bemerkt“ schließt sich.

[Echobell fürs iPhone laden](https://apps.apple.com/app/apple-store/id6743597198?pt=128151925&ct=blog-uptime-kuma-phone-call-alerts-de&mt=8) oder [bei Google Play holen](https://play.google.com/store/apps/details?id=one.echobell.echobellandroid), dann zuerst einen unkritischen Monitor anschließen und ihn absichtlich scheitern lassen. Vertrauen Sie dem Weg, bevor Sie sich darauf verlassen.

---

## Verwandte Artikel

- [Uptime-Kuma-Integrationsdokumentation](/de/docs/developer/uptime-kuma)
- [Referenz zu Kanalbedingungen](/de/docs/conditions)
- [Upptime-Alarme mit Echobell](/de/blog/upptime-alerts-with-echobell)
- [Telefonalarme bei API-Ausfällen](/de/blog/phone-call-alerts-api-downtime)
- [Leitfaden gegen Alarmmüdigkeit für Entwickler](/de/blog/fix-alert-fatigue-developer-guide)