Benachrichtigungen einrichten (E-Mail und Webhook)

Lass dich von deiner FRANZFON-Anlage informieren, wenn ein Update bereitsteht oder die FritzBox-Leitung ausfällt: per E-Mail oder Push über ntfy, Gotify und Co.

Ab Version 1.0.0-beta61 kann sich deine FRANZFON-Anlage von selbst melden, wenn etwas Wichtiges passiert. Du findest die Einstellungen im Menü links unter System, Benachrichtigungen.

Bei welchen Ereignissen meldet sich die Anlage?

  • Update verfügbar: Eine neue FRANZFON-Version steht zum Einspielen bereit.
  • Lizenz gesperrt / Lizenz abgelaufen: Der Lizenzstatus deiner Anlage hat sich geändert.
  • FritzBox-Leitung verloren: Die Anlage hat die Verbindung zur FritzBox-Leitung verloren, externe Anrufe sind gestört. Sobald die Leitung wieder da ist, bekommst du eine Entwarnung.

In der Tabelle auf der Seite wählst du pro Ereignis, ob es per E-Mail, per Webhook oder über beide Wege gemeldet wird. Benachrichtigungen enthalten grundsätzlich keine Anruf- oder Personendaten, nur neutrale Systemmeldungen.

Weg 1: E-Mail

Der E-Mail-Versand nutzt die SMTP-Einstellungen deiner Anlage (Menü System, E-Mail). Wenn du dort schon Voicemail-Benachrichtigungen bekommst, ist alles vorbereitet.

  1. Aktiviere den Schalter bei Kanal: E-Mail.
  2. Trag die Empfängeradresse ein.
  3. Klick auf Test-E-Mail senden und prüfe dein Postfach.
  4. Speichern nicht vergessen.

Kommt keine Mail an, prüfe zuerst die SMTP-Einstellungen unter System, E-Mail (dort gibt es ebenfalls einen Test-Button).

Weg 2: Webhook (Push aufs Handy und Integrationen)

Mit dem Webhook schickt die Anlage bei einem Ereignis eine Nachricht an einen Dienst deiner Wahl. Damit bekommst du Meldungen zum Beispiel als Push-Nachricht aufs Handy (ntfy, Gotify), in einen Slack-Kanal oder in dein eigenes Monitoring (Home Assistant, n8n und andere Dienste, die Webhooks annehmen).

Der Webhook-Kanal ist Teil von FRANZFON Pro (in der Testphase enthalten). Der E-Mail-Weg steht jedem zur Verfügung.

Beispiel: Push aufs Handy mit ntfy (kostenlos, in 2 Minuten)

  1. Installiere die ntfy-App auf deinem Handy (App Store oder Play Store).
  2. Abonniere in der App ein eigenes Thema (Topic). Wichtig: Themen auf ntfy.sh sind öffentlich lesbar, wähle den Namen also wie ein Passwort, zum Beispiel “meinefirma-anlage-x7k2m9”.
  3. Wähl in FRANZFON unter Kanal: Webhook die Vorlage ntfy und ersetze im Body-Template DEIN-TOPIC durch dein Thema.
  4. Aktiviere den Schalter, klick auf Test-Webhook senden, und die Nachricht ploppt auf deinem Handy auf.
  5. Speichern.

Beispiel: Gotify (selbst gehostet)

  1. Leg in deinem Gotify eine neue Anwendung an und kopiere das Token.
  2. Wähl in FRANZFON die Vorlage Gotify und ersetze in der URL DEIN-GOTIFY durch die Adresse deines Servers und DEIN-TOKEN durch das Token.
  3. Test senden, speichern, fertig.

Beispiel: Slack

  1. Leg in Slack einen Incoming Webhook an (Slack-Verwaltung, App “Incoming WebHooks”) und kopiere die Webhook-URL.
  2. Wähl in FRANZFON die Vorlage Slack und füge deine URL ein.
  3. Test senden, speichern.

Eigene Dienste

Jeder Dienst, der einen HTTP-POST mit JSON annimmt, funktioniert. Über das Body-Template bestimmst du das Format selbst, mit diesen Platzhaltern: {{titel}}, {{nachricht}}, {{event}}, {{prio}} (Zahl: 3 = Info, 5 = Warnung, 8 = kritisch), {{zeit}} und {{anlage}} (Name deiner Anlage). Braucht dein Dienst einen Schlüssel im Header, trag ihn im Feld Header ein, eine Zeile pro Header, zum Beispiel: Authorization: Bearer dein-token.

Wenn die ganze Anlage offline ist: der Offline-Alarm im Portal

Eine Anlage, die komplett offline ist (Stromausfall, Internetausfall, VM gestoppt), kann sich selbst nicht mehr melden. Dafür gibt es das Gegenstück im FRANZFON Portal: den Offline-Alarm. Das Portal beobachtet die Lebenszeichen, die deine Anlage ihm laufend sendet, und meldet sich per E-Mail, wenn sie verstummen.

So richtest du ihn ein:

  1. Melde dich im Portal an und öffne Mein Profil, Tab Benachrichtigungen.
  2. Setze in der Karte Offline-Alarm den Haken.
  3. Wähle die Karenzzeit (Standard: 15 Minuten). Erst wenn die Anlage länger als diese Zeit keine Verbindung zum Portal hat, geht die Alarm-Mail raus.
  4. Speichern. Die Mails gehen an deine Konto-E-Mail-Adresse.

Sobald sich die Anlage wieder meldet, bekommst du automatisch eine Entwarnung mit der ungefähren Offline-Dauer. Überwacht werden alle deine Anlagen, auch die deiner von dir angelegten Kunden (als Dienstleister bekommst du die Mail mit dem Kundennamen). Zur Einordnung: “Offline” heißt hier nur, dass die Anlage das Portal nicht erreicht. Die Telefonie im lokalen Netz kann davon unabhängig weiterlaufen.

Der Offline-Alarm ist wie der Webhook-Kanal Teil von FRANZFON Pro (in der Testphase enthalten).

Häufige Fragen

Der Test-Webhook schlägt fehl. Prüfe die URL auf Tippfehler und ob der Dienst aus dem Netz deiner Anlage erreichbar ist. Die Fehlermeldung im Test zeigt dir die Antwort des Dienstes.

Ich habe Header gespeichert, sehe aber nur Sternchen. Das ist Absicht: Schlüssel werden nach dem Speichern maskiert angezeigt. Lässt du die Sternchen beim erneuten Speichern stehen, bleiben deine gespeicherten Header unverändert erhalten.

Was passiert mit meiner Webhook-Einrichtung, wenn meine Pro-Lizenz ausläuft? Der Versand pausiert, deine Konfiguration bleibt aber gespeichert. Nach einem Upgrade läuft sie sofort wieder, ohne Neueinrichtung.

Meldet die Anlage auch, wenn sie komplett offline ist? Das kann sie selbst nicht (offline ist offline). Genau dafür gibt es den Offline-Alarm im Portal, siehe den Abschnitt direkt über diesen Fragen.

Zuletzt aktualisiert: · Autor: IAP-IT, Viktor Weizel

Artikel hat nicht geholfen? Schreib uns.