GonoPBX trifft Home Assistant

Wer ein Smart Home mit Home Assistant betreibt, kennt das Gefühl: Am liebsten möchte man alles in einem Dashboard sehen. Licht, Heizung, Kameras – und warum nicht auch die Telefonanlage? Genau das ist ab sofort möglich.

Was kann die Integration?

Die Home Assistant-Integration verbindet GonoPBX über zwei Wege mit deinem Smart Home: eine REST-API für Sensoren und Aktionen, und MQTT für Echtzeit-Events.

Sensoren

GonoPBX stellt folgende Informationen als Home Assistant Sensoren bereit:

• Nebenstellen – Online/Offline-Status jeder Nebenstelle als Binary Sensor
• Trunks – Registrierungsstatus der SIP-Leitungen
• Aktive Anrufe – Anzahl der laufenden Gespräche
• Anrufe heute – Zähler der Anrufe des aktuellen Tages
• Voicemail – Anzahl ungelesener Sprachnachrichten

MQTT-Events

Bei jedem Anruf sendet GonoPBX Events über MQTT. Damit lassen sich Automationen auslösen – zum Beispiel:

• Licht blinken lassen wenn das Telefon klingelt
• TV stumm schalten bei eingehendem Anruf
• Benachrichtigung aufs Handy bei verpasstem Anruf
• Anrufer-Info auf einem Display im Flur anzeigen

Click-to-Call

Über den Originate-Endpoint können Anrufe direkt aus Home Assistant gestartet werden. Das Telefon klingelt zuerst bei dir, und nach dem Abnehmen wird die Zielnummer gewählt. Perfekt für:

• Ein „Anrufen“-Button im HA-Dashboard
• Automatisierte Anrufe bei Alarmen (z.B. Wassersensor)
• Schnellwahl über ein Tablet an der Wand

Einrichtung in 3 Schritten

1. MQTT-Broker eintragen

Unter Einstellungen → Home Assistant in der GonoPBX-Oberfläche den MQTT-Broker konfigurieren. Das ist normalerweise die IP deiner Home Assistant-Instanz mit dem Mosquitto-Add-on.

2. API-Key generieren

Im selben Bereich einen API-Key generieren. Dieser Key wird in Home Assistant für die Authentifizierung verwendet. Einfach auf „Key generieren“ klicken und den Schlüssel kopieren.

3. Home Assistant konfigurieren

In der configuration.yaml von Home Assistant die REST-Sensoren und MQTT-Sensoren einrichten. Eine ausführliche Anleitung mit fertigen YAML-Snippets findest du auf der Integrationsseite.

Sicherheit

Die Kommunikation ist über zwei Mechanismen abgesichert:

• API-Key – Jeder REST-Request muss einen gültigen Key im Header mitsenden. Ohne Key gibt es keinen Zugriff.
• MQTT-Auth – Der MQTT-Broker wird mit Benutzername und Passwort angesprochen, wie in Mosquitto üblich.

Der API-Key kann jederzeit in der GonoPBX-Oberfläche neu generiert werden, falls er kompromittiert wurde.

Beispiel-Automation

Hier ein einfaches Beispiel: Bei eingehendem Anruf das Licht im Flur blinken lassen.

automation:
  - alias: "Telefon klingelt - Licht blinken"
    trigger:
      - platform: mqtt
        topic: "gonopbx/events/call"
    condition:
      - condition: template
        value_template: "{{ trigger.payload_json.event == 'ringing' }}"
    action:
      - service: light.turn_on
        target:
          entity_id: light.flur
        data:
          flash: short