Sipgate Schnittstelle: Unterschied zwischen den Versionen

Aus infra-struktur AdminWiki 2.10
Zur Navigation springenZur Suche springen
Keine Bearbeitungszusammenfassung
 
(9 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 5: Zeile 5:
Wenn dies für ihren Account verfügbar ist tragen sie in der Anruflisten Administration bitte die Kennungen des Anschlusses als MSN ein und als Standort "sipgate".<br>
Wenn dies für ihren Account verfügbar ist tragen sie in der Anruflisten Administration bitte die Kennungen des Anschlusses als MSN ein und als Standort "sipgate".<br>


In ihrem Sipgate-Account können sie bei den sipgate.io Einstellungen eine URL für eingehende Anrufe hinterlegen. Hier tragen sie das folgende ein:<br>
In ihrem Sipgate-Account können sie bei den sipgate.io Einstellungen eine URL für eingehende Anrufe hinterlegen. <br>Hier tragen sie das folgende ein:<br>
https://[instanzname]-classic.infra-struktur.com/api/calllist/sipgate.php<br>
https://[instanzname]-classic.infra-struktur.com/api/calllist/sipgate.php<br>


Zeile 15: Zeile 15:


Der Parameter "to" entspricht dem was sie in infra-struktur als MSN eintragen müssen.<br>
Der Parameter "to" entspricht dem was sie in infra-struktur als MSN eintragen müssen.<br>
[[Datei:Screen log anzeigen.jpg]]<br>
[[Datei:Hinweis.png]]Achtung!! Derzeit können Anrufe nur in eine Anrufliste eingetragen werden. Eine Erweiterung der Programmierung ist bei Bedarf möglich.<br>


[[Datei:Hinweis.png]]Achtung!! Eine Eintragung erfolgt nur bei mindestens einem aktiv angemeldeten Telefon.
[[Datei:Hinweis.png]]Achtung!! Eine Eintragung erfolgt nur bei mindestens einem aktiv angemeldete Telefon.


== Wählfunktion für sipgate ==
== Wählfunktion für sipgate ==
Zeile 25: Zeile 23:


Zu allererst gehen sie in die Administration zum Punkt Wählhilfe.<br>
Zu allererst gehen sie in die Administration zum Punkt Wählhilfe.<br>
Für den Standort wo die Wählhilfe genutzt werden soll stellen sie als Typ "Sipgate IO" ein. Weitere Parameter sind an dieser Stelle nicht notwendig.
Für den Standort wo die Wählhilfe genutzt werden soll stellen sie als Typ "Sipgate IO" ein. Dannn öffnen sich 2 Felder für die Parameter "Token-ID und Token <br>
Die notwendigen Wertebekommen sie über folgende Schritte bei sipgate.
* Erzeugen eines PAT (Personal Access Token)​<br>
- mit den sipgate Zugangsdaten in den Adminaccount bei sipgate anmelden und in die Accountverwaltung gehen.<br>
- auf folgenden Link klicken  https://www.sipgate.io/rest-api/authentication#personalAccessToken und dann auf den markierten Link "Personal Access Token settings" klicken<br>
- oben rechts auf "+ Token hinzufügen" und einen Namen vergeben. (z.B. infra-struktur)<br>
- dann kommt die Auswahl der Berechtigungen(Scopes). Ganz nach unten scrollen und "all scopes" auswählen.<br>
- den generierten Token kopieren und in die infra-struktur Administration-> Wählhilfe wechseln.<br>
- Dann wird in der Token-Liste auch eine Token-ID angezeigt. (Irgendwas mit "token-Code") Den in das Feld Token-ID eintragen.<br>
- Jetzt in der Konfiguration der Wählhilfe auf "speichern" klicken. Fertig!<br>
 
[[Datei:Sipgate waelhilfe.jpg]]
[[Datei:Sipgate waelhilfe.jpg]]
Setzen sie hier auch die Benutzerberechtigung für alle die diese Funktion verwenden möchten.
Setzen sie hier auch die Benutzerberechtigung für alle die diese Funktion verwenden möchten.<br>
 
Damit sie aus infra-struktur über sipgate telefonieren können müssen sie einmalig der von uns entwickelten Application den Zugriff auf den Account gewähren.<br>
Dazu müssen sie in der Menüverwaltung ein neues Menüitem erstellen.<br>
nach folgendem Schema.<br>
Name des items kann frei vergeben werden.<br>
URL:https://api.sipgate.com/v1/authorization/oauth/authorize<br>


Parameter:scope=all&response_type=code&client_id=FBMuwgyOI6&redirect_uri=''Hier muss die URL-Encoded URL zu unserem Sipgate-Client eingetragen werden''<br>
Um die als Durchwahl in den persönlichen Einstellungen benötigten Kennungen auszulesen wird ein neuer Menüpunkt in der infra-struktur angelegt.<br>
Dieser benötigt folgende Parameter.<br>
URL: /communication/outgoingCall/modules/sipgateIO/phonelines.php<br>
Session aktiv<br>


Für den Parameter redirect_uri muss diese URL:<br>
Menüpunkt und Bezeichnung können sie frei wählen.<br>
https://demo-classic.infra-struktur.eu/communication/outgoingCall/modules/sipgateIO/callback.php?newSession=true<br>
auf ihren Instanznamen angepasst und URL-Encoded werden.<br>
Das Encoden können sie auf zahlreichen Webseiten machen.<br>
Hier ein Beispiel [http://www.opinionatedgeek.com/DotNet/Tools/UrlEncode/Encode.aspx URL-Encoder auf opinionatedgeek.com ]<br>
URL-Encoded sieht das dann so aus:<br>
<code>https%3a%2f%2fdemo-classic.infra-struktur.eu%2fcommunication%2foutgoingCall%2fmodules%2fsipgateIO%2fcallback.php%3fnewSession%3dtrue</code><br>  


Vollständig sieht der Eintrag als Parameter für das Menüitem dann so aus:<br>
Beim Aufruf des Menüpunkts bekommen sie eine Übersicht aller Telefone und aller Leitungen.<br>
scope=all&response_type=code&client_id=FBMuwgyOI6&redirect_uri=https%3a%2f%2fdemo-classic.infra-struktur.eu%2fcommunication%2foutgoingCall%2fmodules%2fsipgateIO%2fcallback.php%3fnewSession%3dtrue<br>
Wählen sie pro Benutzer das passende Telefon und die passende Leitung.<br>
[[Datei:Sipgate item.jpg]]
Dann können sie darüber die Kennung auslesen. Z.B.: e43:p35<br>
[[Datei:Sipgate kennung.jpg]]


Nach der Einrichtung und Vergabe der entsprechenden Rechte kann das Menüitem aufgerufen werden.<br>
Die Kennung wird jetzt von jedem Benutzer in seine persönlichen Einstellungen -> Telefon als Durchwahl mit dem korrekten Standort eingetragen und gespeichert.
[[Datei:Auhorize sipgate1.jpg]]<br>
[[Datei:Sipgate_persEinstellungen.jpg]]
Hier geben sie die Zugangsdaten für den Account ein den sie für das Wählen verwenden möchten und klicken auf Login.<br>
Im Folgenden Fenster klicken sie dann auf "Authorize" <br>
[[Datei:Auhorize sipgate2.jpg]]
Im folgenden Fenster geben wir für jedes ihrer angemeldeten Geräte einen Code aus den der jeweilige Benutzer dann als Durchwahl auf seiner Welcomeseite einträgt.
[[Datei:Sipgate welcome.jpg]]

Aktuelle Version vom 12. Juli 2022, 10:52 Uhr

Eingehende Signalisierung für sipgate

Um Anrufe des Anbieters "Sipgate"(https://www.sipgate.de) in die Anrufliste einzutragen, verwenden wir das Feature sipgate.io
Wenn dies für ihren Account verfügbar ist tragen sie in der Anruflisten Administration bitte die Kennungen des Anschlusses als MSN ein und als Standort "sipgate".

In ihrem Sipgate-Account können sie bei den sipgate.io Einstellungen eine URL für eingehende Anrufe hinterlegen.
Hier tragen sie das folgende ein:
https://[instanzname]-classic.infra-struktur.com/api/calllist/sipgate.php

also z.B.
https://demo-classic.infra-struktur.com/api/calllist/sipgate.php

In den sipgate.io Einstellungen finden sie auch Infos zu den Werten die übergeben werden, wenn sie "Log anzeigen" aktiviert haben und sich diesen nach einem Testanruf anschauen.

Der Parameter "to" entspricht dem was sie in infra-struktur als MSN eintragen müssen.

Achtung!! Eine Eintragung erfolgt nur bei mindestens einem aktiv angemeldete Telefon.

Wählfunktion für sipgate

Auch für die sipgate Wählfunktion verwenden wir die Schnittstelle sipgate.io.

Zu allererst gehen sie in die Administration zum Punkt Wählhilfe.
Für den Standort wo die Wählhilfe genutzt werden soll stellen sie als Typ "Sipgate IO" ein. Dannn öffnen sich 2 Felder für die Parameter "Token-ID und Token
Die notwendigen Wertebekommen sie über folgende Schritte bei sipgate.

  • Erzeugen eines PAT (Personal Access Token)​

- mit den sipgate Zugangsdaten in den Adminaccount bei sipgate anmelden und in die Accountverwaltung gehen.
- auf folgenden Link klicken https://www.sipgate.io/rest-api/authentication#personalAccessToken und dann auf den markierten Link "Personal Access Token settings" klicken
- oben rechts auf "+ Token hinzufügen" und einen Namen vergeben. (z.B. infra-struktur)
- dann kommt die Auswahl der Berechtigungen(Scopes). Ganz nach unten scrollen und "all scopes" auswählen.
- den generierten Token kopieren und in die infra-struktur Administration-> Wählhilfe wechseln.
- Dann wird in der Token-Liste auch eine Token-ID angezeigt. (Irgendwas mit "token-Code") Den in das Feld Token-ID eintragen.
- Jetzt in der Konfiguration der Wählhilfe auf "speichern" klicken. Fertig!

Setzen sie hier auch die Benutzerberechtigung für alle die diese Funktion verwenden möchten.

Um die als Durchwahl in den persönlichen Einstellungen benötigten Kennungen auszulesen wird ein neuer Menüpunkt in der infra-struktur angelegt.
Dieser benötigt folgende Parameter.
URL: /communication/outgoingCall/modules/sipgateIO/phonelines.php
Session aktiv

Menüpunkt und Bezeichnung können sie frei wählen.

Beim Aufruf des Menüpunkts bekommen sie eine Übersicht aller Telefone und aller Leitungen.
Wählen sie pro Benutzer das passende Telefon und die passende Leitung.
Dann können sie darüber die Kennung auslesen. Z.B.: e43:p35

Die Kennung wird jetzt von jedem Benutzer in seine persönlichen Einstellungen -> Telefon als Durchwahl mit dem korrekten Standort eingetragen und gespeichert.