infra-struktur AdminWiki 2.10 - Benutzerbeiträge [de]

Placetel Schnittstelle

2024-03-07T08:32:43Z

Frank:

<pre style="color: red">
Achtung!! Placetel stellt die API-Version im Januar 2022 um. Es ändert sich nur die URL. Die Änderung bitte beachten.
</pre>
Um einen Placetel-Anschluss in infra-struktur zu integrieren müssen sie folgendes tun. 

* Für die Einrichtung der Wählhilfe

In der Administration Wählhilfe verwenden sie die Option [[cURL /w POST]] 
Die in das Feld einzutragende URL sieht in dem Fall dann so aus: 
https://api.placetel.de/v2/calls?api_key=APIKEY_den_sie_von_Placetel_bekommen&target=#NUM#&sipuid=#MSN# 
Als MSN trägt der Benutzer dann seine SipUID eine. Diese sieht z.B. so aus: 123456789@fpbx.de
 
* APIKEY erstellen
Auf der Placetel-Seite unter AppStore zur Web API gehen (oder https://web.placetel.de/integrations/web_api). 
Dort auf die Schaltfläche "Neuen API-Token erstellen" klicken.
Links der Schaltfläche wird der API Token dann dargestellt. 
Wenn man mir dem Mauszeiger darauf fährt kann man den Token mit Klick der linken Maustaste kopieren. 
<pre style="color: red">Achtung!</pre>
Dieser Schlüssel ist nur einmalig sichtbar und muss von Ihnen sicher verwahrt werden.
Es ist nicht möglich, diesen Schlüssel erneut anzuzeigen. 
Falls dieser Schlüssel verloren geht, so muss er neu generiert werden.
 
 
* Für die Einrichtung der eingehende Signale

Hierzu wird folgendes Script benötigt daß sie auf einem Server der SSL-Verschlüsselung unterstützt ablegen und erreichbar machen müssen.
 
Sollten sie über keinen Server mit Zertifikat verfügen, sprechen sie uns an. 
[https://info.infra-struktur.de/unterlagen/placetel.zip placetel.zip] 
1.Das Script sollten sie auf einem Server mit gültigem Zertifikat hosten. Bei bedarf wenden sie sich an NETZkultur bezüglich der Bereitstellung 
2.Das Script wird aufgerufen mit den Parametern instanz,isdnkey und standort als GET-Parameter. 
Also:
<code>https://ihredomain.de/pfadzumscript/placetel.php?instanz=demo&isdnkey=12345&standort=placetel</code> 
Den Parameter "isdnkey" Finden Sie in der infra-struktur unter "Administration" - "Anrufliste" im Reiter "Anrufliste" im Punkt 
"Allgemein" im Feld "API-Call-Key". 
3.Im Placetel auf den Bereich AppStore gehen und dort die kostenlose Notify API buchen / auswählen. 
 
[[Datei:Placetel-Api-Schritt1.jpg|700px]]
 
4.Dort den Bereich "API" auswählen oder über die Suche nach "Notify API" suchen 
5.Piktogramm der "Notify API" anklicken. 
6.Die Checkbox "Call Control-/Notify-API aktivieren " aktivieren. 
7.Die genaue URL des Skriptes unter 2. im Feld "URL Ihres API-Endpoints" hinterlegen. 
8.Die Telefonnummern aktivieren, für die die API zugreifen soll. 
9.Mit "Eigenen API-Endpoint speichern" bestätigen. 
[[Datei:Placetel-Api-Schritt2.jpg|700px]]

Placetel Schnittstelle

2024-03-07T08:24:48Z

Frank:

<pre style="color: red">
Achtung!! Placetel stellt die API-Version im Januar 2022 um. Es ändert sich nur die URL. Die Änderung bitte beachten.
</pre>
Um einen Placetel-Anschluss in infra-struktur zu integrieren müssen sie folgendes tun. 

* Für die Einrichtung der Wählhilfe

In der Administration Wählhilfe verwenden sie die Option [[cURL /w POST]] 
Die in das Feld einzutragende URL sieht in dem Fall dann so aus: 
https://api.placetel.de/v2/calls?api_key=APIKEY_den_sie_von_Placetel_bekommen&target=#NUM#&sipuid=#MSN# 
Als MSN trägt der Benutzer dann seine SipUID eine. Diese sieht z.B. so aus: 123456789@fpbx.de
 
* APIKEY erstellen
Auf der Placetel-Seite unter AppStore zur Web API gehen (oder https://web.placetel.de/integrations/web_api). 
Dort auf die Schaltfläche "Neuen API-Token erstellen" klicken.
Links der Schaltfläche wird der API Token dann dargestellt. 
Wenn man mir dem Mauszeiger darauf fährt kann man den Token mit Klick der linken Maustaste kopieren. 
<pre style="color: red">Achtung!</pre>
Dieser Schlüssel ist nur einmalig sichtbar und muss von Ihnen sicher verwahrt werden.
Es ist nicht möglich, diesen Schlüssel erneut anzuzeigen. 
Falls dieser Schlüssel verloren geht, so muss er neu generiert werden.
 
 
* Für die Einrichtung der eingehende Signale

Hierzu wird folgendes Script benötigt daß sie auf einem Server der SSL-Verschlüsselung unterstützt ablegen und erreichbar machen müssen.
 
Sollten sie über keinen Server mit Zertifikat verfügen, sprechen sie uns an. 
[https://info.infra-struktur.de/unterlagen/placetel.zip placetel.zip] 
1.Das Script sollten sie auf einem Server mit gültigem Zertifikat hosten. Bei bedarf wenden sie sich an NETZkultur bezüglich der Bereitstellung 
2.Das Script wird aufgerufen mit den Parametern instanz,isdnkey und standort als GET-Parameter. 
Also:
<code>https://ihredomain.de/pfadzumscript/placetel.php?instanz=demo&isdnkey=12345&standort=placetel</code> 
3.Im Placetel auf den Bereich AppStore gehen und dort die kostenlose Notify Api buchen / auswählen. 
 
[[Datei:Placetel-Api-Schritt1.jpg|700px]]
 
4.Dort den Bereich "API" auswählen oder über die Suche nach "Notify API" suchen 
5.Piktogramm der "Notify API" anklicken. 
6.Die Checkbox "Call Control-/Notify-API aktivieren " aktivieren. 
7.Die genaue URL des Skriptes unter 2. im Feld "URL Ihres API-Endpoints" hinterlegen. 
8.Die Telefonnummern aktivieren, für die die API zugreifen soll. 
9.Mit "Eigenen API-Endpoint speichern" bestätigen. 
[[Datei:Placetel-Api-Schritt2.jpg|700px]]

JAnrufmonitor

2024-01-23T13:12:22Z

Frank:

Der jAnrufmonitor ist eine Software, die zusammen mit einer FRITZ!Box ermöglicht eingehende Anrufe in die infra-struktur zu einzutragen.

Ausgehende Gespräche können über den jAnrufmonitor nicht initiiert werden.

In diesem Beitrag wird Schritt für Schritt beschrieben, wie der jAnrufmonitor für die Signalisierung von Anrufen in die infra-struktur eingerichtet wird.

Somit richtet sich dieser Beitrag an alle Kunden, die keine Telefonanlage besitzen, bzw. dessen Telefonanlage kein 3rd-Party-TAPI-Treiber bereitstellt.

= Hardware Voraussetzungen =

'''1. FRITZ!Box, die alle eingehenden Anrufe erkennt.'''

Eine Liste aller unterstützten FRITZ!Boxen befindet sich unter folgendem Link.

[https://www.janrufmonitor.de/fuer-avm-fritzbox/ jAnrufmonitor - Unterstützte FRITZ!Box]

'''2. Einen Windows Server/Client auf dem der jAnrufmonitor installiert werden kann.'''

Grundsätzlich ist der jAnrufmonitor mit jedem Server bzw. Client kompatibel, solange auf diesen ein Windows Betriebssystem installiert ist.

Wir empfehlen bei Client-PCs mindestens "Windows-7" und bei einem Server mindestens "Windows Server 2008".

Zusätzlich sollte darauf geachtet werden, dass es sich bei dem verwendeten PC nicht um einen Arbeits-PC handelt, der von einem Mitarbeiter zum Arbeiten verwendet wird.

= Download der Installationsdateien =

Es stehen zwei verschiedene Versionen des jAnrufmonitors zum Download bereit.

Sie unterscheiden sich an der Prozessorarchitektur der verwendeten Windows-Maschine.

[https://info.infra-struktur.de/unterlagen/NETZkultur_jAnrufmonitor-x86.zip Download NETZkultur_jAnrufmonitor 32-Bit]

[https://info.infra-struktur.de/unterlagen/NETZkultur_jAnrufmonitor-x64.zip Download NETZkultur_jAnrufmonitor 64-Bit]

= Installation und Einrichtung =

'''1.Java Runtime Environment installieren'''

Die Installationsdatei liegt in der ZIP-Datei vor.

Bei Bedarf kann auch eine neuere Version von Java verwendet werden.

Wir können in dem Fall nicht garantieren, dass der jAnrufmonitor noch Problemlos funktioniert, da wir nicht jede Java-Version testen können.

Grundsätzlich sollten dadurch aber keine Probleme auftreten.

Wichtig:

Es muss zwingend darauf geachtet werden, dass die korrekte Bit-Variante (x86, x64) von Java verwendet wird.
Da PHP mit 32 Bit arbeitet sollte die 32 Bit-Variante verwendet werden,

'''2. jAnrufmonitor installieren'''

Die Installationsdatei "jam50-winXX.exe" liegt vor.

Es muss darauf geachtet werden, dass als Installationstyp "jAnrufmonitor für eine AVM FRITZ!BoxFon" ausgewählt wird.

Ansonsten muss nur auf den Button "weiter" geklickt werden.

'''3. Kopieren des Ordners „NETZkultur“'''

Damit die Anrufe später vom jAnrufmonitor an die infra-struktur übergeben werden können, muss der Ordner "NETZkultur" aus der ZIP-Datei direkt unter C: kopiert werden.

Somit sollte sich im Verzeichnis „C:\NETZkultur“ ein Ordner namens „jAnrufmonitor-Call“ befinden.

'''4. Grundeinrichtung des jAnrufmonitors'''

Den jAnrufmonior starten und einfach immer nur den Button "next" klicken.

Beim Rufnummernformat das "Kanonische Rufnummernformat" auswählen und sonst keine weiteren Einstellungen vornehmen.

Zum Ende wird mit dem Schalter „Finish“ bestätigt wodurch ein ein neues Icon hinten in der Taskleiste auftaucht.

'''5. Aktivieren der Expertenansicht'''

Zuerst müssen die Einstellungen des jAnrufmonitors geöffnet werden

Dies wird per Rechtsklick auf das Icon und einem folgenden Klick auf „Administration -> Einstellungen“ durchgeführt.

[[Datei:JAnrufmonitor-Einstellungen-oeffnen.png]]

Unten in diesen Einstellungen gibt es die Expertenansicht.

Dort wird der Haken "Expertenansicht aktivieren" ausgewählt und auf "OK" geklickt.

'''6. Plugin "Erweiterung zum Starten von Anwendungen" laden'''

Mit dem "Module-Manager" können benötigte Erweiterungen geladen werden.

Dieser befindet sich unter den Einstellungen, die wie im vorherigen Schritt beschrieben geöffnet werden können.

Nun wird über einen Klick auf den Button "Browse", das benötigte Plugin „mod-srv-extapp.3.0.3.jam.zip“ ausgewählt und der Vorgang mit dem Button „Installieren“ bestätigt.

'''7. Einspielen der Standardkonfiguration'''

Nun muss im Module Manager noch die Konfiguration geladen werden.

Hierfür wird die Datei "cfg.jAnrumonitor.jam.zip" geladen und per Klick auf „installieren“ und danach auf „OK“ bestätigt.

Der jAnrufmonitor beendet sich nun einmal komplett.

'''7b. Standardkonfiguration prüfen'''

[[Datei:JAM_Platzhalter_ohne_Leerzeichen.png]]

Achtung:

Das Pop-Up auf dem Rechner, wo jAnrufmonitor installiert ist, sagt "falsches Rufnummernformat" => solange das in der infra-struktur richtig angezeigt wird bitte ignorieren!

'''8. Verbindung des jAnrufmonitors mit der FRITZ!Box'''

'''Wichtig'''

Die Voraussetzung, dass der jAnrufmonitor eine Verbindung zur FRITZ!Box aufnehmen kann, ist dass die Funktion „Überwachung von Port 1012“ freigeschaltet ist.

Diese Funktion kann wie in folgender Anleitung beschrieben aktiviert werden.

[https://www.janrufmonitor.de/ueberwachung-freischalten/ FRITZ!BOX Überwachung freischalten]

'''Achtung'''

Wenn die Fritz!Box nicht von einem Provider kommt, sondern direkt aus dem freien Handel muss die Fritz!Box eventuell

noch vorbereitet werden. Siehe dazu:

[https://www.janrufmonitor.de/fritzbox-vorbereiten/ FRITZ!BOX vorbereiten]

Die nächsten Konfigurationen werden, nach dem Start des jAnrufmonitors, wieder in den Einstellungen vorgenommen.

Etwaige Fehlermeldungen und Passwort-Anfragen, können weggeklickt werden.

Die Einstellungen unter dem Punkt "AVM FRITZ!Box Fon-Einstellungen" müssen wie folgt konfiguriert werden.

Ab Fritz!OS 7.27 muss die Anmeldung an der Fritz!Box über Benutzername und Passwort erfolgen.
Eventuell muss man dazu in der Fritz!Box noch einen Benutzer anlegen.

[[Datei:FritzboxVerbindung.png]]

Bei Eingabe der korrekten Daten, wird eine Verbindung zur FRITZ!Box hergestellt, nachdem der jAnrufmonitor einmal beendet und neu gestartet wurde.

In dem Fall wird dann in den Einstellungen zum Beispiel das genaue Modell, der Firmware Stand und die Seriennummer der FRITZ!Box angezeigt.

'''9. Vorwahl in den Einstellungen setzen'''

Zum Abschluss ist es noch notwendig, dass in den Einstellungen des jAnrufmonitors unter „Grundeinstellungen“ noch die Ortskennzahl inkl. führender 0 eingetragen wird.

'''10. MSN, Standort und Instanz in der Config setzen'''

Die Konfigurationsdatei befindet sich unter folgendem Pfad.

C:\NETZkultur\jAnrufmonitor-Call\config.txt

Der Name der Instanz muss nur in Kurzform angegeben werden.

Also nur „demo“ anstelle von „demo.infra-struktur.eu“.

Weitere Infos hierzu finden Sie in folgenden Kapiteln:

'''Kapitel: [[Anrufverwaltung]]'''

'''Kapitel: [[Allgemeinverwaltung]]'''

'''11. Automatischen Start des jAnrufmonitors beim Start des Servers in der Aufgabenplanung des Servers setzen'''

Zuerst muss die Aufgabenplanung in Windows geöffnet werden.

Danach wird die Konfigurationsdatei "Aufgabe_Start-jAnrufmonitor.xml" über die Funktion "Aufgabe importieren" rechts im Menü geladen.

Vor dem Speichern muss darauf geachtet werden, dass die Aufgabe mit einem gültigen Windows-Benutzer, wenn möglich dem Administrator, ausgeführt wird.

[[Datei:Aufgabenplanung.png]]

Durch klicken auf „OK“ wird die Aufgabe angelegt und der jAnrufmonitor bei jedem Start des Servers direkt gestartet.

'''12.Abschluss und weitere Infos'''

Hiermit ist die Konfiguration des jAnrufmonitors abgeschlossen.

Im Verzeichnis „C:\NETZkultur\jAnrufmonitor-Call“ befindet sich eine nützliche Log-Datei namens „calls.log“ in der alle an die infra-struktur übergebenen Anrufe aufgeführt werden.

Wenn die Anrufe nicht an die infra-struktur übergeben werden, kann der Fehler idr. über diese Log-Datei nachvollzogen werden.

= Annahme der Anrufe in der infra-stuktur =

Zum Abschluss fehlt nun nur noch die Konfiguration der MSNs, in der infra-struktur Administration unter Anrufliste.

Diese wird wie in folgendem Kapitel beschrieben eingerichtet.

'''Kapitel: [[Anrufverwaltung]]'''

Die MSNs, die dort benötigt werden, können Sie aus der Fritzbox unter eigene Rufnummern auslesen.

Zum Beispiel wird bii einem Telekom-VOIP Anschluss, idr. die gesamten Telefonnummer (02941272630) verwendet.

JAnrufmonitor

2024-01-23T13:07:17Z

Frank:

Der jAnrufmonitor ist eine Software, die zusammen mit einer FRITZ!Box ermöglicht eingehende Anrufe in die infra-struktur zu einzutragen.

Ausgehende Gespräche können über den jAnrufmonitor nicht initiiert werden.

In diesem Beitrag wird Schritt für Schritt beschrieben, wie der jAnrufmonitor für die Signalisierung von Anrufen in die infra-struktur eingerichtet wird.

Somit richtet sich dieser Beitrag an alle Kunden, die keine Telefonanlage besitzen, bzw. dessen Telefonanlage kein 3rd-Party-TAPI-Treiber bereitstellt.

= Hardware Voraussetzungen =

'''1. FRITZ!Box, die alle eingehenden Anrufe erkennt.'''

Eine Liste aller unterstützten FRITZ!Boxen befindet sich unter folgendem Link.

[https://www.janrufmonitor.de/fuer-avm-fritzbox/ jAnrufmonitor - Unterstützte FRITZ!Box]

'''2. Einen Windows Server/Client auf dem der jAnrufmonitor installiert werden kann.'''

Grundsätzlich ist der jAnrufmonitor mit jedem Server bzw. Client kompatibel, solange auf diesen ein Windows Betriebssystem installiert ist.

Wir empfehlen bei Client-PCs mindestens "Windows-7" und bei einem Server mindestens "Windows Server 2008".

Zusätzlich sollte darauf geachtet werden, dass es sich bei dem verwendeten PC nicht um einen Arbeits-PC handelt, der von einem Mitarbeiter zum Arbeiten verwendet wird.

= Download der Installationsdateien =

Es stehen zwei verschiedene Versionen des jAnrufmonitors zum Download bereit.

Sie unterscheiden sich an der Prozessorarchitektur der verwendeten Windows-Maschine.

[https://info.infra-struktur.de/unterlagen/NETZkultur_jAnrufmonitor-x86.zip Download NETZkultur_jAnrufmonitor 32-Bit]

[https://info.infra-struktur.de/unterlagen/NETZkultur_jAnrufmonitor-x64.zip Download NETZkultur_jAnrufmonitor 64-Bit]

= Installation und Einrichtung =

'''1.Java Runtime Environment installieren'''

Die Installationsdatei liegt in der ZIP-Datei vor.

Bei Bedarf kann auch eine neuere Version von Java verwendet werden.

Wir können in dem Fall nicht garantieren, dass der jAnrufmonitor noch Problemlos funktioniert, da wir nicht jede Java-Version testen können.

Grundsätzlich sollten dadurch aber keine Probleme auftreten.

Wichtig:

Es muss zwingend darauf geachtet werden, dass die korrekte Bit-Variante (x86, x64) von Java verwendet wird.

'''2. jAnrufmonitor installieren'''

Die Installationsdatei "jam50-winXX.exe" liegt vor.

Es muss darauf geachtet werden, dass als Installationstyp "jAnrufmonitor für eine AVM FRITZ!BoxFon" ausgewählt wird.

Ansonsten muss nur auf den Button "weiter" geklickt werden.

'''3. Kopieren des Ordners „NETZkultur“'''

Damit die Anrufe später vom jAnrufmonitor an die infra-struktur übergeben werden können, muss der Ordner "NETZkultur" aus der ZIP-Datei direkt unter C: kopiert werden.

Somit sollte sich im Verzeichnis „C:\NETZkultur“ ein Ordner namens „jAnrufmonitor-Call“ befinden.

'''4. Grundeinrichtung des jAnrufmonitors'''

Den jAnrufmonior starten und einfach immer nur den Button "next" klicken.

Beim Rufnummernformat das "Kanonische Rufnummernformat" auswählen und sonst keine weiteren Einstellungen vornehmen.

Zum Ende wird mit dem Schalter „Finish“ bestätigt wodurch ein ein neues Icon hinten in der Taskleiste auftaucht.

'''5. Aktivieren der Expertenansicht'''

Zuerst müssen die Einstellungen des jAnrufmonitors geöffnet werden

Dies wird per Rechtsklick auf das Icon und einem folgenden Klick auf „Administration -> Einstellungen“ durchgeführt.

[[Datei:JAnrufmonitor-Einstellungen-oeffnen.png]]

Unten in diesen Einstellungen gibt es die Expertenansicht.

Dort wird der Haken "Expertenansicht aktivieren" ausgewählt und auf "OK" geklickt.

'''6. Plugin "Erweiterung zum Starten von Anwendungen" laden'''

Mit dem "Module-Manager" können benötigte Erweiterungen geladen werden.

Dieser befindet sich unter den Einstellungen, die wie im vorherigen Schritt beschrieben geöffnet werden können.

Nun wird über einen Klick auf den Button "Browse", das benötigte Plugin „mod-srv-extapp.3.0.3.jam.zip“ ausgewählt und der Vorgang mit dem Button „Installieren“ bestätigt.

'''7. Einspielen der Standardkonfiguration'''

Nun muss im Module Manager noch die Konfiguration geladen werden.

Hierfür wird die Datei "cfg.jAnrumonitor.jam.zip" geladen und per Klick auf „installieren“ und danach auf „OK“ bestätigt.

Der jAnrufmonitor beendet sich nun einmal komplett.

'''7b. Standardkonfiguration prüfen'''

[[Datei:JAM_Platzhalter_ohne_Leerzeichen.png]]

Achtung:

Das Pop-Up auf dem Rechner, wo jAnrufmonitor installiert ist, sagt "falsches Rufnummernformat" => solange das in der infra-struktur richtig angezeigt wird bitte ignorieren!

'''8. Verbindung des jAnrufmonitors mit der FRITZ!Box'''

'''Wichtig'''

Die Voraussetzung, dass der jAnrufmonitor eine Verbindung zur FRITZ!Box aufnehmen kann, ist dass die Funktion „Überwachung von Port 1012“ freigeschaltet ist.

Diese Funktion kann wie in folgender Anleitung beschrieben aktiviert werden.

[https://www.janrufmonitor.de/ueberwachung-freischalten/ FRITZ!BOX Überwachung freischalten]

'''Achtung'''

Wenn die Fritz!Box nicht von einem Provider kommt, sondern direkt aus dem freien Handel muss die Fritz!Box eventuell

noch vorbereitet werden. Siehe dazu:

[https://www.janrufmonitor.de/fritzbox-vorbereiten/ FRITZ!BOX vorbereiten]

Die nächsten Konfigurationen werden, nach dem Start des jAnrufmonitors, wieder in den Einstellungen vorgenommen.

Etwaige Fehlermeldungen und Passwort-Anfragen, können weggeklickt werden.

Die Einstellungen unter dem Punkt "AVM FRITZ!Box Fon-Einstellungen" müssen wie folgt konfiguriert werden.

Ab Fritz!OS 7.27 muss die Anmeldung an der Fritz!Box über Benutzername und Passwort erfolgen.
Eventuell muss man dazu in der Fritz!Box noch einen Benutzer anlegen.

[[Datei:FritzboxVerbindung.png]]

Bei Eingabe der korrekten Daten, wird eine Verbindung zur FRITZ!Box hergestellt, nachdem der jAnrufmonitor einmal beendet und neu gestartet wurde.

In dem Fall wird dann in den Einstellungen zum Beispiel das genaue Modell, der Firmware Stand und die Seriennummer der FRITZ!Box angezeigt.

'''9. Vorwahl in den Einstellungen setzen'''

Zum Abschluss ist es noch notwendig, dass in den Einstellungen des jAnrufmonitors unter „Grundeinstellungen“ noch die Ortskennzahl inkl. führender 0 eingetragen wird.

'''10. MSN, Standort und Instanz in der Config setzen'''

Die Konfigurationsdatei befindet sich unter folgendem Pfad.

C:\NETZkultur\jAnrufmonitor-Call\config.txt

Der Name der Instanz muss nur in Kurzform angegeben werden.

Also nur „demo“ anstelle von „demo.infra-struktur.eu“.

Weitere Infos hierzu finden Sie in folgenden Kapiteln:

'''Kapitel: [[Anrufverwaltung]]'''

'''Kapitel: [[Allgemeinverwaltung]]'''

'''11. Automatischen Start des jAnrufmonitors beim Start des Servers in der Aufgabenplanung des Servers setzen'''

Zuerst muss die Aufgabenplanung in Windows geöffnet werden.

Danach wird die Konfigurationsdatei "Aufgabe_Start-jAnrufmonitor.xml" über die Funktion "Aufgabe importieren" rechts im Menü geladen.

Vor dem Speichern muss darauf geachtet werden, dass die Aufgabe mit einem gültigen Windows-Benutzer, wenn möglich dem Administrator, ausgeführt wird.

[[Datei:Aufgabenplanung.png]]

Durch klicken auf „OK“ wird die Aufgabe angelegt und der jAnrufmonitor bei jedem Start des Servers direkt gestartet.

'''12.Abschluss und weitere Infos'''

Hiermit ist die Konfiguration des jAnrufmonitors abgeschlossen.

Im Verzeichnis „C:\NETZkultur\jAnrufmonitor-Call“ befindet sich eine nützliche Log-Datei namens „calls.log“ in der alle an die infra-struktur übergebenen Anrufe aufgeführt werden.

Wenn die Anrufe nicht an die infra-struktur übergeben werden, kann der Fehler idr. über diese Log-Datei nachvollzogen werden.

= Annahme der Anrufe in der infra-stuktur =

Zum Abschluss fehlt nun nur noch die Konfiguration der MSNs, in der infra-struktur Administration unter Anrufliste.

Diese wird wie in folgendem Kapitel beschrieben eingerichtet.

'''Kapitel: [[Anrufverwaltung]]'''

Die MSNs, die dort benötigt werden, können Sie aus der Fritzbox unter eigene Rufnummern auslesen.

Zum Beispiel wird bii einem Telekom-VOIP Anschluss, idr. die gesamten Telefonnummer (02941272630) verwendet.

JAnrufmonitor

2023-11-24T10:29:17Z

Frank:

Der jAnrufmonitor ist eine Software, die zusammen mit einer FRITZ!Box ermöglicht eingehende Anrufe in die infra-struktur zu einzutragen.

Ausgehende Gespräche können über den jAnrufmonitor nicht initiiert werden.

In diesem Beitrag wird Schritt für Schritt beschrieben, wie der jAnrufmonitor für die Signalisierung von Anrufen in die infra-struktur eingerichtet wird.

Somit richtet sich dieser Beitrag an alle Kunden, die keine Telefonanlage besitzen, bzw. dessen Telefonanlage kein 3rd-Party-TAPI-Treiber bereitstellt.

= Hardware Voraussetzungen =

'''1. FRITZ!Box, die alle eingehenden Anrufe erkennt.'''

Eine Liste aller unterstützten FRITZ!Boxen befindet sich unter folgendem Link.

[https://www.janrufmonitor.de/fuer-avm-fritzbox/ jAnrufmonitor - Unterstützte FRITZ!Box]

'''2. Einen Windows Server/Client auf dem der jAnrufmonitor installiert werden kann.'''

Grundsätzlich ist der jAnrufmonitor mit jedem Server bzw. Client kompatibel, solange auf diesen ein Windows Betriebssystem installiert ist.

Wir empfehlen bei Client-PCs mindestens "Windows-7" und bei einem Server mindestens "Windows Server 2008".

Zusätzlich sollte darauf geachtet werden, dass es sich bei dem verwendeten PC nicht um einen Arbeits-PC handelt, der von einem Mitarbeiter zum Arbeiten verwendet wird.

= Download der Installationsdateien =

Es stehen zwei verschiedene Versionen des jAnrufmonitors zum Download bereit.

Sie unterscheiden sich an der Prozessorarchitektur der verwendeten Windows-Maschine.

[https://info.infra-struktur.de/unterlagen/NETZkultur_jAnrufmonitor-x86.zip Download NETZkultur_jAnrufmonitor 32-Bit]

[https://info.infra-struktur.de/unterlagen/NETZkultur_jAnrufmonitor-x64.zip Download NETZkultur_jAnrufmonitor 64-Bit]

= Installation und Einrichtung =

'''1.Java Runtime Environment installieren'''

Die Installationsdatei liegt in der ZIP-Datei vor.

Bei Bedarf kann auch eine neuere Version von Java verwendet werden.

Wir können in dem Fall nicht garantieren, dass der jAnrufmonitor noch Problemlos funktioniert, da wir nicht jede Java-Version testen können.

Grundsätzlich sollten dadurch aber keine Probleme auftreten.

Wichtig:

Es muss zwingend darauf geachtet werden, dass die korrekte Bit-Variante (x86, x64) von Java verwendet wird.

'''2. jAnrufmonitor installieren'''

Die Installationsdatei "jam50-winXX.exe" liegt vor.

Es muss darauf geachtet werden, dass als Installationstyp "jAnrufmonitor für eine AVM FRITZ!BoxFon" ausgewählt wird.

Ansonsten muss nur auf den Button "weiter" geklickt werden.

'''3. Kopieren des Ordners „NETZkultur“'''

Damit die Anrufe später vom jAnrufmonitor an die infra-struktur übergeben werden können, muss der Ordner "NETZkultur" aus der ZIP-Datei direkt unter C: kopiert werden.

Somit sollte sich im Verzeichnis „C:\NETZkultur“ ein Ordner namens „jAnrufmonitor-Call“ befinden.

'''4. Grundeinrichtung des jAnrufmonitors'''

Den jAnrufmonior starten und einfach immer nur den Button "next" klicken.

Beim Rufnummernformat das "Kanonische Rufnummernformat" auswählen und sonst keine weiteren Einstellungen vornehmen.

Zum Ende wird mit dem Schalter „Finish“ bestätigt wodurch ein ein neues Icon hinten in der Taskleiste auftaucht.

'''5. Aktivieren der Expertenansicht'''

Zuerst müssen die Einstellungen des jAnrufmonitors geöffnet werden

Dies wird per Rechtsklick auf das Icon und einem folgenden Klick auf „Administration -> Einstellungen“ durchgeführt.

[[Datei:JAnrufmonitor-Einstellungen-oeffnen.png]]

Unten in diesen Einstellungen gibt es die Expertenansicht.

Dort wird der Haken "Expertenansicht aktivieren" ausgewählt und auf "OK" geklickt.

'''6. Plugin "Erweiterung zum Starten von Anwendungen" laden'''

Mit dem "Module-Manager" können benötigte Erweiterungen geladen werden.

Dieser befindet sich unter den Einstellungen, die wie im vorherigen Schritt beschrieben geöffnet werden können.

Nun wird über einen Klick auf den Button "Browse", das benötigte Plugin „mod-srv-extapp.3.0.3.jam.zip“ ausgewählt und der Vorgang mit dem Button „Installieren“ bestätigt.

'''7. Einspielen der Standardkonfiguration'''

Nun muss im Module Manager noch die Konfiguration geladen werden.

Hierfür wird die Datei "cfg.jAnrumonitor.jam.zip" geladen und per Klick auf „installieren“ und danach auf „OK“ bestätigt.

Der jAnrufmonitor beendet sich nun einmal komplett.

'''7b. Standardkonfiguration prüfen'''

[[Datei:JAM_Platzhalter_ohne_Leerzeichen.png]]

Anders als im Bild muss im Feld Format für %callernumber% statt dem "+" ein "00" stehen und zwischen den einzelnen Platzhaltern darf kein Leereichen sein.
Sonst wird die Nummer nicht erkannt und der Anruf wird nicht in IFS eingetragen.

Korrekt wäre als "00%intareacode%(%areacode%)%callnumber%" (aber natürlich ohne die "")

'''8. Verbindung des jAnrufmonitors mit der FRITZ!Box'''

'''Wichtig'''

Die Voraussetzung, dass der jAnrufmonitor eine Verbindung zur FRITZ!Box aufnehmen kann, ist dass die Funktion „Überwachung von Port 1012“ freigeschaltet ist.

Diese Funktion kann wie in folgender Anleitung beschrieben aktiviert werden.

[https://www.janrufmonitor.de/ueberwachung-freischalten/ FRITZ!BOX Überwachung freischalten]

'''Achtung'''

Wenn die Fritz!Box nicht von einem Provider kommt, sondern direkt aus dem freien Handel muss die Fritz!Box eventuell

noch vorbereitet werden. Siehe dazu:

[https://www.janrufmonitor.de/fritzbox-vorbereiten/ FRITZ!BOX vorbereiten]

Die nächsten Konfigurationen werden, nach dem Start des jAnrufmonitors, wieder in den Einstellungen vorgenommen.

Etwaige Fehlermeldungen und Passwort-Anfragen, können weggeklickt werden.

Die Einstellungen unter dem Punkt "AVM FRITZ!Box Fon-Einstellungen" müssen wie folgt konfiguriert werden.

Ab Fritz!OS 7.27 muss die Anmeldung an der Fritz!Box über Benutzername und Passwort erfolgen.
Eventuell muss man dazu in der Fritz!Box noch einen Benutzer anlegen.

[[Datei:FritzboxVerbindung.png]]

Bei Eingabe der korrekten Daten, wird eine Verbindung zur FRITZ!Box hergestellt, nachdem der jAnrufmonitor einmal beendet und neu gestartet wurde.

In dem Fall wird dann in den Einstellungen zum Beispiel das genaue Modell, der Firmware Stand und die Seriennummer der FRITZ!Box angezeigt.

'''9. Vorwahl in den Einstellungen setzen'''

Zum Abschluss ist es noch notwendig, dass in den Einstellungen des jAnrufmonitors unter „Grundeinstellungen“ noch die Ortskennzahl inkl. führender 0 eingetragen wird.

'''10. MSN, Standort und Instanz in der Config setzen'''

Die Konfigurationsdatei befindet sich unter folgendem Pfad.

C:\NETZkultur\jAnrufmonitor-Call\config.txt

Der Name der Instanz muss nur in Kurzform angegeben werden.

Also nur „demo“ anstelle von „demo.infra-struktur.eu“.

Weitere Infos hierzu finden Sie in folgenden Kapiteln:

'''Kapitel: [[Anrufverwaltung]]'''

'''Kapitel: [[Allgemeinverwaltung]]'''

'''11. Automatischen Start des jAnrufmonitors beim Start des Servers in der Aufgabenplanung des Servers setzen'''

Zuerst muss die Aufgabenplanung in Windows geöffnet werden.

Danach wird die Konfigurationsdatei "Aufgabe_Start-jAnrufmonitor.xml" über die Funktion "Aufgabe importieren" rechts im Menü geladen.

Vor dem Speichern muss darauf geachtet werden, dass die Aufgabe mit einem gültigen Windows-Benutzer, wenn möglich dem Administrator, ausgeführt wird.

[[Datei:Aufgabenplanung.png]]

Durch klicken auf „OK“ wird die Aufgabe angelegt und der jAnrufmonitor bei jedem Start des Servers direkt gestartet.

'''12.Abschluss und weitere Infos'''

Hiermit ist die Konfiguration des jAnrufmonitors abgeschlossen.

Im Verzeichnis „C:\NETZkultur\jAnrufmonitor-Call“ befindet sich eine nützliche Log-Datei namens „calls.log“ in der alle an die infra-struktur übergebenen Anrufe aufgeführt werden.

Wenn die Anrufe nicht an die infra-struktur übergeben werden, kann der Fehler idr. über diese Log-Datei nachvollzogen werden.

= Annahme der Anrufe in der infra-stuktur =

Zum Abschluss fehlt nun nur noch die Konfiguration der MSNs, in der infra-struktur Administration unter Anrufliste.

Diese wird wie in folgendem Kapitel beschrieben eingerichtet.

'''Kapitel: [[Anrufverwaltung]]'''

Die MSNs, die dort benötigt werden, können Sie aus der Fritzbox unter eigene Rufnummern auslesen.

Zum Beispiel wird bii einem Telekom-VOIP Anschluss, idr. die gesamten Telefonnummer (02941272630) verwendet.

JAnrufmonitor

2023-11-24T10:21:32Z

Frank:

Der jAnrufmonitor ist eine Software, die zusammen mit einer FRITZ!Box ermöglicht eingehende Anrufe in die infra-struktur zu einzutragen.

Ausgehende Gespräche können über den jAnrufmonitor nicht initiiert werden.

In diesem Beitrag wird Schritt für Schritt beschrieben, wie der jAnrufmonitor für die Signalisierung von Anrufen in die infra-struktur eingerichtet wird.

Somit richtet sich dieser Beitrag an alle Kunden, die keine Telefonanlage besitzen, bzw. dessen Telefonanlage kein 3rd-Party-TAPI-Treiber bereitstellt.

= Hardware Voraussetzungen =

'''1. FRITZ!Box, die alle eingehenden Anrufe erkennt.'''

Eine Liste aller unterstützten FRITZ!Boxen befindet sich unter folgendem Link.

[https://www.janrufmonitor.de/fuer-avm-fritzbox/ jAnrufmonitor - Unterstützte FRITZ!Box]

'''2. Einen Windows Server/Client auf dem der jAnrufmonitor installiert werden kann.'''

Grundsätzlich ist der jAnrufmonitor mit jedem Server bzw. Client kompatibel, solange auf diesen ein Windows Betriebssystem installiert ist.

Wir empfehlen bei Client-PCs mindestens "Windows-7" und bei einem Server mindestens "Windows Server 2008".

Zusätzlich sollte darauf geachtet werden, dass es sich bei dem verwendeten PC nicht um einen Arbeits-PC handelt, der von einem Mitarbeiter zum Arbeiten verwendet wird.

= Download der Installationsdateien =

Es stehen zwei verschiedene Versionen des jAnrufmonitors zum Download bereit.

Sie unterscheiden sich an der Prozessorarchitektur der verwendeten Windows-Maschine.

[https://info.infra-struktur.de/unterlagen/NETZkultur_jAnrufmonitor-x86.zip Download NETZkultur_jAnrufmonitor 32-Bit]

[https://info.infra-struktur.de/unterlagen/NETZkultur_jAnrufmonitor-x64.zip Download NETZkultur_jAnrufmonitor 64-Bit]

= Installation und Einrichtung =

'''1.Java Runtime Environment installieren'''

Die Installationsdatei liegt in der ZIP-Datei vor.

Bei Bedarf kann auch eine neuere Version von Java verwendet werden.

Wir können in dem Fall nicht garantieren, dass der jAnrufmonitor noch Problemlos funktioniert, da wir nicht jede Java-Version testen können.

Grundsätzlich sollten dadurch aber keine Probleme auftreten.

Wichtig:

Es muss zwingend darauf geachtet werden, dass die korrekte Bit-Variante (x86, x64) von Java verwendet wird.

'''2. jAnrufmonitor installieren'''

Die Installationsdatei "jam50-winXX.exe" liegt vor.

Es muss darauf geachtet werden, dass als Installationstyp "jAnrufmonitor für eine AVM FRITZ!BoxFon" ausgewählt wird.

Ansonsten muss nur auf den Button "weiter" geklickt werden.

'''3. Kopieren des Ordners „NETZkultur“'''

Damit die Anrufe später vom jAnrufmonitor an die infra-struktur übergeben werden können, muss der Ordner "NETZkultur" aus der ZIP-Datei direkt unter C: kopiert werden.

Somit sollte sich im Verzeichnis „C:\NETZkultur“ ein Ordner namens „jAnrufmonitor-Call“ befinden.

'''4. Grundeinrichtung des jAnrufmonitors'''

Den jAnrufmonior starten und einfach immer nur den Button "next" klicken.

Beim Rufnummernformat das "Kanonische Rufnummernformat" auswählen und sonst keine weiteren Einstellungen vornehmen.

Zum Ende wird mit dem Schalter „Finish“ bestätigt wodurch ein ein neues Icon hinten in der Taskleiste auftaucht.

'''5. Aktivieren der Expertenansicht'''

Zuerst müssen die Einstellungen des jAnrufmonitors geöffnet werden

Dies wird per Rechtsklick auf das Icon und einem folgenden Klick auf „Administration -> Einstellungen“ durchgeführt.

[[Datei:JAnrufmonitor-Einstellungen-oeffnen.png]]

Unten in diesen Einstellungen gibt es die Expertenansicht.

Dort wird der Haken "Expertenansicht aktivieren" ausgewählt und auf "OK" geklickt.

'''6. Plugin "Erweiterung zum Starten von Anwendungen" laden'''

Mit dem "Module-Manager" können benötigte Erweiterungen geladen werden.

Dieser befindet sich unter den Einstellungen, die wie im vorherigen Schritt beschrieben geöffnet werden können.

Nun wird über einen Klick auf den Button "Browse", das benötigte Plugin „mod-srv-extapp.3.0.3.jam.zip“ ausgewählt und der Vorgang mit dem Button „Installieren“ bestätigt.

'''7. Einspielen der Standardkonfiguration'''

Nun muss im Module Manager noch die Konfiguration geladen werden.

Hierfür wird die Datei "cfg.jAnrumonitor.jam.zip" geladen und per Klick auf „installieren“ und danach auf „OK“ bestätigt.

Der jAnrufmonitor beendet sich nun einmal komplett.

'''7b. Standardkonfiguration prüfen'''

[[Datei:JAM_Platzhalter_ohne_Leerzeichen.png]]

Anders als im Bild muss im Feld Format für %callernumber% statt dem "+" ein "00" stehen und zwischen den einzelnen Platzhaltern darf kein Leereichen sein.
Sonst wird die Nummer nicht erkannt und der Anruf wird nicht in IFS eingetragen.

Korrekt wäre als "00%intareacode%(%areacode%)%callnumber%" (aber natürlich ohne die "")

'''8. Verbindung des jAnrufmonitors mit der FRITZ!Box'''

'''Wichtig'''

Die Voraussetzung, dass der jAnrufmonitor eine Verbindung zur FRITZ!Box aufnehmen kann, ist dass die Funktion „Überwachung von Port 1012“ freigeschaltet ist.

Diese Funktion kann wie in folgender Anleitung beschrieben aktiviert werden.

[https://www.janrufmonitor.de/ueberwachung-freischalten/ FRITZ!BOX Überwachung freischalten]

Die nächsten Konfigurationen werden, nach dem Start des jAnrufmonitors, wieder in den Einstellungen vorgenommen.

Etwaige Fehlermeldungen und Passwort-Anfragen, können weggeklickt werden.

Die Einstellungen unter dem Punkt "AVM FRITZ!Box Fon-Einstellungen" müssen wie folgt konfiguriert werden.

[[Datei:FritzboxVerbindung.png]]

Bei Eingabe der korrekten Daten, wird eine Verbindung zur FRITZ!Box hergestellt, nachdem der jAnrufmonitor einmal beendet und neu gestartet wurde.

In dem Fall wird dann in den Einstellungen zum Beispiel das genaue Modell, der Firmware Stand und die Seriennummer der FRITZ!Box angezeigt.

'''9. Vorwahl in den Einstellungen setzen'''

Zum Abschluss ist es noch notwendig, dass in den Einstellungen des jAnrufmonitors unter „Grundeinstellungen“ noch die Ortskennzahl inkl. führender 0 eingetragen wird.

'''10. MSN, Standort und Instanz in der Config setzen'''

Die Konfigurationsdatei befindet sich unter folgendem Pfad.

C:\NETZkultur\jAnrufmonitor-Call\config.txt

Der Name der Instanz muss nur in Kurzform angegeben werden.

Also nur „demo“ anstelle von „demo.infra-struktur.eu“.

Weitere Infos hierzu finden Sie in folgenden Kapiteln:

'''Kapitel: [[Anrufverwaltung]]'''

'''Kapitel: [[Allgemeinverwaltung]]'''

'''11. Automatischen Start des jAnrufmonitors beim Start des Servers in der Aufgabenplanung des Servers setzen'''

Zuerst muss die Aufgabenplanung in Windows geöffnet werden.

Danach wird die Konfigurationsdatei "Aufgabe_Start-jAnrufmonitor.xml" über die Funktion "Aufgabe importieren" rechts im Menü geladen.

Vor dem Speichern muss darauf geachtet werden, dass die Aufgabe mit einem gültigen Windows-Benutzer, wenn möglich dem Administrator, ausgeführt wird.

[[Datei:Aufgabenplanung.png]]

Durch klicken auf „OK“ wird die Aufgabe angelegt und der jAnrufmonitor bei jedem Start des Servers direkt gestartet.

'''12.Abschluss und weitere Infos'''

Hiermit ist die Konfiguration des jAnrufmonitors abgeschlossen.

Im Verzeichnis „C:\NETZkultur\jAnrufmonitor-Call“ befindet sich eine nützliche Log-Datei namens „calls.log“ in der alle an die infra-struktur übergebenen Anrufe aufgeführt werden.

Wenn die Anrufe nicht an die infra-struktur übergeben werden, kann der Fehler idr. über diese Log-Datei nachvollzogen werden.

= Annahme der Anrufe in der infra-stuktur =

Zum Abschluss fehlt nun nur noch die Konfiguration der MSNs, in der infra-struktur Administration unter Anrufliste.

Diese wird wie in folgendem Kapitel beschrieben eingerichtet.

'''Kapitel: [[Anrufverwaltung]]'''

Die MSNs, die dort benötigt werden, können Sie aus der Fritzbox unter eigene Rufnummern auslesen.

Zum Beispiel wird bii einem Telekom-VOIP Anschluss, idr. die gesamten Telefonnummer (02941272630) verwendet.

Datei:JAM Platzhalter ohne Leerzeichen.png

2023-11-24T10:08:06Z

Frank: