SIP voice calls (Asterisk) Smart-Home-Integration, kostenlos und Open Source

Rufe aus einer Szene ein Telefon an und spiele eine Nachricht ab; reagiere auf Anrufe (Asterisk).
Rufe aus einer Gladys-Szene ein Telefon an und spiele ihm eine Nachricht ab (Alarm, Wasserleck, offene Tür), und reagiere auf eingehende Anrufe (das Tor öffnen, wenn eine bekannte Nummer anruft). Die Integration steuert dein eigenes Asterisk oder FreePBX über ARI, die REST-Schnittstelle von Asterisk: Sie spricht nie selbst SIP, das übernimmt dein Telefonserver.
Ohne Anbieterleitung entwickelt: getestet mit Asterisk 23.5 in Docker und simulierten Telefonen. Rückmeldungen sind willkommen.
Was du bekommst
- Eine Szenenaktion „Anrufen und Nachricht abspielen“: ruft eine erlaubte Nummer an, spielt die Nachricht ein- oder mehrmals ab und ruft erneut an, wenn niemand abnimmt. Optional gilt der Anruf erst als bestätigt, wenn jemand 1 drückt: Bis dahin ruft die Integration weiter an (bis zur Zahl der Versuche).
- Eine Szenenaktion „Anrufe stoppen“: legt auf und bricht die Wiederholungen ab (Fehlalarm).
- Ein Auslöser „Eingehender Anruf“, gefiltert nach Nummer des Anrufers und angerufener Nummer, mit Nummer und Name des Anrufers als Variablen.
- Ein Auslöser „Ausgehender Anruf beendet“, gefiltert nach Nummer und Ergebnis (bestätigt, angenommen, keine Antwort, besetzt, fehlgeschlagen, abgebrochen).
- Ein Gerät Asterisk-Server: Server erreichbar, letzter eingehender Anruf, letzter ausgehender Anruf.
- Ein Dashboard-Widget Telefonanrufe.
Voraussetzungen: Asterisk
-
Aktiviere den HTTP-Server in
/etc/asterisk/http.conf:[general]enabled=yesbindaddr=0.0.0.0bindport=8088 -
Lege einen ARI-Benutzer in
/etc/asterisk/ari.confan (wähle ein langes Passwort):[general]enabled=yes[gladys]type=userread_only=nopassword=ein-langes-zufaelliges-passwort -
Nimm deine Nachrichten auf. Eine Nachricht besteht aus einem oder mehreren Asterisk-Sounds: Lege
alarm.wav(8 kHz mono) in/var/lib/asterisk/sounds/de/custom/ab und verwendecustom/alarm. Die Mediendigits:1234,number:42undtone:ringfunktionieren auch. -
Für eingehende Anrufe leitest du die Anrufe im Kontext des Anbieter-Trunks in
extensions.confan die Integration, bevor deine Telefone klingeln:[from-trunk]exten => _X.,1,Stasis(gladys)same => n,Dial(PJSIP/100,30)Ist die Integration gestoppt, schlägt
Stasis()sofort fehl und der Anruf geht weiter: Deine Telefone klingeln trotzdem. -
Ausgehende Anrufe laufen über den Trunk deines Anbieters: Der Wählstring
PJSIP/{number}@mein-trunkruft über den PJSIP-Endpunktmein-trunkan. Führe nach diesen Änderungencore reloadaus.
Voraussetzungen: FreePBX
-
Settings → Asterisk REST Interface Users: Füge einen Benutzer hinzu (Lesen/Schreiben) und notiere sein Passwort. Prüfe unter Settings → Advanced Settings, dass der eingebaute HTTP-Server von Asterisk aktiv ist (Port 8088).
-
Admin → System Recordings: Nimm die Nachrichten auf oder lade sie hoch; eine Aufnahme namens
alarmist der Soundcustom/alarm. -
Wählstring:
Local/{number}@from-internal, damit die ausgehenden Routen von FreePBX den Trunk wählen. -
Eingehende Anrufe: Füge in
extensions_custom.confeinen Kontext hinzu, der über Stasis und dann zu deiner eingehenden Route führt, und lass eine Custom Destination oder den Trunk-Kontext darauf zeigen:[gladys-incoming]exten => _X.,1,Stasis(gladys)same => n,Goto(from-trunk,${EXTEN},1)
Konfiguration
| Feld | Verwendung |
|---|---|
| ARI-Adresse | http://<Adresse des Servers>:8088 |
| Benutzer, Passwort | Der Benutzer aus ari.conf oder aus FreePBX |
| Stasis-Anwendung | Standardmäßig gladys: der Name in Stasis(gladys) |
| Erlaubte Nummern | Die einzigen Nummern, die Szenen anrufen dürfen, durch Kommas getrennt |
| Wählstring | {number} wird durch die angerufene Nummer ersetzt |
| Anrufer-ID | Wird auf dem angerufenen Telefon angezeigt, z. B. Gladys <100> (der Anbieter kann sie ersetzen) |
| Eingehende Anrufe | Im Wählplan weiter (Telefone klingeln) oder auflegen, ohne abzunehmen (kostenlos für den Anrufer) |
| Sprache der Texte | Sprache der Funktionsnamen und der Anrufergebnisse |
Verbindung testen prüft Adresse und Benutzer. Testanruf führt einen Anruf aus (ein Versuch, eine Wiedergabe).
Szenen
- Alarm per Telefon: Auslöser „Alarm ausgelöst“ → Aktion „Anrufen und Nachricht abspielen“, Nummer
+4915112345678, Nachrichtcustom/alarm, 3 Wiedergaben, 5 Versuche, 60 s zwischen den Versuchen, „Auf Taste 1 warten“ aktiviert. - Fehlalarm: Auslöser „Alarm deaktiviert“ → Aktion „Anrufe stoppen“.
- Tor per Telefon: Auslöser „Eingehender Anruf“, Nummer des Anrufers
+4915112345678→ Tor öffnen. Im Modus „Auflegen, ohne abzunehmen“ kostet der Anruf den Anrufer nichts. - Niemand hat bestätigt: Auslöser „Ausgehender Anruf beendet“, Ergebnis „Keine Antwort“ → einer anderen Person eine Nachricht senden.
Die Szenenaktion kehrt sofort zurück (ein Anruf mit Wiederholungen dauert länger, als eine Szenenaktion darf): Das Ergebnis kommt über den Auslöser „Ausgehender Anruf beendet“ und die Funktion „Letzter ausgehender Anruf“. Die Nummer wird wie in den erlaubten Nummern geschrieben; Leerzeichen, Punkte und Bindestriche werden ignoriert. Ein zweiter Anruf an eine Nummer, die gerade angerufen wird, wird nicht ausgeführt.
Die Nummer des Anrufers im Auslöser „Eingehender Anruf“ wird unverändert verglichen: Gib sie genau so ein, wie die
Funktion „Letzter eingehender Anruf“ sie anzeigt, ohne den Namen in Klammern (Anbieter senden oft +4915112345678 oder 4915112345678).
Dashboard
Das Widget Telefonanrufe zeigt die Verbindung zu Asterisk, die laufenden Anrufe, die Uhrzeit des letzten eingehenden und ausgehenden Anrufs mit Ergebnis und, während eines Anrufs, eine Taste zum Stoppen der Anrufe (in den Widget-Einstellungen ausblendbar).
Grenzen
- Keine Sprachsynthese: Asterisk spielt aufgenommene Sounds ab. Nimm deine Nachrichten einmal auf (System Recordings von FreePBX oder ein TTS-Werkzeug auf deinem Computer).
- Nur die erlaubten Nummern können angerufen werden. Füge nie kostenpflichtige Sondernummern hinzu: Eine Szene könnte sie in Schleife anrufen.
- Die Nummer des Anrufers kann gefälscht werden: Verwende sie nicht allein, um eine Tür zu öffnen oder einen Alarm zu deaktivieren.
- Anrufe, die beim Neustart von Asterisk oder bei einem Verbindungsabbruch laufen, enden als fehlgeschlagen; beim Neustart der Integration selbst gehen sie verloren (kein Auslöser).
- Nur die an
Stasis(gladys)geleiteten Anrufe werden gesehen. - Ohne die Hardware entwickelt: Für die Tests wurde keine echte Anbieterleitung verwendet, nur Asterisk 23.5 mit simulierten Telefonen. Rückmeldungen sind willkommen.
Fehlerbehebung
- „Asterisk antwortet nicht“: Prüfe Adresse und Port,
http show statusin der Asterisk-Konsole und ob der Gladys-Rechner Port 8088 erreicht. - „Asterisk lehnt den ARI-Benutzer ab“: Prüfe
ari.conf(oder den ARI-Benutzer von FreePBX) und führemodule reload res_ari.soaus. - Sofort „fehlgeschlagen“: Der Wählstring ist falsch (
pjsip show endpoints), oder der Trunk lehnt den Anruf ab: Die Asterisk-Konsole sagt, warum. - Die Nachricht bleibt stumm: Der Sound existiert nicht; prüfe
core show file formatsund den Pfad untersounds/<Sprache>/. - Kein Auslöser bei eingehendem Anruf: Der Wählplan erreicht
Stasis(gladys)nicht, oder der Name der Anwendung weicht von der Konfiguration ab.
Konfigurationseinstellungen
Diese Einstellungen fragt SIP voice calls (Asterisk) in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Asterisk-Server | section | Nein | Die Integration steuert dein eigenes Asterisk oder FreePBX über ARI (Asterisk REST Interface). Lege zuerst einen ARI-Benutzer an: Die Dokumentation zeigt jeden Schritt. |
| ARI-Adresse | string | Ja | Adresse des HTTP-Servers von Asterisk (http.conf), mit Port. |
| ARI-Benutzer | string | Ja | |
| ARI-Passwort | secret | Ja | |
| Stasis-Anwendung | string | Nein | Name im Wählplan: Stasis(gladys). |
| Anrufe | section | Nein | Nur die erlaubten Nummern können angerufen werden. Füge nie kostenpflichtige Sondernummern hinzu: Eine Szene könnte sie in Schleife anrufen. |
| Erlaubte Nummern | string | Nein | Nummern, die Szenen anrufen dürfen, durch Kommas getrennt, so geschrieben, wie du sie wählst. |
| Wählstring | string | Nein | Anzurufender Kanal, {number} wird ersetzt: PJSIP/{number}@mein-trunk für den Trunk des Anbieters, PJSIP/{number} für ein lokales Telefon, Local/{number}@from-internal bei FreePBX. |
| Anrufer-ID | string | Nein | Wird auf dem angerufenen Telefon angezeigt; der Anbieter kann sie ersetzen. |
| Eingehende Anrufe | select | Nein | Was mit einem an Stasis gesendeten Anruf passiert, nachdem Gladys ihn gesehen hat. |
| Sprache der Texte | select | Nein | Sprache der Funktionsnamen und der Anrufergebnisse. |
So installierst du SIP voice calls (Asterisk) in Gladys
- Öffne in Gladys Integrationen: SIP voice calls (Asterisk) erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-sip:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-sip.
SIP voice calls (Asterisk) benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
SIP voice calls (Asterisk) ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation