FritzBox Numbers

Home-Assistant-Integration, die zeigt, ob die Rufnummern einer FRITZ!Box beim VoIP-Anbieter registriert sind – ein Gerät pro Rufnummer, abgefragt per TR-064. Quelloffen (MIT). Home Assistant integration that shows whether the phone numbers of a FRITZ!Box are registered with their VoIP provider – one device per number, queried via TR-064. Open source (MIT).

Auf GitHub View on GitHub In HACS öffnen Open in HACS

Warum? Why?

Die offizielle FRITZ!Box-Tools-Integration liefert Verbindungsstatus, Bandbreite, Anwesenheit, WLAN-Schalter und Rufumleitungen – aber nicht, ob deine Rufnummern tatsächlich beim Anbieter angemeldet sind. Genau das ist der Moment, in dem das Festnetz still ist und niemand es merkt. FritzBox Numbers fragt den TR-064-Dienst X_VoIP:1 ab und macht den Registrierungsstatus in Home Assistant sichtbar, sodass du Benachrichtigungen und Automationen darauf aufbauen kannst. The official FRITZ!Box Tools integration covers connection state, bandwidth, presence, Wi-Fi switches and call deflections – but not whether your phone numbers are actually registered with the provider. That is exactly when the landline goes silent and nobody notices. FritzBox Numbers queries the TR-064 service X_VoIP:1 and surfaces the registration status in Home Assistant, so you can build notifications and automations on it.

Funktionen Features

Ein Gerät pro Rufnummer unterhalb des FRITZ!Box-Hub-Geräts.
Verbindungs-Binärsensor je Rufnummer – an, solange die Nummer registriert ist.
Status-Sensor je Rufnummer mit dem unveränderten Statustext der Box, als Diagnose-Entität.
Zähler an der Box für registrierte Rufnummern, nicht verbundene Nummern als Attribut.
Robust bei Störungen: Abfrage alle 5 Minuten, letzte Werte bis zu 30 Minuten; einmal gesehene Rufnummern bleiben als Entitäten erhalten.
Re-Authentifizierung über den üblichen Home-Assistant-Dialog, wenn die Zugangsdaten nicht mehr passen. Keine zusätzlichen Python-Abhängigkeiten.

One device per phone number below the FRITZ!Box hub device.
Connectivity binary sensor per number – on while the number is registered.
Status sensor per number carrying the raw status text reported by the box, as a diagnostic entity.
Counter on the box for registered numbers, with unregistered ones listed in an attribute.
Resilient to outages: polled every 5 minutes, last values kept for up to 30 minutes; numbers seen once keep their entities.
Re-authentication through the usual Home Assistant dialog if the credentials stop working. No extra Python dependencies.

Voraussetzungen Requirements

„Zugriff für Anwendungen zulassen“ (TR-064) in der FRITZ!Box unter Heimnetz → Netzwerk → Netzwerkeinstellungen. UPnP-Statusinformationen werden nicht benötigt.
Ein FRITZ!Box-Benutzer mit der Berechtigung „FRITZ!Box Einstellungen“.
Schnelltest: Antwortet http://<box>:49000/tr64desc.xml mit 404, obwohl Port 49000 offen ist, ist TR-064 abgeschaltet.

“Allow access for applications” (TR-064) enabled on the FRITZ!Box under Home Network → Network → Network Settings. UPnP status information is not needed.
A FRITZ!Box user account with the “FRITZ!Box Settings” permission.
Quick check: if http://<box>:49000/tr64desc.xml answers 404 although port 49000 is open, TR-064 is off.

Installation Installation

Über HACS als Custom Repository (Kategorie Integration) hinzufügen, installieren und Home Assistant neu starten. Dann unter Einstellungen → Geräte & Dienste → Integration hinzufügen FritzBox Numbers wählen und Host, Benutzer und Passwort eingeben. Add it in HACS as a custom repository (category Integration), install and restart Home Assistant. Then go to Settings → Devices & services → Add integration, pick FritzBox Numbers and enter host, username and password.

https://github.com/michis0806/ha_fritzbox_numbers

Datenschutz Privacy

Die Integration läuft in deiner eigenen Home-Assistant-Instanz und spricht nur mit deiner FRITZ!Box im lokalen Netz. Zugangsdaten werden von Home Assistant gespeichert; es verlässt nichts dein Heimnetz. Dieses Projekt steht in keiner Verbindung zu AVM. The integration runs inside your own Home Assistant instance and talks only to your FRITZ!Box on the local network. Credentials are stored by Home Assistant; nothing leaves your home network. This project is not affiliated with AVM.