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

Anruf HTTP GET Schnittstelle V2

2026-10-22T13:43:19Z

Karsten: /* Optionale Parameter */

= 📞 Anruf-API – Version 2 =

Die '''Anruf-API''' dient dazu, Anrufe per Webhook in die CRM-Infrastruktur ''infra-struktur'' einzutragen und zu aktualisieren.
Die Schnittstelle kann per '''HTTP GET''' oder '''POST''' aufgerufen werden – '''GET hat Vorrang'''.

== 1. Anruf eintragen ==

'''Endpoint:'''
<code>http://[instance]-classic.infra-struktur.[eu|com]/api/calllist/index.php</code>

=== Pflichtparameter ===
{| class="wikitable"
! Parameter
! Beschreibung
|-
| isdnKey
| Der ISDN-Key
|-
| location
| Name eines in der Anrufliste konfigurierten Standortes
|-
| msn
| Name einer in der Anrufliste konfigurierten eingehenden Rufnummer/Nebenstelle
|-
| number
| Rufnummer des Anrufers ('''muss URL-encodiert werden''', z. B. <code>+492941247790</code> → <code>%2B492941247790</code>)
|}

=== Optionale Parameter ===
{| class="wikitable"
! Parameter
! Beschreibung
|-
| reason
| Base64-codierter Grund des Anrufs
|-
| fileSource
| Base64-codierter Inhalt einer Datei
|-
| fileType
| Dateityp (Standard: <code>fax</code>)
|-
| mimeType
| MIME-Type (Standard: <code>application/download</code>)
|-
| timestamp
| Unix-Timestamp (Standard: Zeitpunkt des Aufrufs)
|-
| direction
| <code>"in"</code> oder <code>"out"</code> (Standard: <code>in</code>)
|-
| duration
| Dauer in Minuten eines Anrufs.
|-
| externalId
| Eine eigene ID des Telefonsystems über den ich später mit dem update Aufruf einen Eintrag exakt diesem Eintrag zuordnen kann.
|}

=== Rückgabe/Response ===
{| class="wikitable"
! Parameter
! Beschreibung
|-
|Done XYZ
|Der Wert "Done" zeigt den erfolgreichen Eintrag an gefolgt von der vom System vergebenen ID. Über die kann der Anruf später weiter aktualisiert werden.
|}

== 2. Anruf aktualisieren ==

'''Endpoint:'''
<code>http://[instance]-classic.infra-struktur.[eu|com]/api/calllist/update.php</code>

=== Pflichtparameter ===
{| class="wikitable"
! Parameter
! Beschreibung
|-
| isdnKey
| Der ISDN-Key
|-
| number
| Rufnummer des zu aktualisierenden Anrufs ('''muss URL-encodiert werden''') (Wird nicht gebraucht wenn eine externalId übergeben wird.)
|}

Mit der Rufnummer wird nach Anrufen in den letzten 60 Minuten mit der gleichen Rufnummer gesucht und der Anruf wird dann für den Grund verwendet.

=== Optionale Parameter ===
{| class="wikitable"
! Parameter
! Beschreibung
|-
| AnrufID
| ID des Anrufs (hat Vorrang vor <code>number</code>)
|-
| externalId
| wurde beim initialen Eintrag des Anrufs eine externalId übergeben kann das update damit genau auf den Eintrag gemünzt werden.
|-
| reason
| Grund (Base64 oder Klartext, bei GET zusätzlich URL-encodiert)
|-
| reasonAppend
| Ergänzung zum Grund (Base64 oder Klartext, bei GET zusätzlich URL-encodiert)
|-
| acceptedBy
| Benutzerkürzel für „angenommen durch“
|-
| callFor
| Benutzerkürzel für „Anruf für“
|-
| recall
| Angabe, ob ein Rückruf gewünscht ist als "ja" oder "nein"
|-
| ownerInitial
| Benutzerkürzel des internen Benutzers, der das Gespräch geführt hat
|-
| fileSourceOut
| Ausgehender Audiostream als binärer Datei-Upload; nur via POST mit <code>multipart/form-data</code>
|-
| fileSourceIn
| Eingehender Audiostream als binärer Datei-Upload; nur via POST mit <code>multipart/form-data</code>
|}

== 3. Sonderfall: OpenAI Whisper Integration 🎙️ ==

Jede ''infra-struktur''-Instanz verfügt über einen lokalen Whisper-Server, der Audiodateien automatisch transkribiert.
Die '''Transkription wird im Anruf gespeichert''', die Originaldatei bleibt zusätzlich im Anruf per Mediaplayer abspielbar.

=== Parameter ===
{| class="wikitable"
! Parameter
! Beschreibung
|-
| fileSourceRaw
| Audiodatei im '''Binary-Format''' (nur via '''POST''' möglich, wegen Größe und Format)
|}

=== 3.1 Gesprächszusammenfassung mit getrennten Audiostreams ===

Alternativ zu einer einzelnen Audiodatei können der eingehende und der ausgehende Audiostream eines Gesprächs getrennt übertragen werden.

Die beiden Audiodateien werden dem über die <code>externalId</code> identifizierten Anruf zugeordnet und zur automatischen Transkription und Erstellung einer '''Anrufzusammenfassung''' verarbeitet.

Der Aufruf ist aufgrund der binären Audiodateien ausschließlich per '''HTTP POST''' mit <code>multipart/form-data</code> möglich.

==== Parameter ====

{| class="wikitable"
! Parameter
! Beschreibung
|-
| externalId
| Eindeutige ID des Gesprächs aus dem Telefonsystem. Die ID muss bereits beim initialen Eintragen des Anrufs übergeben worden sein und ordnet die Audiodateien exakt dem zugehörigen Anruf zu.
|-
| ownerInitial
| Benutzerkürzel des internen Benutzers, der das Gespräch geführt hat, beispielsweise <code>CT</code>.
|-
| fileSourceOut
| Binäre Audiodatei mit dem '''ausgehenden Audiostream''' des Gesprächs. Die Datei muss als Datei-Upload per <code>multipart/form-data</code> übertragen werden.
|-
| fileSourceIn
| Binäre Audiodatei mit dem '''eingehenden Audiostream''' des Gesprächs. Die Datei muss als Datei-Upload per <code>multipart/form-data</code> übertragen werden.
|}

Die Parameter <code>fileSourceOut</code> und <code>fileSourceIn</code> ermöglichen eine getrennte Verarbeitung beider Gesprächsseiten. Dadurch kann der interne Benutzer über <code>ownerInitial</code> dem Gespräch zugeordnet und eine automatische Zusammenfassung des Telefonats erzeugt werden.

Mindestens die zur eindeutigen Zuordnung benötigten Parameter <code>isdnKey</code> und <code>externalId</code> müssen übergeben werden.

== 4. Fehlercodes ==

=== 4.1 Fehlende Parameter ===
{| class="wikitable"
! Code
! Beschreibung
|-
| 1001
| isdnKey fehlt
|-
| 1002
| location fehlt
|-
| 1003
| msn fehlt
|-
| 1004
| number fehlt
|}

=== 4.2 Datenbankverbindung ===
{| class="wikitable"
! Code
! Beschreibung
|-
| 2001
| host fehlt
|-
| 2002
| username fehlt
|-
| 2003
| password fehlt
|-
| 2004
| database fehlt
|-
| 3001
| Verbindungsfehler (MySQLi)
|}

=== 4.3 Datenbankabfragen ===
Fehler bei einzelnen Abfragen, z. B.:
* 3102 – kein Standort mit dem Namen gefunden
* 3105 – MSN ist keine Fax-MSN
* 3113 – Fehler beim Einfügen eines Anrufs in die Calllist
* 3115 – Fehler beim Setzen eines Grundes

(Alle Fehler mit MySQLi-Fehlernummer und Fehlermeldung.)

=== 4.4 API-Fehler ===
{| class="wikitable"
! Code
! Beschreibung
|-
| 4001
| Ungültiger ISDN-Key
|-
| 4002
| ISDN-Key wurde noch nicht validiert
|-
| 4101
| Rufnummer zu kurz
|-
| 4102
| Rufnummer ist ein „Hidden Signal“
|-
| 4103
| Anruf liegt innerhalb der Signaltoleranz
|-
| 4104
| Keine passende Anrufliste für MSN & Standort gefunden
|}

== 5. Beispiele ==

=== 5.1 POST-Beispiel: Audiodatei hochladen & transkribieren (Whisper) ===
<pre>
curl -X POST "http://[instance]-classic.infra-struktur.eu/api/calllist/update.php" \
-F "isdnKey=DEIN_ISDN_KEY" \
-F "number=%2B492941247790" \
-F "fileSourceRaw=@anruf.mp3;type=audio/mpeg"
</pre>

Ergebnis:
* Die Datei ''anruf.mp3'' wird an den Anruf angehängt.
* Der Whisper-Server erzeugt eine '''Transkription''' und speichert sie im Anruf.
* Die Originaldatei ist zusätzlich im CRM über einen Mediaplayer abspielbar.

=== 5.2 POST-Beispiel: Audiodatei mit zusätzlichen Parametern ===
<pre>
curl -X POST "http://[instance]-classic.infra-struktur.eu/api/calllist/update.php" \
-F "isdnKey=DEIN_ISDN_KEY" \
-F "number=%2B492941247790" \
-F "reason=Kundenrückruf" \
-F "acceptedBy=AB" \
-F "fileSourceRaw=@anruf.mp3;type=audio/mpeg"
</pre>

Hier wird neben der Audiodatei zusätzlich ein '''Anrufgrund''' gesetzt (reason) und ein Bearbeiter eingetragen (acceptedBy).

=== 5.3 GET-Beispiel: Text-Update ohne Datei ===
<pre>
curl "http://[instance]-classic.infra-struktur.eu/api/calllist/update.php?isdnKey=DEIN_ISDN_KEY&number=%2B492941247790&reason=Rückruf+gewünscht&acceptedBy=AB"
</pre>

Ergebnis:
* Der Anruf mit der Nummer <code>+492941247790</code> wird aktualisiert.
* Als Grund wird ''Rückruf gewünscht'' gespeichert.
* Der Anruf wird als '''angenommen durch Benutzer AB''' markiert.

=== 5.4 POST-Beispiel: Getrennte Audiostreams hochladen und Anruf zusammenfassen ===

<pre>
curl -X POST "https://netzkultur-classic.infra-struktur.com/api/calllist/update.php" \
-H "Content-Type: multipart/form-data" \
-F "isdnKey=247790" \
-F "ownerInitial=CT" \
-F "externalId=21cf1ada-a93c-4436-b3c9-eb404c1b954c" \
-F "fileSourceOut=@/var/starface/module/instances/repo/5dd8302c-eb41-4a3d-8479-29755315f960/var/files/monitor/21cf1ada-a93c-4436-b3c9-eb404c1b954c_00492941272630_0049532134070-in.wav" \
-F "fileSourceIn=@/var/starface/module/instances/repo/5dd8302c-eb41-4a3d-8479-29755315f960/var/files/monitor/21cf1ada-a93c-4436-b3c9-eb404c1b954c_00492941272630_0049532134070-out.wav"
</pre>

'''Bedeutung der Parameter:'''

{| class="wikitable"
! Parameter
! Beispielwert
! Bedeutung
|-
| isdnKey
| <code>247790</code>
| ISDN-Key der ''infra-struktur''-Instanz
|-
| ownerInitial
| <code>CT</code>
| Kürzel des internen Benutzers, der das Gespräch geführt hat
|-
| externalId
| <code>21cf1ada-a93c-4436-b3c9-eb404c1b954c</code>
| Eindeutige Gesprächs-ID des Telefonsystems
|-
| fileSourceOut
| <code>@/pfad/zum/audiostream.wav</code>
| Ausgehender Audiostream als binärer Datei-Upload
|-
| fileSourceIn
| <code>@/pfad/zum/audiostream.wav</code>
| Eingehender Audiostream als binärer Datei-Upload
|}

'''Ergebnis:'''

* Der über <code>externalId</code> identifizierte Anruf wird aktualisiert.
* Der eingehende und der ausgehende Audiostream werden dem Anruf zugeordnet.
* Das Benutzerkürzel aus <code>ownerInitial</code> kennzeichnet den internen Gesprächsteilnehmer.
* Die Audiostreams werden automatisch verarbeitet.
* Im Anruf wird eine automatische Transkription beziehungsweise Anrufzusammenfassung gespeichert.
* Die zugehörigen Audiodateien bleiben beim Anruf verfügbar.

'''Hinweis:''' Die Zuordnung von <code>fileSourceOut</code> und <code>fileSourceIn</code> richtet sich nach der Perspektive beziehungsweise Exportlogik des angebundenen Telefonsystems. Bei der STARFACE-Integration kann die Bezeichnung innerhalb des Dateinamens von der Bezeichnung des API-Parameters abweichen. Maßgeblich ist daher die im Integrationsmodul konfigurierte Zuordnung.

Anruf HTTP GET Schnittstelle V2

2026-10-22T13:42:15Z

Karsten:

= 📞 Anruf-API – Version 2 =

Die '''Anruf-API''' dient dazu, Anrufe per Webhook in die CRM-Infrastruktur ''infra-struktur'' einzutragen und zu aktualisieren.
Die Schnittstelle kann per '''HTTP GET''' oder '''POST''' aufgerufen werden – '''GET hat Vorrang'''.

== 1. Anruf eintragen ==

'''Endpoint:'''
<code>http://[instance]-classic.infra-struktur.[eu|com]/api/calllist/index.php</code>

=== Pflichtparameter ===
{| class="wikitable"
! Parameter
! Beschreibung
|-
| isdnKey
| Der ISDN-Key
|-
| location
| Name eines in der Anrufliste konfigurierten Standortes
|-
| msn
| Name einer in der Anrufliste konfigurierten eingehenden Rufnummer/Nebenstelle
|-
| number
| Rufnummer des Anrufers ('''muss URL-encodiert werden''', z. B. <code>+492941247790</code> → <code>%2B492941247790</code>)
|}

=== Optionale Parameter ===
{| class="wikitable"
! Parameter
! Beschreibung
|-
| reason
| Base64-codierter Grund des Anrufs
|-
| fileSource
| Base64-codierter Inhalt einer Datei
|-
| fileType
| Dateityp (Standard: <code>fax</code>)
|-
| mimeType
| MIME-Type (Standard: <code>application/download</code>)
|-
| timestamp
| Unix-Timestamp (Standard: Zeitpunkt des Aufrufs)
|-
| direction
| <code>"in"</code> oder <code>"out"</code> (Standard: <code>in</code>)
|-
| duration
| Dauer in Minuten eines Anrufs.
|-
| externalId
| Eine eigene ID des Telefonsystems über den ich später mit dem update Aufruf einen Eintrag exakt diesem Eintrag zuordnen kann.
|}

=== Rückgabe/Response ===
{| class="wikitable"
! Parameter
! Beschreibung
|-
|Done XYZ
|Der Wert "Done" zeigt den erfolgreichen Eintrag an gefolgt von der vom System vergebenen ID. Über die kann der Anruf später weiter aktualisiert werden.
|}

== 2. Anruf aktualisieren ==

'''Endpoint:'''
<code>http://[instance]-classic.infra-struktur.[eu|com]/api/calllist/update.php</code>

=== Pflichtparameter ===
{| class="wikitable"
! Parameter
! Beschreibung
|-
| isdnKey
| Der ISDN-Key
|-
| number
| Rufnummer des zu aktualisierenden Anrufs ('''muss URL-encodiert werden''') (Wird nicht gebraucht wenn eine externalId übergeben wird.)
|}

Mit der Rufnummer wird nach Anrufen in den letzten 60 Minuten mit der gleichen Rufnummer gesucht und der Anruf wird dann für den Grund verwendet.

=== Optionale Parameter ===
{| class="wikitable"
! Parameter
! Beschreibung
|-
| AnrufID
| ID des Anrufs (hat Vorrang vor <code>number</code>)
|-
| externalId
| wurde beim initialen Eintrag des Anrufs eine externalId übergeben kann das update damit genau auf den Eintrag gemünzt werden.
|-
| reason
| Grund (Base64 oder Klartext, bei GET zusätzlich URL-encodiert)
|-
| reasonAppend
| Ergänzung zum Grund (Base64 oder Klartext, bei GET zusätzlich URL-encodiert)
|-
| acceptedBy
| Benutzerkürzel für „angenommen durch“
|-
| callFor
| Benutzerkürzel für „Anruf für“
|-
| recall
| Angabe, ob ein Rückruf gewünscht ist als "ja" oder "nein"
|}

== 3. Sonderfall: OpenAI Whisper Integration 🎙️ ==

Jede ''infra-struktur''-Instanz verfügt über einen lokalen Whisper-Server, der Audiodateien automatisch transkribiert.
Die '''Transkription wird im Anruf gespeichert''', die Originaldatei bleibt zusätzlich im Anruf per Mediaplayer abspielbar.

=== Parameter ===
{| class="wikitable"
! Parameter
! Beschreibung
|-
| fileSourceRaw
| Audiodatei im '''Binary-Format''' (nur via '''POST''' möglich, wegen Größe und Format)
|}

=== 3.1 Gesprächszusammenfassung mit getrennten Audiostreams ===

Alternativ zu einer einzelnen Audiodatei können der eingehende und der ausgehende Audiostream eines Gesprächs getrennt übertragen werden.

Die beiden Audiodateien werden dem über die <code>externalId</code> identifizierten Anruf zugeordnet und zur automatischen Transkription und Erstellung einer '''Anrufzusammenfassung''' verarbeitet.

Der Aufruf ist aufgrund der binären Audiodateien ausschließlich per '''HTTP POST''' mit <code>multipart/form-data</code> möglich.

==== Parameter ====

{| class="wikitable"
! Parameter
! Beschreibung
|-
| externalId
| Eindeutige ID des Gesprächs aus dem Telefonsystem. Die ID muss bereits beim initialen Eintragen des Anrufs übergeben worden sein und ordnet die Audiodateien exakt dem zugehörigen Anruf zu.
|-
| ownerInitial
| Benutzerkürzel des internen Benutzers, der das Gespräch geführt hat, beispielsweise <code>CT</code>.
|-
| fileSourceOut
| Binäre Audiodatei mit dem '''ausgehenden Audiostream''' des Gesprächs. Die Datei muss als Datei-Upload per <code>multipart/form-data</code> übertragen werden.
|-
| fileSourceIn
| Binäre Audiodatei mit dem '''eingehenden Audiostream''' des Gesprächs. Die Datei muss als Datei-Upload per <code>multipart/form-data</code> übertragen werden.
|}

Die Parameter <code>fileSourceOut</code> und <code>fileSourceIn</code> ermöglichen eine getrennte Verarbeitung beider Gesprächsseiten. Dadurch kann der interne Benutzer über <code>ownerInitial</code> dem Gespräch zugeordnet und eine automatische Zusammenfassung des Telefonats erzeugt werden.

Mindestens die zur eindeutigen Zuordnung benötigten Parameter <code>isdnKey</code> und <code>externalId</code> müssen übergeben werden.

== 4. Fehlercodes ==

=== 4.1 Fehlende Parameter ===
{| class="wikitable"
! Code
! Beschreibung
|-
| 1001
| isdnKey fehlt
|-
| 1002
| location fehlt
|-
| 1003
| msn fehlt
|-
| 1004
| number fehlt
|}

=== 4.2 Datenbankverbindung ===
{| class="wikitable"
! Code
! Beschreibung
|-
| 2001
| host fehlt
|-
| 2002
| username fehlt
|-
| 2003
| password fehlt
|-
| 2004
| database fehlt
|-
| 3001
| Verbindungsfehler (MySQLi)
|}

=== 4.3 Datenbankabfragen ===
Fehler bei einzelnen Abfragen, z. B.:
* 3102 – kein Standort mit dem Namen gefunden
* 3105 – MSN ist keine Fax-MSN
* 3113 – Fehler beim Einfügen eines Anrufs in die Calllist
* 3115 – Fehler beim Setzen eines Grundes

(Alle Fehler mit MySQLi-Fehlernummer und Fehlermeldung.)

=== 4.4 API-Fehler ===
{| class="wikitable"
! Code
! Beschreibung
|-
| 4001
| Ungültiger ISDN-Key
|-
| 4002
| ISDN-Key wurde noch nicht validiert
|-
| 4101
| Rufnummer zu kurz
|-
| 4102
| Rufnummer ist ein „Hidden Signal“
|-
| 4103
| Anruf liegt innerhalb der Signaltoleranz
|-
| 4104
| Keine passende Anrufliste für MSN & Standort gefunden
|}

== 5. Beispiele ==

=== 5.1 POST-Beispiel: Audiodatei hochladen & transkribieren (Whisper) ===
<pre>
curl -X POST "http://[instance]-classic.infra-struktur.eu/api/calllist/update.php" \
-F "isdnKey=DEIN_ISDN_KEY" \
-F "number=%2B492941247790" \
-F "fileSourceRaw=@anruf.mp3;type=audio/mpeg"
</pre>

Ergebnis:
* Die Datei ''anruf.mp3'' wird an den Anruf angehängt.
* Der Whisper-Server erzeugt eine '''Transkription''' und speichert sie im Anruf.
* Die Originaldatei ist zusätzlich im CRM über einen Mediaplayer abspielbar.

=== 5.2 POST-Beispiel: Audiodatei mit zusätzlichen Parametern ===
<pre>
curl -X POST "http://[instance]-classic.infra-struktur.eu/api/calllist/update.php" \
-F "isdnKey=DEIN_ISDN_KEY" \
-F "number=%2B492941247790" \
-F "reason=Kundenrückruf" \
-F "acceptedBy=AB" \
-F "fileSourceRaw=@anruf.mp3;type=audio/mpeg"
</pre>

Hier wird neben der Audiodatei zusätzlich ein '''Anrufgrund''' gesetzt (reason) und ein Bearbeiter eingetragen (acceptedBy).

=== 5.3 GET-Beispiel: Text-Update ohne Datei ===
<pre>
curl "http://[instance]-classic.infra-struktur.eu/api/calllist/update.php?isdnKey=DEIN_ISDN_KEY&number=%2B492941247790&reason=Rückruf+gewünscht&acceptedBy=AB"
</pre>

Ergebnis:
* Der Anruf mit der Nummer <code>+492941247790</code> wird aktualisiert.
* Als Grund wird ''Rückruf gewünscht'' gespeichert.
* Der Anruf wird als '''angenommen durch Benutzer AB''' markiert.

=== 5.4 POST-Beispiel: Getrennte Audiostreams hochladen und Anruf zusammenfassen ===

<pre>
curl -X POST "https://netzkultur-classic.infra-struktur.com/api/calllist/update.php" \
-H "Content-Type: multipart/form-data" \
-F "isdnKey=247790" \
-F "ownerInitial=CT" \
-F "externalId=21cf1ada-a93c-4436-b3c9-eb404c1b954c" \
-F "fileSourceOut=@/var/starface/module/instances/repo/5dd8302c-eb41-4a3d-8479-29755315f960/var/files/monitor/21cf1ada-a93c-4436-b3c9-eb404c1b954c_00492941272630_0049532134070-in.wav" \
-F "fileSourceIn=@/var/starface/module/instances/repo/5dd8302c-eb41-4a3d-8479-29755315f960/var/files/monitor/21cf1ada-a93c-4436-b3c9-eb404c1b954c_00492941272630_0049532134070-out.wav"
</pre>

'''Bedeutung der Parameter:'''

{| class="wikitable"
! Parameter
! Beispielwert
! Bedeutung
|-
| isdnKey
| <code>247790</code>
| ISDN-Key der ''infra-struktur''-Instanz
|-
| ownerInitial
| <code>CT</code>
| Kürzel des internen Benutzers, der das Gespräch geführt hat
|-
| externalId
| <code>21cf1ada-a93c-4436-b3c9-eb404c1b954c</code>
| Eindeutige Gesprächs-ID des Telefonsystems
|-
| fileSourceOut
| <code>@/pfad/zum/audiostream.wav</code>
| Ausgehender Audiostream als binärer Datei-Upload
|-
| fileSourceIn
| <code>@/pfad/zum/audiostream.wav</code>
| Eingehender Audiostream als binärer Datei-Upload
|}

'''Ergebnis:'''

* Der über <code>externalId</code> identifizierte Anruf wird aktualisiert.
* Der eingehende und der ausgehende Audiostream werden dem Anruf zugeordnet.
* Das Benutzerkürzel aus <code>ownerInitial</code> kennzeichnet den internen Gesprächsteilnehmer.
* Die Audiostreams werden automatisch verarbeitet.
* Im Anruf wird eine automatische Transkription beziehungsweise Anrufzusammenfassung gespeichert.
* Die zugehörigen Audiodateien bleiben beim Anruf verfügbar.

'''Hinweis:''' Die Zuordnung von <code>fileSourceOut</code> und <code>fileSourceIn</code> richtet sich nach der Perspektive beziehungsweise Exportlogik des angebundenen Telefonsystems. Bei der STARFACE-Integration kann die Bezeichnung innerhalb des Dateinamens von der Bezeichnung des API-Parameters abweichen. Maßgeblich ist daher die im Integrationsmodul konfigurierte Zuordnung.

Anruf HTTP GET Schnittstelle V2

2026-10-22T13:41:17Z

Karsten:

= 📞 Anruf-API – Version 2 =

Die '''Anruf-API''' dient dazu, Anrufe per Webhook in die CRM-Infrastruktur ''infra-struktur'' einzutragen und zu aktualisieren.
Die Schnittstelle kann per '''HTTP GET''' oder '''POST''' aufgerufen werden – '''GET hat Vorrang'''.

== 1. Anruf eintragen ==

'''Endpoint:'''
<code>http://[instance]-classic.infra-struktur.[eu|com]/api/calllist/index.php</code>

=== Pflichtparameter ===
{| class="wikitable"
! Parameter
! Beschreibung
|-
| isdnKey
| Der ISDN-Key
|-
| location
| Name eines in der Anrufliste konfigurierten Standortes
|-
| msn
| Name einer in der Anrufliste konfigurierten eingehenden Rufnummer/Nebenstelle
|-
| number
| Rufnummer des Anrufers ('''muss URL-encodiert werden''', z. B. <code>+492941247790</code> → <code>%2B492941247790</code>)
|}

=== Optionale Parameter ===
{| class="wikitable"
! Parameter
! Beschreibung
|-
| reason
| Base64-codierter Grund des Anrufs
|-
| fileSource
| Base64-codierter Inhalt einer Datei
|-
| fileType
| Dateityp (Standard: <code>fax</code>)
|-
| mimeType
| MIME-Type (Standard: <code>application/download</code>)
|-
| timestamp
| Unix-Timestamp (Standard: Zeitpunkt des Aufrufs)
|-
| direction
| <code>"in"</code> oder <code>"out"</code> (Standard: <code>in</code>)
|-
| duration
| Dauer in Minuten eines Anrufs.
|-
| externalId
| Eine eigene ID des Telefonsystems über den ich später mit dem update Aufruf einen Eintrag exakt diesem Eintrag zuordnen kann.
|}

=== Rückgabe/Response ===
{| class="wikitable"
! Parameter
! Beschreibung
|-
|Done XYZ
|Der Wert "Done" zeigt den erfolgreichen Eintrag an gefolgt von der vom System vergebenen ID. Über die kann der Anruf später weiter aktualisiert werden.
|}

== 2. Anruf aktualisieren ==

'''Endpoint:'''
<code>http://[instance]-classic.infra-struktur.[eu|com]/api/calllist/update.php</code>

=== Pflichtparameter ===
{| class="wikitable"
! Parameter
! Beschreibung
|-
| isdnKey
| Der ISDN-Key
|-
| number
| Rufnummer des zu aktualisierenden Anrufs ('''muss URL-encodiert werden''') (Wird nicht gebraucht wenn eine externalId übergeben wird.)
|}

Mit der Rufnummer wird nach Anrufen in den letzten 60 Minuten mit der gleichen Rufnummer gesucht und der Anruf wird dann für den Grund verwendet.

=== Optionale Parameter ===
{| class="wikitable"
! Parameter
! Beschreibung
|-
| AnrufID
| ID des Anrufs (hat Vorrang vor <code>number</code>)
|-
| externalId
| wurde beim initialen Eintrag des Anrufs eine externalId übergeben kann das update damit genau auf den Eintrag gemünzt werden.
|-
| reason
| Grund (Base64 oder Klartext, bei GET zusätzlich URL-encodiert)
|-
| reasonAppend
| Ergänzung zum Grund (Base64 oder Klartext, bei GET zusätzlich URL-encodiert)
|-
| acceptedBy
| Benutzerkürzel für „angenommen durch“
|-
| callFor
| Benutzerkürzel für „Anruf für“
|-
| recall
| Angabe, ob ein Rückruf gewünscht ist als "ja" oder "nein"
|}

== 3. Sonderfall: OpenAI Whisper Integration 🎙️ ==

Jede ''infra-struktur''-Instanz verfügt über einen lokalen Whisper-Server, der Audiodateien automatisch transkribiert.
Die '''Transkription wird im Anruf gespeichert''', die Originaldatei bleibt zusätzlich im Anruf per Mediaplayer abspielbar.

=== Parameter ===
{| class="wikitable"
! Parameter
! Beschreibung
|-
| fileSourceRaw
| Audiodatei im '''Binary-Format''' (nur via '''POST''' möglich, wegen Größe und Format)
|}

== 4. Fehlercodes ==

=== 4.1 Fehlende Parameter ===
{| class="wikitable"
! Code
! Beschreibung
|-
| 1001
| isdnKey fehlt
|-
| 1002
| location fehlt
|-
| 1003
| msn fehlt
|-
| 1004
| number fehlt
|}

=== 4.2 Datenbankverbindung ===
{| class="wikitable"
! Code
! Beschreibung
|-
| 2001
| host fehlt
|-
| 2002
| username fehlt
|-
| 2003
| password fehlt
|-
| 2004
| database fehlt
|-
| 3001
| Verbindungsfehler (MySQLi)
|}

=== 4.3 Datenbankabfragen ===
Fehler bei einzelnen Abfragen, z. B.:
* 3102 – kein Standort mit dem Namen gefunden
* 3105 – MSN ist keine Fax-MSN
* 3113 – Fehler beim Einfügen eines Anrufs in die Calllist
* 3115 – Fehler beim Setzen eines Grundes

(Alle Fehler mit MySQLi-Fehlernummer und Fehlermeldung.)

=== 4.4 API-Fehler ===
{| class="wikitable"
! Code
! Beschreibung
|-
| 4001
| Ungültiger ISDN-Key
|-
| 4002
| ISDN-Key wurde noch nicht validiert
|-
| 4101
| Rufnummer zu kurz
|-
| 4102
| Rufnummer ist ein „Hidden Signal“
|-
| 4103
| Anruf liegt innerhalb der Signaltoleranz
|-
| 4104
| Keine passende Anrufliste für MSN & Standort gefunden
|}

== 5. Beispiele ==

=== 5.1 POST-Beispiel: Audiodatei hochladen & transkribieren (Whisper) ===
<pre>
curl -X POST "http://[instance]-classic.infra-struktur.eu/api/calllist/update.php" \
-F "isdnKey=DEIN_ISDN_KEY" \
-F "number=%2B492941247790" \
-F "fileSourceRaw=@anruf.mp3;type=audio/mpeg"
</pre>

Ergebnis:
* Die Datei ''anruf.mp3'' wird an den Anruf angehängt.
* Der Whisper-Server erzeugt eine '''Transkription''' und speichert sie im Anruf.
* Die Originaldatei ist zusätzlich im CRM über einen Mediaplayer abspielbar.

=== 5.2 POST-Beispiel: Audiodatei mit zusätzlichen Parametern ===
<pre>
curl -X POST "http://[instance]-classic.infra-struktur.eu/api/calllist/update.php" \
-F "isdnKey=DEIN_ISDN_KEY" \
-F "number=%2B492941247790" \
-F "reason=Kundenrückruf" \
-F "acceptedBy=AB" \
-F "fileSourceRaw=@anruf.mp3;type=audio/mpeg"
</pre>

Hier wird neben der Audiodatei zusätzlich ein '''Anrufgrund''' gesetzt (reason) und ein Bearbeiter eingetragen (acceptedBy).

=== 5.3 GET-Beispiel: Text-Update ohne Datei ===
<pre>
curl "http://[instance]-classic.infra-struktur.eu/api/calllist/update.php?isdnKey=DEIN_ISDN_KEY&number=%2B492941247790&reason=Rückruf+gewünscht&acceptedBy=AB"
</pre>

Ergebnis:
* Der Anruf mit der Nummer <code>+492941247790</code> wird aktualisiert.
* Als Grund wird ''Rückruf gewünscht'' gespeichert.
* Der Anruf wird als '''angenommen durch Benutzer AB''' markiert.

=== 5.4 POST-Beispiel: Getrennte Audiostreams hochladen und Anruf zusammenfassen ===

<pre>
curl -X POST "https://netzkultur-classic.infra-struktur.com/api/calllist/update.php" \
-H "Content-Type: multipart/form-data" \
-F "isdnKey=247790" \
-F "ownerInitial=CT" \
-F "externalId=21cf1ada-a93c-4436-b3c9-eb404c1b954c" \
-F "fileSourceOut=@/var/starface/module/instances/repo/5dd8302c-eb41-4a3d-8479-29755315f960/var/files/monitor/21cf1ada-a93c-4436-b3c9-eb404c1b954c_00492941272630_0049532134070-in.wav" \
-F "fileSourceIn=@/var/starface/module/instances/repo/5dd8302c-eb41-4a3d-8479-29755315f960/var/files/monitor/21cf1ada-a93c-4436-b3c9-eb404c1b954c_00492941272630_0049532134070-out.wav"
</pre>

'''Bedeutung der Parameter:'''

{| class="wikitable"
! Parameter
! Beispielwert
! Bedeutung
|-
| isdnKey
| <code>247790</code>
| ISDN-Key der ''infra-struktur''-Instanz
|-
| ownerInitial
| <code>CT</code>
| Kürzel des internen Benutzers, der das Gespräch geführt hat
|-
| externalId
| <code>21cf1ada-a93c-4436-b3c9-eb404c1b954c</code>
| Eindeutige Gesprächs-ID des Telefonsystems
|-
| fileSourceOut
| <code>@/pfad/zum/audiostream.wav</code>
| Ausgehender Audiostream als binärer Datei-Upload
|-
| fileSourceIn
| <code>@/pfad/zum/audiostream.wav</code>
| Eingehender Audiostream als binärer Datei-Upload
|}

'''Ergebnis:'''

* Der über <code>externalId</code> identifizierte Anruf wird aktualisiert.
* Der eingehende und der ausgehende Audiostream werden dem Anruf zugeordnet.
* Das Benutzerkürzel aus <code>ownerInitial</code> kennzeichnet den internen Gesprächsteilnehmer.
* Die Audiostreams werden automatisch verarbeitet.
* Im Anruf wird eine automatische Transkription beziehungsweise Anrufzusammenfassung gespeichert.
* Die zugehörigen Audiodateien bleiben beim Anruf verfügbar.

'''Hinweis:''' Die Zuordnung von <code>fileSourceOut</code> und <code>fileSourceIn</code> richtet sich nach der Perspektive beziehungsweise Exportlogik des angebundenen Telefonsystems. Bei der STARFACE-Integration kann die Bezeichnung innerhalb des Dateinamens von der Bezeichnung des API-Parameters abweichen. Maßgeblich ist daher die im Integrationsmodul konfigurierte Zuordnung.

Anruf HTTP GET Schnittstelle V2

2025-11-06T15:12:05Z

Karsten: /* 2. Anruf aktualisieren */

Anruf HTTP GET Schnittstelle V2

2025-11-06T15:10:06Z

Karsten: /* Rückgabe/Response */

Anruf HTTP GET Schnittstelle V2

2025-11-06T15:09:38Z

Karsten: /* 1. Anruf eintragen */

Anruf HTTP GET Schnittstelle V2

2025-11-06T14:46:54Z

Karsten:

Anruf HTTP GET Schnittstelle V2

2025-09-16T14:15:54Z

Karsten: /* Pflichtparameter */

Anruf HTTP GET Schnittstelle V2

2025-08-22T10:30:22Z

Karsten:

Anruf HTTP GET Schnittstelle V2

2025-08-22T10:28:34Z

Karsten:

Anruf HTTP GET Schnittstelle V2

2025-08-22T10:23:55Z

Karsten:

Anruf HTTP GET Schnittstelle V2

2025-08-22T10:19:50Z

Karsten:

'''Anruflisten API'''

Adresse: http://[instance]-classic.infra-struktur.[eu|com]/api/calllist/index.php

Übergabe als webhook per GET oder POST (GET hat Vorrang vor POST)

'''Folgende Werte müssen übergeben werden:'''
isdnKey - Der ISDN-Key.
location - Der Name eines in der Anrufliste konfigurierten Standortes.
msn - Der Name einer in der Anrufliste konfigurierten eingehenden Rufnummern/Nebenstellen.
number - Die Nummer des Anrufers.

Es sollte beachtet werden, das z.b. die Nummer „+492941247790“ zur Übergabe als Parameter codiert werden muss, damit das führende + auf dem Server passend ausgewertet werden kann. (http://de.wikipedia.org/wiki/URL-Encoding)

'''Folgende Werte können übergeben werden:'''
reason - Der base64 codierte Grund eines Anrufes.
fileSource - Der base64 codierte Inhalt einer Datei.
fileType - Der Typ einer Datei. Der Standardwert liegt auf „fax“.
mimeType - Der mimetype einer Datei. Der Standardwert liegt auf „application/download“.
timestamp - Ein Unixtimestamp mit der der Eintrag erzeugt werden soll. Der Standardwert liegt auf dem Zeitpunkt des Aufrufs.
direction - entweder "in" oder "out für eingehende oder ausgehende Anrufe. Default ist "in".

'''Um einen bestehenden Anruf zu aktualisieren kann folgender Webhook genutzt werden.'''

Adresse: http://[instance]-classic.infra-struktur.[eu|com]/api/calllist/update.php

Übergabe als webhook per GET oder POST (GET hat Vorrang vor POST)

'''Folgende Werte müssen übergeben werden:'''
isdnKey - Der ISDN-Key.
number - Die Nummer des Anrufs der aktualisiert werden soll.

Es sollte beachtet werden, das z.b. die Nummer „+492941247790“ zur Übergabe als Parameter codiert werden muss, damit das führende + auf dem Server passend ausgewertet werden kann. (http://de.wikipedia.org/wiki/URL-Encoding)

'''Folgende Werte können übergeben werden:'''
id - die ID des Anrufs die beim anlegen des Anrufs zurückgegeben wurde. Die hat auch vorrang vor einer übergebenen Rufnummer.
reason - ein Anrufgrund der als base64 oder im Klartext übergeben werden kann. Als GET ert muss das natürlich URLencoded werden.
reasonAppend - ein Ergänzung zu einem Anrufgrund der als base64 oder im Klartext übergeben werden kann. Als GET ert muss das natürlich URLencoded werden.
acceptedBy - das Kürzel des Benutzer der in "angenommen durch" eingetragen werden soll.
callFor - das Kürzel des Benutzer der in "Anruf für" eingetragen werden soll.
recall - Die Information ob ein Rückruf gewünscht ist.
'''Sonderfall OpenAI Whisper Integration'''
Jede infra-struktur hat einen integrierten lokalen Whisper-Server der aus Audiodateien transkriptionen erzeugen kann.
Dafür kann der update.php eine Audiodatei übergeben werden. Diese wird dann in Text gewandelt und der Text wird in den Anruf geschrieben. Die Audiodatei
ist mit einem Mediaplayer auch noch abspielbar unter dem Anruf.

fileSourceRaw - Eine Audiodatei im binary Format. Aufgrund des Formats und der Größe nur mit POST zu nutzen.

'''Es können folgende Fehlerwerte auftreten:'''

1001 - MISSING_MANDATORY_REQUEST_PARAM_ISDNKEY

Meldung: „isdnKey“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

1002 - MISSING_MANDATORY_REQUEST_PARAM_LOCATION

Meldung: „location“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

1003 - MISSING_MANDATORY_REQUEST_PARAM_MSN

Meldung: „msn“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

1004 - MISSING_MANDATORY_REQUEST_PARAM_NUMBER

Meldung: „number“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

2001 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_HOST

Meldung: „host“ database connection param is mandatory, please contact the support

2002 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_USERNAME

Meldung: „username“ database connection param is mandatory, please contact the support

2003 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_PASSWORD

Meldung: „password“ database connection param is mandatory, please contact the support

2004 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_DATABASE

Meldung: „database“ database connection param is mandatory, please contact the support

3001 - DATABASE_CONNECTION_CREATE

Meldung: Connection Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3101 - DATABASE_QUERY_ON_VALIDATE_ISDNKEY_IN_DB

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3102 - DATABASE_QUERY_ON_GET_LOCATIONID_BY_LOCATIONNAME

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the location id by location name

3103 - DATABASE_QUERY_ON_GET_LOCATION_CONFIGURATION

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the location configuration

3104 - DATABASE_QUERY_ON_GET_INTERNATIONAL_PREFIX_ID_BY_INTERNATIONAL_PREFIX

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the internationalPrefixId

3105 - DATABASE_QUERY_ON_IS_MSN_A_FAX_MSN_FOR_MSN_AND_LOCATIONID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while checking if the msn is a fax msn

3106 - DATABASE_QUERY_ON_CHECK_SIGNAL_TOLERANCE

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3107 - DATABASE_QUERY_ON_GET_LIST_ID_FOR_MSN_AND_LOCATION_ID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the list id for msn and location id

3108 - DATABASE_QUERY_ON_GET_NUMBER_TO_NAME_ID_BY_NUMBER

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3109 - DATABASE_QUERY_ON_GET_MSN_ID_BY_MSN_AND_LOCATION_ID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the msn id by msn and location id

3110 - DATABASE_QUERY_ON_INSERT_ENTRY

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3111 - DATABASE_QUERY_ON_CITY_NAME_BY_PREFIX_AND_INTERNATIONAL_PREFIX

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3112 - DATABASE_QUERY_ON_FORMAT_NUMBER_WITH_LOCATION

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3113 - DATABASE_QUERY_ON_INSERT_CALL_TO_CALLLIST

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3114 - DATABASE_QUERY_ON_INSERT_FILE

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3115 - DATABASE_QUERY_ON_SET_REASON

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3116 - DATABASE_QUERY_ON_GET_COUNTRY_NAME_FOR_NATIONAL_PREFIX_ID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

4001 - API_INVALID_ISDNKEY

Meldung: the provided isdn key „[isdnKey]“ is not valid

4002 - API_NOT_VALIDATED

Meldung: you first need to validate your isdn key

4101 - API_MINIMUM_NUMBER_LENGTH

Meldung: the number „[number]“ is below the required minimum number length of [minimumNumberLength]

4102 - API_NUMBER_IS_HIDDEN_SIGNAL

Meldung: the number „[number]“ is the hidden signal „[hiddenSignal]“

4103 - API_CALL_IS_WITHIN_SIGNAL_TOLERANCE

Meldung: the call from the number „[number]“ is within the signal tolerance of [signalTolerance] seconds

4104 - API_NO_CALLLIST_FOUND

Meldung: no appropriate call list found for MSN „[msn]“ and location id [locationId]

Anruf HTTP GET Schnittstelle V2

2025-08-22T10:19:07Z

Karsten:

Anruf HTTP GET Schnittstelle V2

2025-08-22T10:07:15Z

Karsten:

'''Anruflisten API'''

Adresse: http://[instance]-classic.infra-struktur.[eu|com]/api/calllist/index.php

Übergabe als webhook per GET oder POST (GET hat Vorrang vor POST)

'''Folgende Werte müssen übergeben werden:'''
isdnKey - Der ISDN-Key.
location - Der Name eines in der Anrufliste konfigurierten Standortes.
msn - Der Name einer in der Anrufliste konfigurierten eingehenden Rufnummern/Nebenstellen.
number - Die Nummer des Anrufers.

Es sollte beachtet werden, das z.b. die Nummer „+492941247790“ zur Übergabe als Parameter codiert werden muss, damit das führende + auf dem Server passend ausgewertet werden kann. (http://de.wikipedia.org/wiki/URL-Encoding)

'''Folgende Werte können übergeben werden:'''
reason - Der base64 codierte Grund eines Anrufes.
fileSource - Der base64 codierte Inhalt einer Datei.
fileType - Der Typ einer Datei. Der Standardwert liegt auf „fax“.
mimeType - Der mimetype einer Datei. Der Standardwert liegt auf „application/download“.
timestamp - Ein Unixtimestamp mit der der Eintrag erzeugt werden soll. Der Standardwert liegt auf dem Zeitpunkt des Aufrufs.
direction - entweder "in" oder "out für eingehende oder ausgehende Anrufe. Default ist "in".

'''Um einen bestehenden Anruf zu aktualisieren kann folgender Webhook genutzt werden.'''

Adresse: http://[instance]-classic.infra-struktur.[eu|com]/api/calllist/update.php

Übergabe als webhook per GET oder POST (GET hat Vorrang vor POST)

'''Folgende Werte müssen übergeben werden:'''
isdnKey - Der ISDN-Key.
number - Die Nummer des Anrufs der aktualisiert werden soll.

Es sollte beachtet werden, das z.b. die Nummer „+492941247790“ zur Übergabe als Parameter codiert werden muss, damit das führende + auf dem Server passend ausgewertet werden kann. (http://de.wikipedia.org/wiki/URL-Encoding)

'''Folgende Werte können übergeben werden:'''
id - die ID des Anrufs die beim anlegen des Anrufs zurückgegeben wurde. Die hat auch vorrang vor einer übergebenen Rufnummer.
reason - ein Anrufgrund der als base64 oder im Klartext übergeben werden kann. Als GET ert muss das natürlich URLencoded werden.
reasonAppend - ein Ergänzung zu einem Anrufgrund der als base64 oder im Klartext übergeben werden kann. Als GET ert muss das natürlich URLencoded werden.
acceptedBy - das Kürzel des Benutzer der in "angenommen durch" eingetragen werden soll.
callFor - das Kürzel des Benutzer der in "Anruf für" eingetragen werden soll.
recall - Die Information ob ein Rückruf gewünscht ist.
fileSourceRaw - Eine Binärdatei im base64 Format. Falls unterstützt wird die Datei als Vorschau oder mit Mediaplayer angezeigt.

'''Es können folgende Fehlerwerte auftreten:'''

1001 - MISSING_MANDATORY_REQUEST_PARAM_ISDNKEY

Meldung: „isdnKey“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

1002 - MISSING_MANDATORY_REQUEST_PARAM_LOCATION

Meldung: „location“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

1003 - MISSING_MANDATORY_REQUEST_PARAM_MSN

Meldung: „msn“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

1004 - MISSING_MANDATORY_REQUEST_PARAM_NUMBER

Meldung: „number“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

2001 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_HOST

Meldung: „host“ database connection param is mandatory, please contact the support

2002 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_USERNAME

Meldung: „username“ database connection param is mandatory, please contact the support

2003 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_PASSWORD

Meldung: „password“ database connection param is mandatory, please contact the support

2004 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_DATABASE

Meldung: „database“ database connection param is mandatory, please contact the support

3001 - DATABASE_CONNECTION_CREATE

Meldung: Connection Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3101 - DATABASE_QUERY_ON_VALIDATE_ISDNKEY_IN_DB

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3102 - DATABASE_QUERY_ON_GET_LOCATIONID_BY_LOCATIONNAME

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the location id by location name

3103 - DATABASE_QUERY_ON_GET_LOCATION_CONFIGURATION

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the location configuration

3104 - DATABASE_QUERY_ON_GET_INTERNATIONAL_PREFIX_ID_BY_INTERNATIONAL_PREFIX

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the internationalPrefixId

3105 - DATABASE_QUERY_ON_IS_MSN_A_FAX_MSN_FOR_MSN_AND_LOCATIONID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while checking if the msn is a fax msn

3106 - DATABASE_QUERY_ON_CHECK_SIGNAL_TOLERANCE

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3107 - DATABASE_QUERY_ON_GET_LIST_ID_FOR_MSN_AND_LOCATION_ID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the list id for msn and location id

3108 - DATABASE_QUERY_ON_GET_NUMBER_TO_NAME_ID_BY_NUMBER

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3109 - DATABASE_QUERY_ON_GET_MSN_ID_BY_MSN_AND_LOCATION_ID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the msn id by msn and location id

3110 - DATABASE_QUERY_ON_INSERT_ENTRY

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3111 - DATABASE_QUERY_ON_CITY_NAME_BY_PREFIX_AND_INTERNATIONAL_PREFIX

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3112 - DATABASE_QUERY_ON_FORMAT_NUMBER_WITH_LOCATION

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3113 - DATABASE_QUERY_ON_INSERT_CALL_TO_CALLLIST

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3114 - DATABASE_QUERY_ON_INSERT_FILE

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3115 - DATABASE_QUERY_ON_SET_REASON

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3116 - DATABASE_QUERY_ON_GET_COUNTRY_NAME_FOR_NATIONAL_PREFIX_ID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

4001 - API_INVALID_ISDNKEY

Meldung: the provided isdn key „[isdnKey]“ is not valid

4002 - API_NOT_VALIDATED

Meldung: you first need to validate your isdn key

4101 - API_MINIMUM_NUMBER_LENGTH

Meldung: the number „[number]“ is below the required minimum number length of [minimumNumberLength]

4102 - API_NUMBER_IS_HIDDEN_SIGNAL

Meldung: the number „[number]“ is the hidden signal „[hiddenSignal]“

4103 - API_CALL_IS_WITHIN_SIGNAL_TOLERANCE

Meldung: the call from the number „[number]“ is within the signal tolerance of [signalTolerance] seconds

4104 - API_NO_CALLLIST_FOUND

Meldung: no appropriate call list found for MSN „[msn]“ and location id [locationId]

Anruf HTTP GET Schnittstelle V2

2025-08-22T09:59:00Z

Karsten:

'''Anruflisten API'''

Adresse: http://[instance]-classic.infra-struktur.[eu|com]/api/calllist/index.php

Übergabe als webhook per GET oder POST (GET hat Vorrang vor POST)

'''Folgende Werte müssen übergeben werden:'''
isdnKey - Der ISDN-Key.
location - Der Name eines in der Anrufliste konfigurierten Standortes.
msn - Der Name einer in der Anrufliste konfigurierten eingehenden Rufnummern/Nebenstellen.
number - Die Nummer des Anrufers.

Es sollte beachtet werden, das z.b. die Nummer „+492941247790“ zur Übergabe als Parameter codiert werden muss, damit das führende + auf dem Server passend ausgewertet werden kann. (http://de.wikipedia.org/wiki/URL-Encoding)

'''Folgende Werte können übergeben werden:'''
reason - Der base64 codierte Grund eines Anrufes.
fileSource - Der base64 codierte Inhalt einer Datei.
fileType - Der Typ einer Datei. Der Standardwert liegt auf „fax“.
mimeType - Der mimetype einer Datei. Der Standardwert liegt auf „application/download“.
timestamp - Ein Unixtimestamp mit der der Eintrag erzeugt werden soll. Der Standardwert liegt auf dem Zeitpunkt des Aufrufs.
direction - entweder "in" oder "out für eingehende oder ausgehende Anrufe. Default ist "in".

'''Um einen bestehenden Anruf zu aktualisieren kann folgender Webhook genutzt werden.'''

Adresse: http://[instance]-classic.infra-struktur.[eu|com]/api/calllist/update.php

Übergabe als webhook per GET oder POST (GET hat Vorrang vor POST)

'''Folgende Werte müssen übergeben werden:'''
isdnKey - Der ISDN-Key.
number - Die Nummer des Anrufs der aktualisiert werden soll.

Es sollte beachtet werden, das z.b. die Nummer „+492941247790“ zur Übergabe als Parameter codiert werden muss, damit das führende + auf dem Server passend ausgewertet werden kann. (http://de.wikipedia.org/wiki/URL-Encoding)

'''Folgende Werte können übergeben werden:'''
reason - Der base64 codierte Grund eines Anrufes.
fileSourceRaw - Der base64 codierte Inhalt einer Datei.
id - die ID des Anrufs die beim anlegen des Anrufs zurückgegeben wurde
reason - ein Anrufgrund der als base64 oder im Klartext übergeben werden kann. Als GET ert muss das natürlich URLencoded werden.
reasonAppend - ein Ergänzung zu einem Anrufgrund der als base64 oder im Klartext übergeben werden kann. Als GET ert muss das natürlich URLencoded werden.
acceptedBy - das Kürzel des Benutzer der in "angenommen durch" eingetragen werden soll.
callFor - das Kürzel des Benutzer der in "Anruf für" eingetragen werden soll.
recall - Die Information ob ein Rückrfu gewünscht ist.
fileSourceRaw - Eine Binärdatei im base64 Format. Falls unterstützt wird die Datei als Vorschau oder mit Mediaplayer angezeigt.

'''Es können folgende Fehlerwerte auftreten:'''

1001 - MISSING_MANDATORY_REQUEST_PARAM_ISDNKEY

Meldung: „isdnKey“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

1002 - MISSING_MANDATORY_REQUEST_PARAM_LOCATION

Meldung: „location“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

1003 - MISSING_MANDATORY_REQUEST_PARAM_MSN

Meldung: „msn“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

1004 - MISSING_MANDATORY_REQUEST_PARAM_NUMBER

Meldung: „number“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

2001 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_HOST

Meldung: „host“ database connection param is mandatory, please contact the support

2002 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_USERNAME

Meldung: „username“ database connection param is mandatory, please contact the support

2003 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_PASSWORD

Meldung: „password“ database connection param is mandatory, please contact the support

2004 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_DATABASE

Meldung: „database“ database connection param is mandatory, please contact the support

3001 - DATABASE_CONNECTION_CREATE

Meldung: Connection Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3101 - DATABASE_QUERY_ON_VALIDATE_ISDNKEY_IN_DB

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3102 - DATABASE_QUERY_ON_GET_LOCATIONID_BY_LOCATIONNAME

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the location id by location name

3103 - DATABASE_QUERY_ON_GET_LOCATION_CONFIGURATION

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the location configuration

3104 - DATABASE_QUERY_ON_GET_INTERNATIONAL_PREFIX_ID_BY_INTERNATIONAL_PREFIX

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the internationalPrefixId

3105 - DATABASE_QUERY_ON_IS_MSN_A_FAX_MSN_FOR_MSN_AND_LOCATIONID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while checking if the msn is a fax msn

3106 - DATABASE_QUERY_ON_CHECK_SIGNAL_TOLERANCE

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3107 - DATABASE_QUERY_ON_GET_LIST_ID_FOR_MSN_AND_LOCATION_ID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the list id for msn and location id

3108 - DATABASE_QUERY_ON_GET_NUMBER_TO_NAME_ID_BY_NUMBER

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3109 - DATABASE_QUERY_ON_GET_MSN_ID_BY_MSN_AND_LOCATION_ID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the msn id by msn and location id

3110 - DATABASE_QUERY_ON_INSERT_ENTRY

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3111 - DATABASE_QUERY_ON_CITY_NAME_BY_PREFIX_AND_INTERNATIONAL_PREFIX

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3112 - DATABASE_QUERY_ON_FORMAT_NUMBER_WITH_LOCATION

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3113 - DATABASE_QUERY_ON_INSERT_CALL_TO_CALLLIST

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3114 - DATABASE_QUERY_ON_INSERT_FILE

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3115 - DATABASE_QUERY_ON_SET_REASON

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3116 - DATABASE_QUERY_ON_GET_COUNTRY_NAME_FOR_NATIONAL_PREFIX_ID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

4001 - API_INVALID_ISDNKEY

Meldung: the provided isdn key „[isdnKey]“ is not valid

4002 - API_NOT_VALIDATED

Meldung: you first need to validate your isdn key

4101 - API_MINIMUM_NUMBER_LENGTH

Meldung: the number „[number]“ is below the required minimum number length of [minimumNumberLength]

4102 - API_NUMBER_IS_HIDDEN_SIGNAL

Meldung: the number „[number]“ is the hidden signal „[hiddenSignal]“

4103 - API_CALL_IS_WITHIN_SIGNAL_TOLERANCE

Meldung: the call from the number „[number]“ is within the signal tolerance of [signalTolerance] seconds

4104 - API_NO_CALLLIST_FOUND

Meldung: no appropriate call list found for MSN „[msn]“ and location id [locationId]

Anruf HTTP GET Schnittstelle V2

2025-08-22T09:58:28Z

Karsten:

'''Anruflisten API'''

Adresse: http://[instance]-classic.infra-struktur.[eu|com]/api/calllist/index.php

Übergabe als webhook per GET oder POST (GET hat Vorrang vor POST)

'''Folgende Werte müssen übergeben werden:'''
isdnKey - Der ISDN-Key.
location - Der Name eines in der Anrufliste konfigurierten Standortes.
msn - Der Name einer in der Anrufliste konfigurierten eingehenden Rufnummern/Nebenstellen.
number - Die Nummer des Anrufers.

Es sollte beachtet werden, das z.b. die Nummer „+492941247790“ zur Übergabe als Parameter codiert werden muss, damit das führende + auf dem Server passend ausgewertet werden kann. (http://de.wikipedia.org/wiki/URL-Encoding)

'''Folgende Werte können übergeben werden:'''
reason - Der base64 codierte Grund eines Anrufes.
fileSource - Der base64 codierte Inhalt einer Datei.
fileType - Der Typ einer Datei. Der Standardwert liegt auf „fax“.
mimeType - Der mimetype einer Datei. Der Standardwert liegt auf „application/download“.
timestamp - Ein Unixtimestamp mit der der Eintrag erzeugt werden soll. Der Standardwert liegt auf dem Zeitpunkt des Aufrufs.
direction - entweder "in" oder "out für eingehende oder ausgehende Anrufe. Default ist "in".

Um einen bestehenden Anruf zu aktualisieren kann folgender Webhook genutzt werden.

Adresse: http://[instance]-classic.infra-struktur.[eu|com]/api/calllist/update.php

Übergabe als webhook per GET oder POST (GET hat Vorrang vor POST)

'''Folgende Werte müssen übergeben werden:'''
isdnKey - Der ISDN-Key.
number - Die Nummer des Anrufs der aktualisiert werden soll.

Es sollte beachtet werden, das z.b. die Nummer „+492941247790“ zur Übergabe als Parameter codiert werden muss, damit das führende + auf dem Server passend ausgewertet werden kann. (http://de.wikipedia.org/wiki/URL-Encoding)

'''Folgende Werte können übergeben werden:'''
reason - Der base64 codierte Grund eines Anrufes.
fileSourceRaw - Der base64 codierte Inhalt einer Datei.
id - die ID des Anrufs die beim anlegen des Anrufs zurückgegeben wurde
reason - ein Anrufgrund der als base64 oder im Klartext übergeben werden kann. Als GET ert muss das natürlich URLencoded werden.
reasonAppend - ein Ergänzung zu einem Anrufgrund der als base64 oder im Klartext übergeben werden kann. Als GET ert muss das natürlich URLencoded werden.
acceptedBy - das Kürzel des Benutzer der in "angenommen durch" eingetragen werden soll.
callFor - das Kürzel des Benutzer der in "Anruf für" eingetragen werden soll.
recall - Die Information ob ein Rückrfu gewünscht ist.
fileSourceRaw - Eine Binärdatei im base64 Format. Falls unterstützt wird die Datei als Vorschau oder mit Mediaplayer angezeigt.

'''Es können folgende Fehlerwerte auftreten:'''

1001 - MISSING_MANDATORY_REQUEST_PARAM_ISDNKEY

Meldung: „isdnKey“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

1002 - MISSING_MANDATORY_REQUEST_PARAM_LOCATION

Meldung: „location“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

1003 - MISSING_MANDATORY_REQUEST_PARAM_MSN

Meldung: „msn“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

1004 - MISSING_MANDATORY_REQUEST_PARAM_NUMBER

Meldung: „number“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

2001 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_HOST

Meldung: „host“ database connection param is mandatory, please contact the support

2002 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_USERNAME

Meldung: „username“ database connection param is mandatory, please contact the support

2003 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_PASSWORD

Meldung: „password“ database connection param is mandatory, please contact the support

2004 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_DATABASE

Meldung: „database“ database connection param is mandatory, please contact the support

3001 - DATABASE_CONNECTION_CREATE

Meldung: Connection Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3101 - DATABASE_QUERY_ON_VALIDATE_ISDNKEY_IN_DB

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3102 - DATABASE_QUERY_ON_GET_LOCATIONID_BY_LOCATIONNAME

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the location id by location name

3103 - DATABASE_QUERY_ON_GET_LOCATION_CONFIGURATION

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the location configuration

3104 - DATABASE_QUERY_ON_GET_INTERNATIONAL_PREFIX_ID_BY_INTERNATIONAL_PREFIX

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the internationalPrefixId

3105 - DATABASE_QUERY_ON_IS_MSN_A_FAX_MSN_FOR_MSN_AND_LOCATIONID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while checking if the msn is a fax msn

3106 - DATABASE_QUERY_ON_CHECK_SIGNAL_TOLERANCE

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3107 - DATABASE_QUERY_ON_GET_LIST_ID_FOR_MSN_AND_LOCATION_ID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the list id for msn and location id

3108 - DATABASE_QUERY_ON_GET_NUMBER_TO_NAME_ID_BY_NUMBER

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3109 - DATABASE_QUERY_ON_GET_MSN_ID_BY_MSN_AND_LOCATION_ID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the msn id by msn and location id

3110 - DATABASE_QUERY_ON_INSERT_ENTRY

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3111 - DATABASE_QUERY_ON_CITY_NAME_BY_PREFIX_AND_INTERNATIONAL_PREFIX

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3112 - DATABASE_QUERY_ON_FORMAT_NUMBER_WITH_LOCATION

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3113 - DATABASE_QUERY_ON_INSERT_CALL_TO_CALLLIST

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3114 - DATABASE_QUERY_ON_INSERT_FILE

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3115 - DATABASE_QUERY_ON_SET_REASON

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3116 - DATABASE_QUERY_ON_GET_COUNTRY_NAME_FOR_NATIONAL_PREFIX_ID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

4001 - API_INVALID_ISDNKEY

Meldung: the provided isdn key „[isdnKey]“ is not valid

4002 - API_NOT_VALIDATED

Meldung: you first need to validate your isdn key

4101 - API_MINIMUM_NUMBER_LENGTH

Meldung: the number „[number]“ is below the required minimum number length of [minimumNumberLength]

4102 - API_NUMBER_IS_HIDDEN_SIGNAL

Meldung: the number „[number]“ is the hidden signal „[hiddenSignal]“

4103 - API_CALL_IS_WITHIN_SIGNAL_TOLERANCE

Meldung: the call from the number „[number]“ is within the signal tolerance of [signalTolerance] seconds

4104 - API_NO_CALLLIST_FOUND

Meldung: no appropriate call list found for MSN „[msn]“ and location id [locationId]

Anruf HTTP GET Schnittstelle V2

2025-08-22T09:44:20Z

Karsten:

'''Anruflisten API'''

Adresse: http://[instance]-classic.infra-struktur.[eu|com]/api/calllist/index.php

Übergabe als webhook per GET oder POST (GET hat Vorrang vor POST)

'''Folgende Werte müssen übergeben werden:'''
isdnKey - Der ISDN-Key.
location - Der Name eines in der Anrufliste konfigurierten Standortes.
msn - Der Name einer in der Anrufliste konfigurierten eingehenden Rufnummern/Nebenstellen.
number - Die Nummer des Anrufers.

Es sollte beachtet werden, das z.b. die Nummer „+492941247790“ zur Übergabe als Parameter codiert werden muss, damit das führende + auf dem Server passend ausgewertet werden kann. (http://de.wikipedia.org/wiki/URL-Encoding)

'''Folgende Werte können übergeben werden:'''
reason - Der base64 codierte Grund eines Anrufes.
fileSource - Der base64 codierte Inhalt einer Datei.
fileType - Der Typ einer Datei. Der Standardwert liegt auf „fax“.
mimeType - Der mimetype einer Datei. Der Standardwert liegt auf „application/download“.
timestamp - Ein Unixtimestamp mit der der Eintrag erzeugt werden soll. Der Standardwert liegt auf dem Zeitpunkt des Aufrufs.
direction - entweder "in" oder "out für eingehende oder ausgehende Anrufe. Default ist "in".

'''Es können folgende Fehlerwerte auftreten:'''

1001 - MISSING_MANDATORY_REQUEST_PARAM_ISDNKEY

Meldung: „isdnKey“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

1002 - MISSING_MANDATORY_REQUEST_PARAM_LOCATION

Meldung: „location“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

1003 - MISSING_MANDATORY_REQUEST_PARAM_MSN

Meldung: „msn“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

1004 - MISSING_MANDATORY_REQUEST_PARAM_NUMBER

Meldung: „number“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

2001 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_HOST

Meldung: „host“ database connection param is mandatory, please contact the support

2002 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_USERNAME

Meldung: „username“ database connection param is mandatory, please contact the support

2003 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_PASSWORD

Meldung: „password“ database connection param is mandatory, please contact the support

2004 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_DATABASE

Meldung: „database“ database connection param is mandatory, please contact the support

3001 - DATABASE_CONNECTION_CREATE

Meldung: Connection Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3101 - DATABASE_QUERY_ON_VALIDATE_ISDNKEY_IN_DB

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3102 - DATABASE_QUERY_ON_GET_LOCATIONID_BY_LOCATIONNAME

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the location id by location name

3103 - DATABASE_QUERY_ON_GET_LOCATION_CONFIGURATION

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the location configuration

3104 - DATABASE_QUERY_ON_GET_INTERNATIONAL_PREFIX_ID_BY_INTERNATIONAL_PREFIX

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the internationalPrefixId

3105 - DATABASE_QUERY_ON_IS_MSN_A_FAX_MSN_FOR_MSN_AND_LOCATIONID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while checking if the msn is a fax msn

3106 - DATABASE_QUERY_ON_CHECK_SIGNAL_TOLERANCE

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3107 - DATABASE_QUERY_ON_GET_LIST_ID_FOR_MSN_AND_LOCATION_ID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the list id for msn and location id

3108 - DATABASE_QUERY_ON_GET_NUMBER_TO_NAME_ID_BY_NUMBER

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3109 - DATABASE_QUERY_ON_GET_MSN_ID_BY_MSN_AND_LOCATION_ID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the msn id by msn and location id

3110 - DATABASE_QUERY_ON_INSERT_ENTRY

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3111 - DATABASE_QUERY_ON_CITY_NAME_BY_PREFIX_AND_INTERNATIONAL_PREFIX

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3112 - DATABASE_QUERY_ON_FORMAT_NUMBER_WITH_LOCATION

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3113 - DATABASE_QUERY_ON_INSERT_CALL_TO_CALLLIST

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3114 - DATABASE_QUERY_ON_INSERT_FILE

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3115 - DATABASE_QUERY_ON_SET_REASON

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3116 - DATABASE_QUERY_ON_GET_COUNTRY_NAME_FOR_NATIONAL_PREFIX_ID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

4001 - API_INVALID_ISDNKEY

Meldung: the provided isdn key „[isdnKey]“ is not valid

4002 - API_NOT_VALIDATED

Meldung: you first need to validate your isdn key

4101 - API_MINIMUM_NUMBER_LENGTH

Meldung: the number „[number]“ is below the required minimum number length of [minimumNumberLength]

4102 - API_NUMBER_IS_HIDDEN_SIGNAL

Meldung: the number „[number]“ is the hidden signal „[hiddenSignal]“

4103 - API_CALL_IS_WITHIN_SIGNAL_TOLERANCE

Meldung: the call from the number „[number]“ is within the signal tolerance of [signalTolerance] seconds

4104 - API_NO_CALLLIST_FOUND

Meldung: no appropriate call list found for MSN „[msn]“ and location id [locationId]

JAnrufmonitor

2025-01-10T14:50:15Z

Karsten:

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'''

Grundeinstellungen abgleichen: Ortskennzahl muss natürlich angepasst werden (im Screenshot 040 für Hamburg):

[[Datei:Grundeinstellungen-jAnrufmonitor.png]]

Anschließend Platzhalter unter "Erweitert" auswählen

Die Zeile "Format für %callernumber%:" darf keine Leerzeichen enthalten!

[[Datei:Platzhalter_jAnrufmonitor.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

2025-01-10T14:45:11Z

Karsten:

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'''

Die Zeile "Format für %callernumber%:" darf keine Leerzeichen enthalten!

[[Datei:Platzhalter_jAnrufmonitor.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

2025-01-10T14:43:43Z

Karsten:

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:Platzhalter_jAnrufmonitor.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.

Datei:Grundeinstellungen-jAnrufmonitor.png

2025-01-10T14:42:50Z

Karsten:

Datei:Platzhalter jAnrufmonitor.png

2025-01-10T14:42:15Z

Karsten:

Felder hinzufügen/löschen/umbenennen

2024-03-07T14:13:58Z

Karsten: /* Feld Typisierungen: */

In dieser Masken lassen sich alle Felder der Stammdatenmaske und der Ansprechpartner modifizieren.
 Ab der Version 2.10.51.X können sie über die Feldnamen mit Steuerzeichen vielseitige Formatierungen umsetzen.
 Solche Steuerzeichen werden immer mit der sogenannten "Pipe" | eingeleitet.
 Hier die möglichen Formatierungen im Detail.

== Feld Typisierungen: ==

Wenn man Inputfelder, also Texteingabefelder typisieren möchte, also z.B. ein Datumsfeld erzeugen will, kann man das einfach über den Feldnamen steuern. Man hängt hinten einen senkrechten Strich an ("|", genannt "Pipe") gefolgt von einem Buchstaben.

* '''Feldname|l''' -> Erzeugt ein Feld mit Button zum aufrufen eines Links.
* '''Feldname|d''' -> Erzeugt ein Datumsfeld mit Minikalender
* '''Feldname|t''' -> Erzeugt ein Telefonfeld mit anklickbarem Hörersymbol. Wenn eine Feldbezeichnung den Wortteil "tel" enthält geschieht dies automatisch.
* '''Feldname|m''' -> Erzeugt ein E-Mail-Feld mit anklickbarem Briefumschlag. Wenn eine Feldbezeichnung den Wortteil "mail" enthält geschieht dies automatisch.
* '''Feldname|f''' -> Erzeugt ein Faxfeld mit anklickbarem Symbol zum Faxversand.
* '''Feldname|x''' -> Damit wird eine Typisierung unterbunden wenn z.B. der Feldname die Zeichenkette "tel" enthält aber kein Telefonfeld ist.
* '''Feldname|tag''' -> Hiermit lässt sich ein Mehrfachauswahlfeld zu einem sogenannten TAG-Feld umwandeln. Gerade bei sehr vielen Werten, ist das eine übersichtliche Darstellung.

== Feld Berechnungen: ==

Es gibt die Möglichkeit in der Tabellenansicht mit einer Spalte Berechnungen durchzuführen. Wenn eine Berechnung Konfiguriert ist, wird diese in einer extra Zeile am unteren Ende angezeigt.

Folgende Anwendungsfälle sind möglich:

* '''Feldname|a''' -> Lässt das Feld zu einem Durschschittsfeld werden und berechnet in der Tabellenansicht den Durchschnitt.
* '''Feldname|s''' -> Lässt das Feld zu einem Summenfeld werden und berechnet in der Tablellenansicht die Summe.
* '''Feldname|min''' -> Sucht den kleinsten Wert der Spalte und gibt ihn aus.
* '''Feldname|max''' -> Sucht den größten Wert der Spalte und gibt ihn aus.

Bei der Berechnung gibt es einige Dinge zu beachten, hier die Wichtigsten:

* leere und ungültige Werte werden durch 0 ersetzt
* aus einem Komma "," in der Akte wird ein Punkt "." in der Tabellenansicht -> aufgrund der amerikanischen Schreibweise
* 100.000er Trenn-Punkte werden als falsche Zahl erkannt und müssen vermieden werden
* Leerzeichen vor/hinterher werden getrimmt
* keine Beeinflussung der Exportfunktion
* Summe greift nur auf aktuelle Schrittweite, also max. 500 Zeilen summieren
* summieren berücksichtigt das Suchfeld und die Filter

== Feld Formatierungen: ==

Bei den Feldformatieren benutzt man ebenfalls die Pipe hinter dem Feldnamen und kann z.B. die Breite einstellen.

* '''Feldname|w100''' -> Hiermit weist man einem Feld eine feste Breite in Pixel zu, die Funktion gilt nur für Inputfelder.
* '''Feldname|v5''' -> Hiermit können sie bei einem Auswahlfeld (Radiobutton oder Checkbox) die Verteilung der Werte auf eine feste Anzahl Spalten erzwingen.
* '''Feldname|h5''' -> Hiermit können Sie die Anzahl festlegen, nachdem bei Radiobuttons und Checkboxen eine neue Zeile beginnen soll.
* '''Feldname|rx''' -> Hiermit wird die Versionierung der Werte in diesem Feld unterbunden. Geänderte Werte dieses Feldes, tauchen nicht im Reiter ''Versionen'' auf

== Kombinationen: ==
Grundsätzlich lassen sich alle Möglichkeiten kombinieren.

Beispiele:

* '''Umsatz|s|x''' -> Das Feld Umsatz, lässt sich in der Tabellenansicht summieren, Änderungen der Feldwerte werden aber nicht im Versionen-Reiter gespeichert
* '''Kosten|s|a|min|max''' -> Das Feld Umsatz zeigt in der Tabellenansicht alle Berechnungsmöglichkeiten nebeneinander an

== Anzeige von Feldnamen: ==

* Feldnamen dürfen generell HTML-Formatierungen für die Schrift enthalten um z.B. Farben oder Fettschrift zu verwenden.
* leere Auswahlfelder erscheinen wie eine Überschrift und können so verwendet werden um die Daten weiter zu strukturieren.

[[Datei:Admin_idoverwaltung_feldverwaltung_hinzufuegen.png]]

==Input Felder:==
Der erste einfache Feldtyp, Input, die einfachen HTML Schreibfelder. Sie lassen sich anlegen, umbenennen und löschen. Die Felder werden über die Datenbank registriert, ändern aber nicht die Datenbankstruktur. Die Input Felder sind vom Typ varchar(255).

[[Datei:Admin_idoverwaltung_feldverwaltung_hinzufuegen_input.png]]

==Input-Ansprechpartner Felder:==
Analog zu den Inpu Feldern, es sind jedoch die Felder des Ansprechpartnerreiters.

[[Datei:Hinweis.png]] HINWEIS: Bei Ansprechpartner sind nur Input Felder möglich, die Reihenfolge kann nur über die Datenbank eingestellt werden.

==Einzelauswahl-Felder:==
Hiermit legt man Auswahlboxen an, die pro Auswahl einen Wert annehmen können, also Radiobutton und Comboboxen. Die Schalter bekommen einen Namen und es können die einzelnen Einträge hinzugefügt werden. [[Datei:Information.png]] INFO: Man also einen Radiobuttion mit dem Namen "Typ" generieren, der die Einträge "Hardware" und "Software" besitzt.

[[Datei:Admin_idoverwaltung_feldverwaltung_hinzufuegen_einzelauswahl.png]]

==Mehrfachauswahl-Felder:==
Hiermit legt man Auswahlboxen an, die pro Auswahl gleichzeitig mehrere Wert annehmen können, also Checkboxen. Die Schalter bekommen einen Namen und es können die einzelnen Einträge hinzugefügt werden. [[Datei:Information.png]] INFO: Man also eine Checkbox mit dem Namen "Kundentyp" generieren, der die Einträge A,B,C besitzt. Der Kunde kann dann vom Kundentyp A und B und C sein.

[[Datei:Admin_idoverwaltung_feldverwaltung_hinzufuegen_mehrfachauswahl.png]]

== Hauptkapitel ==
* [[IDO Verwaltung]]
** [[Feld Verwaltung]]

== Verwandte Themen ==
* [[IDO entsperren]]
* [[IDO Linkverwaltung]]
* [[IDO-WV]]
* [[IDO rv|IDO Rechteverwaltung]]
* [[Puzzle-Button]]
* [[webservice_ido]]

Anruf HTTP GET Schnittstelle V2

2024-02-07T07:37:06Z

Karsten:

'''Neue Anruflisten API'''

Adresse: http://[instance]-classic.infra-struktur.[eu|com]/api/calllist/index.php

Übergabe als webhook per GET oder POST (GET hat Vorrang vor POST)

'''Folgende Werte müssen übergeben werden:'''
isdnKey - Der ISDN-Key.
location - Der Name eines in der Anrufliste konfigurierten Standortes.
msn - Der Name einer in der Anrufliste konfigurierten eingehenden Rufnummern/Nebenstellen.
number - Die Nummer des Anrufers.

Es sollte beachtet werden, das z.b. die Nummer „+492941247790“ zur Übergabe als Parameter codiert werden muss, damit das führende + auf dem Server passend ausgewertet werden kann. (http://de.wikipedia.org/wiki/URL-Encoding)

'''Folgende Werte können übergeben werden:'''
reason - Der base64 codierte Grund eines Anrufes.
fileSource - Der base64 codierte Inhalt einer Datei.
fileType - Der Typ einer Datei. Der Standardwert liegt auf „fax“.
mimeType - Der mimetype einer Datei. Der Standardwert liegt auf „application/download“.
timestamp - Ein Unixtimestamp mit der der Eintrag erzeugt werden soll. Der Standardwert liegt auf dem Zeitpunkt des Aufrufs.
direction - entweder "in" oder "out für eingehende oder ausgehende Anrufe. Default ist "in".

'''Es können folgende Fehlerwerte auftreten:'''

1001 - MISSING_MANDATORY_REQUEST_PARAM_ISDNKEY

Meldung: „isdnKey“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

1002 - MISSING_MANDATORY_REQUEST_PARAM_LOCATION

Meldung: „location“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

1003 - MISSING_MANDATORY_REQUEST_PARAM_MSN

Meldung: „msn“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

1004 - MISSING_MANDATORY_REQUEST_PARAM_NUMBER

Meldung: „number“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

2001 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_HOST

Meldung: „host“ database connection param is mandatory, please contact the support

2002 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_USERNAME

Meldung: „username“ database connection param is mandatory, please contact the support

2003 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_PASSWORD

Meldung: „password“ database connection param is mandatory, please contact the support

2004 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_DATABASE

Meldung: „database“ database connection param is mandatory, please contact the support

3001 - DATABASE_CONNECTION_CREATE

Meldung: Connection Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3101 - DATABASE_QUERY_ON_VALIDATE_ISDNKEY_IN_DB

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3102 - DATABASE_QUERY_ON_GET_LOCATIONID_BY_LOCATIONNAME

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the location id by location name

3103 - DATABASE_QUERY_ON_GET_LOCATION_CONFIGURATION

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the location configuration

3104 - DATABASE_QUERY_ON_GET_INTERNATIONAL_PREFIX_ID_BY_INTERNATIONAL_PREFIX

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the internationalPrefixId

3105 - DATABASE_QUERY_ON_IS_MSN_A_FAX_MSN_FOR_MSN_AND_LOCATIONID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while checking if the msn is a fax msn

3106 - DATABASE_QUERY_ON_CHECK_SIGNAL_TOLERANCE

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3107 - DATABASE_QUERY_ON_GET_LIST_ID_FOR_MSN_AND_LOCATION_ID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the list id for msn and location id

3108 - DATABASE_QUERY_ON_GET_NUMBER_TO_NAME_ID_BY_NUMBER

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3109 - DATABASE_QUERY_ON_GET_MSN_ID_BY_MSN_AND_LOCATION_ID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the msn id by msn and location id

3110 - DATABASE_QUERY_ON_INSERT_ENTRY

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3111 - DATABASE_QUERY_ON_CITY_NAME_BY_PREFIX_AND_INTERNATIONAL_PREFIX

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3112 - DATABASE_QUERY_ON_FORMAT_NUMBER_WITH_LOCATION

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3113 - DATABASE_QUERY_ON_INSERT_CALL_TO_CALLLIST

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3114 - DATABASE_QUERY_ON_INSERT_FILE

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3115 - DATABASE_QUERY_ON_SET_REASON

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3116 - DATABASE_QUERY_ON_GET_COUNTRY_NAME_FOR_NATIONAL_PREFIX_ID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

4001 - API_INVALID_ISDNKEY

Meldung: the provided isdn key „[isdnKey]“ is not valid

4002 - API_NOT_VALIDATED

Meldung: you first need to validate your isdn key

4101 - API_MINIMUM_NUMBER_LENGTH

Meldung: the number „[number]“ is below the required minimum number length of [minimumNumberLength]

4102 - API_NUMBER_IS_HIDDEN_SIGNAL

Meldung: the number „[number]“ is the hidden signal „[hiddenSignal]“

4103 - API_CALL_IS_WITHIN_SIGNAL_TOLERANCE

Meldung: the call from the number „[number]“ is within the signal tolerance of [signalTolerance] seconds

4104 - API_NO_CALLLIST_FOUND

Meldung: no appropriate call list found for MSN „[msn]“ and location id [locationId]

Anruf HTTP GET Schnittstelle V2

2024-02-07T07:36:34Z

Karsten:

Anruf HTTP GET Schnittstelle V2

2023-05-16T10:37:52Z

Karsten:

'''Neue Anruflisten API'''

Adresse: http://[instance]-classic.infra-struktur.[eu|com]/api/calllist/index.php

Übergabe per GET oder POST (GET hat Vorrang vor POST)

'''Folgende Werte müssen übergeben werden:'''
isdnKey - Der ISDN-Key.
location - Der Name eines in der Anrufliste konfigurierten Standortes.
msn - Der Name einer in der Anrufliste konfigurierten eingehenden Rufnummern/Nebenstellen.
number - Die Nummer des Anrufers.

Es sollte beachtet werden, das z.b. die Nummer „+492941247790“ zur Übergabe als Parameter codiert werden muss, damit das führende + auf dem Server passend ausgewertet werden kann. (http://de.wikipedia.org/wiki/URL-Encoding)

'''Folgende Werte können übergeben werden:'''
reason - Der base64 codierte Grund eines Anrufes.
fileSource - Der base64 codierte Inhalt einer Datei.
fileType - Der Typ einer Datei. Der Standardwert liegt auf „fax“.
mimeType - Der mimetype einer Datei. Der Standardwert liegt auf „application/download“.
timestamp - Ein Unixtimestamp mit der der Eintrag erzeugt werden soll. Der Standardwert liegt auf dem Zeitpunkt des Aufrufs.
direction - entweder "in" oder "out für eingehende oder ausgehende Anrufe. Default ist "in".

'''Es können folgende Fehlerwerte auftreten:'''

1001 - MISSING_MANDATORY_REQUEST_PARAM_ISDNKEY

Meldung: „isdnKey“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

1002 - MISSING_MANDATORY_REQUEST_PARAM_LOCATION

Meldung: „location“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

1003 - MISSING_MANDATORY_REQUEST_PARAM_MSN

Meldung: „msn“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

1004 - MISSING_MANDATORY_REQUEST_PARAM_NUMBER

Meldung: „number“ request param is mandatory, provide it via GET or POST (if both are set, GET will be preferred)

2001 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_HOST

Meldung: „host“ database connection param is mandatory, please contact the support

2002 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_USERNAME

Meldung: „username“ database connection param is mandatory, please contact the support

2003 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_PASSWORD

Meldung: „password“ database connection param is mandatory, please contact the support

2004 - MISSING_MANDATORY_DATABASE_CONNECTION_PARAM_DATABASE

Meldung: „database“ database connection param is mandatory, please contact the support

3001 - DATABASE_CONNECTION_CREATE

Meldung: Connection Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3101 - DATABASE_QUERY_ON_VALIDATE_ISDNKEY_IN_DB

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3102 - DATABASE_QUERY_ON_GET_LOCATIONID_BY_LOCATIONNAME

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the location id by location name

3103 - DATABASE_QUERY_ON_GET_LOCATION_CONFIGURATION

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the location configuration

3104 - DATABASE_QUERY_ON_GET_INTERNATIONAL_PREFIX_ID_BY_INTERNATIONAL_PREFIX

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the internationalPrefixId

3105 - DATABASE_QUERY_ON_IS_MSN_A_FAX_MSN_FOR_MSN_AND_LOCATIONID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while checking if the msn is a fax msn

3106 - DATABASE_QUERY_ON_CHECK_SIGNAL_TOLERANCE

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3107 - DATABASE_QUERY_ON_GET_LIST_ID_FOR_MSN_AND_LOCATION_ID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the list id for msn and location id

3108 - DATABASE_QUERY_ON_GET_NUMBER_TO_NAME_ID_BY_NUMBER

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3109 - DATABASE_QUERY_ON_GET_MSN_ID_BY_MSN_AND_LOCATION_ID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

Meldung: No results found while trying to get the msn id by msn and location id

3110 - DATABASE_QUERY_ON_INSERT_ENTRY

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3111 - DATABASE_QUERY_ON_CITY_NAME_BY_PREFIX_AND_INTERNATIONAL_PREFIX

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3112 - DATABASE_QUERY_ON_FORMAT_NUMBER_WITH_LOCATION

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3113 - DATABASE_QUERY_ON_INSERT_CALL_TO_CALLLIST

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3114 - DATABASE_QUERY_ON_INSERT_FILE

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3115 - DATABASE_QUERY_ON_SET_REASON

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

3116 - DATABASE_QUERY_ON_GET_COUNTRY_NAME_FOR_NATIONAL_PREFIX_ID

Meldung: Query Error (MySQLi: [MySQLi Fehlernummer]) [MySQLi Fehlermeldung]

4001 - API_INVALID_ISDNKEY

Meldung: the provided isdn key „[isdnKey]“ is not valid

4002 - API_NOT_VALIDATED

Meldung: you first need to validate your isdn key

4101 - API_MINIMUM_NUMBER_LENGTH

Meldung: the number „[number]“ is below the required minimum number length of [minimumNumberLength]

4102 - API_NUMBER_IS_HIDDEN_SIGNAL

Meldung: the number „[number]“ is the hidden signal „[hiddenSignal]“

4103 - API_CALL_IS_WITHIN_SIGNAL_TOLERANCE

Meldung: the call from the number „[number]“ is within the signal tolerance of [signalTolerance] seconds

4104 - API_NO_CALLLIST_FOUND

Meldung: no appropriate call list found for MSN „[msn]“ and location id [locationId]

Virtuelle Gruppen

2022-08-10T12:49:45Z

Karsten:

Der Bereich "virtuelle Gruppen" wurde mit der Version 2.10.64.x entfernt und in die Einstellungen der Benutzer verschoben. 
Um hier auch die globalen Gruppen anlegen und bearbeiten zu können, kann dem Benutzer ein Sonderrecht in der Rechteverwaltung gegeben werden. 
Das Sonderrecht heisst dort "Benutzergruppen freigeben" 

== Hauptkapitel ==
* [[Allgemeinverwaltung]]

== Verwandte Themen ==

Datei:Sipgate persEinstellungen.jpg

2022-07-12T10:54:06Z

Karsten:

Sipgate Schnittstelle

2022-07-12T10:52:46Z

Karsten:

== 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 
[[Datei:Screen eingehendeanrufe.jpg]]

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. 

[[Datei:Hinweis.png]]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! 

[[Datei:Sipgate waelhilfe.jpg]]
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 
[[Datei:Sipgate kennung.jpg]]

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

Webservice idolinkings

2022-07-08T13:32:25Z

Karsten:

* '''WSDL Datei'''

Die zur Nutzung der infra-struktur IDOLINKINGS Webservices notwendige WSDL-Datei finden Sie unter:

http://instanzname.infra-struktur.de/webservice/wsdl/wsdl.php?idolinkings

Beachten Sie, dass der Webserver für die Verwendung der Webservices Schreibrechte auf das Verzeichnis „WEBROOT/webservice/wsdl“ benötigt.

* '''Example'''

Diese in PHP geschrieben Beispielapplikation dient als leichter Einstieg in die infra-struktur Webservices

<?php
$client = new SoapClient("http://instanz.infra-struktur.de/webservice/wsdl/wsdl.php?idolinkings",array('exceptions'=>false));
$Token = $client->__soapCall("authenticate",array("http://instanz.infra-struktur.de","USERNAME","PASSWORD"));
var_dump($client->__soapCall("getLinkedIDOList",array(INSTANZ_ID, IDO_ID, TOKEN, array(INSTANZ_ID, INSTANZ_ID))));
?>

* '''Funktionsübersicht'''

''getLinkedIDOList''

Der Webservice liefert ein Array mit Instanz IDs und IDOs der Beziehungen

{| class="wikitable" border=1
! width="100px" | Parameter
! width="100px" | Datentyp
! width="400px" | Beschreibung
|-
| InstanceID ||Integer ||| ID der IDO-Instanz
|-
| IDOID || Integer ||| ID des Datensatzes des Verknüfungen interessant sind
|-
| Token || String ||| Authentifizierungstoken für weitere Anfragen am Webservice
|-
| LimitToInstances || Array ||| optionales Array um die Rückgabe auf einzelne Instanzen zu beschränken
|-
|   || |||
|-
| <div align=center>'''Rückgabewert'''</div> || |||
|-
| result || Array ||| Liefert alle verknüpften Datensätze zurück ($Result[INSTANZ_ID][] = DATENSATZ_ID
|}

== Hauptkapitel ==
* [[Webservice Dokumentation]]

== Verwandte Themen ==
* [[Webservice_activities]]
* [[Webservice_calendar]]
* [[Webservice_contacts]]
* [[Webservice_dms]]
* [[Webservice_ido]]
* [[Webservice_msg]]
* [[Webservice_user]]

Webservice email

2022-05-05T12:46:52Z

Karsten:

* '''WSDL Datei'''

Die zur Nutzung der infra-struktur Benutzerverwaltung Webservices notwendige WSDL-Datei finden Sie unter:

http://instanzname.infra-struktur.eu/webservice/wsdl/wsdl.php?email

Beachten Sie, dass der Webserver für die Verwendung der Webservices Schreibrechte auf das Verzeichnis „WEBROOT/webservice/wsdl“ benötigt.

* '''Example'''

Dieses in php geschriebene Beispiel beinhaltet die benötigten Strukturen um eine Mail an die Adresse paul.pfiffig@netzkultur.de zu schicken

<?php

$instanceUrl = "https://instanzname.infra-struktur.eu/webservice/wsdl/wsdl.php?email";
$username = "webservice";
$password = "123456789";
$userID = 4;

$Client = new SoapClient($instanceUrl."?email", array('exceptions'=>false));
$token = $Client->__soapCall("authenticate",array($instanceUrl, $username, $password));

$attachments = array();
$toArray = array(
'1' => 'paul.pfiffig@netzkultur.de',
);
$bccArray = array();
$ccArray = array();
$attachments[] = array('AttachmentFilename' => $fileName,
'AttachmentFilesize' => filesize($filePath),
'AttachmentFilesourceBase64Encoded' => base64_encode(file_get_contents($filePath)))

$mailTemplate = array(
'MailReceiversTO' => $toArray,
'MailReceiversCC' => $ccArray,
'MailReceiversBCC' => $bccArray,
'MailSubject' => "Hier kommt der Betreff hin.",
'MailText' => "Hier kommt der Inhalt hin.",
'MailSendingAccountID' => 119, //AbsenderpostfachID als integer
'MailSendingTimestamp' => 0,
'MailType' => 'text/html',
'UserID' => $userID,
'ImportMode' => false,
'DocumentID' => 0,
'Attachments' => $attachments
);

$Client->__soapCall('sendMail', array ($mailTemplate, $token));
?>

* '''Funktionsübersicht'''

''Authenticate''

Authentifiziert einen Benutzer am Webservice

{| class="wikitable" border=1
! width="100px" | Parameter
! width="100px" | Datentyp
! width="400px" | Beschreibung
|-
| instanceName ||String ||| Vollständiger Pfad der Instanz
|-
| userName || String ||| infra-struktur Benutzername
|-
| password || String ||| infra-struktur Passwort
|-
|   || |||
|-
| <div align=center>'''Rückgabewert'''</div> || |||
|-
| token || String ||| Authentifizierungstoken für weitere Anfragen am Webservice
|}

''archiveMail''

Wechselt den Archivierungsstatus einer Mail.

{| class="wikitable" border=1
! width="100px" | Parameter
! width="100px" | Datentyp
! width="400px" | Beschreibung
|-
| MailID || integer ||| Datenbank ID der Mail
|-
| UserID || integer ||| ID des Mailabsenders
|-
| Token|| String ||| Authentifizierungstoken
|-
|   || |||
|-
| <div align=center>'''Rückgabewert'''</div> || |||
|-
| Wert: 1 || integer ||| Hat den Archivierungsstatus einer Mail gewechselt
|}

''createDraft''

Erstellt einen Entwurf in der infra-struktur

{| class="wikitable" border=1
! width="100px" | Parameter
! width="100px" | Datentyp
! width="400px" | Beschreibung
|-
| mailData || Array ||| Array aus Mailvorlage
|-
| Token|| String ||| Authentifizierungstoken
|-
|   || |||
|-
| <div align=center>'''Rückgabewert'''</div> || |||
|-
| || Aktion ||| Erstellt einen Entwurf in der infra-struktur
|}

''getEmptyMailTemplateJson''

Holt eine leere Mailvorlage (das mailData Array)

{| class="wikitable" border=1
! width="100px" | Parameter
! width="100px" | Datentyp
! width="400px" | Beschreibung
|-
| Token|| String ||| Authentifizierungstoken
|-
|   || |||
|-
| <div align=center>'''Rückgabewert'''</div> || |||
|-
| mailTemplate || Array ||| Array mit dem Aufbau der für das mailData Array gebraucht wird
|}

''getMailGroupsForUser''

Gibt die Mailgruppen des angegebenen Users aus.

{| class="wikitable" border=1
! width="100px" | Parameter
! width="100px" | Datentyp
! width="400px" | Beschreibung
|-
| UserID || integer ||| ID des Mailabsenders
|-
| Token|| String ||| Authentifizierungstoken
|-
|   || |||
|-
| <div align=center>'''Rückgabewert'''</div> || |||
|-
| mailGroups || Array ||| Array mit GruppenID und Gruppenname
|}

''getNewDirectEmailCount''

Gibt die Anzahl an Mails an, die nach einer gewählten Mail angekommen sind.

{| class="wikitable" border=1
! width="100px" | Parameter
! width="100px" | Datentyp
! width="400px" | Beschreibung
|-
| UserID || integer ||| ID des Mailabsenders
|-
| lastMailID || integer ||| MailID der auszuwählenden Mail
|-
| Token|| String ||| Authentifizierungstoken
|-
|   || |||
|-
| <div align=center>'''Rückgabewert'''</div> || |||
|-
| newMailCount || Array ||| Array mit MailIDs der neuen Mails
|}

''getNewGlobalizedEmailCount''

Gibt die Anzahl an delegierten Mails an, die nach einer gewählten Mail angekommen sind.

{| class="wikitable" border=1
! width="100px" | Parameter
! width="100px" | Datentyp
! width="400px" | Beschreibung
|-
| UserID || integer ||| ID des Mailabsenders
|-
| lastMailID || integer ||| MailID der auszuwählenden Mail
|-
| Token|| String ||| Authentifizierungstoken
|-
|   || |||
|-
| <div align=center>'''Rückgabewert'''</div> || |||
|-
| newGlobCount || Array ||| Array mit MailIDs der neuen, globalisierten Mails
|}

''getPostboxesForUser''

Zeigt die Postfächer eines gewählten Users an.

{| class="wikitable" border=1
! width="100px" | Parameter
! width="100px" | Datentyp
! width="400px" | Beschreibung
|-
| UserID || integer ||| ID des Mailabsenders
|-
| Token|| String ||| Authentifizierungstoken
|-
|   || |||
|-
| <div align=center>'''Rückgabewert'''</div> || |||
|-
| postboxes || Array ||| Array mit PostfachID und Name des Postfaches
|}

''getStandardTemplateForMailAccountAndUser''

Gibt die ID der Standardvorlage eines Users für ein Postfach.

{| class="wikitable" border=1
! width="100px" | Parameter
! width="100px" | Datentyp
! width="400px" | Beschreibung
|-
| mailAccountID || integer ||| Datenbank ID des Mailpostfaches
|-
| UserID || integer ||| ID des Mailabsenders
|-
| Token|| String ||| Authentifizierungstoken
|-
|   || |||
|-
| <div align=center>'''Rückgabewert'''</div> || |||
|-
| templateID || integer ||| ID der Standardvorlage
|}

''getWebmailTemplate''

Holt die Ausgewählte Vorlage in ein Array.

{| class="wikitable" border=1
! width="100px" | Parameter
! width="100px" | Datentyp
! width="400px" | Beschreibung
|-
| templateID || integer ||| Datenbank ID der Standardvorlage
|-
| UserID || integer ||| ID des Mailabsenders
|-
| Token|| String ||| Authentifizierungstoken
|-
|   || |||
|-
| <div align=center>'''Rückgabewert'''</div> || |||
|-
| standardTemplate || Array ||| Array, im mailData-Format mit den Daten der gewählten Vorlage
|}

''openComposeWindow''

Öffnet das "Verfassen"-Fenster mit einer gewählten Vorlage.

{| class="wikitable" border=1
! width="100px" | Parameter
! width="100px" | Datentyp
! width="400px" | Beschreibung
|-
| UserID || integer ||| ID des Mailabsenders
|-
| templateID || integer ||| Datenbank ID der Vorlage
|-
| Token|| String ||| Authentifizierungstoken
|-
|   || |||
|-
| <div align=center>'''Rückgabewert'''</div> || |||
|-
| || Aktion ||| Öffnet das Verfassenfenster
|}

''sendBulkMail''

Versendet eine Massenmail

{| class="wikitable" border=1
! width="100px" | Parameter
! width="100px" | Datentyp
! width="400px" | Beschreibung
|-
| mailArray|| Array ||| Array aus mailData-Arrays
|-
| Token|| String ||| Authentifizierungstoken
|-
|   || |||
|-
| <div align=center>'''Rückgabewert'''</div> || |||
|-
| || Aktion ||| Versendet eine Massenmail
|}

''sendMail''

Versendet eine Mail.

{| class="wikitable" border=1
! width="100px" | Parameter
! width="100px" | Datentyp
! width="400px" | Beschreibung
|-
| mailData || Array ||| Array mit Maildata
|-
| Token|| String ||| Authentifizierungstoken
|-
|   || |||
|-
| <div align=center>'''Rückgabewert'''</div> || |||
|-
| || Aktion ||| Versendet eine Mail.
|}

== Hauptkapitel ==
* [[Webservice Dokumentation]]

== Verwandte Themen ==
* [[Webservice_activities]]
* [[Webservice_calendar]]
* [[Webservice_contacts]]
* [[Webservice_dms]]
* [[Webservice_ido]]
* [[Webservice_msg]]
* [[Webservice_user]]
* [[Webservice_email]]
* [[Webservice_task]]

Placetel Schnittstelle

2022-03-29T13:42:30Z

Karsten:

<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
 

* 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 Integrationen gehen und dort die kostenlose Notify Api buchen / auswählen. 
 
[[Datei:Placetel-Api-Schritt1.jpg|700px]]
 
3.Dort auf den Reiter "Externe APIs" klicken. 
4.Die Checkbox "Call Control-/Notify-API aktivieren " aktivieren. 
5.Die genaue URL des Skriptes unter 2. im Feld "URL Ihres API-Endpoints" hinterlegen. 
6.Die Telefonnummern aktivieren, für die die API zugreifen soll. 
7.Mit "Eigenen API-Endpoint speichern" bestätigen. 
[[Datei:Placetel-Api-Schritt2.jpg|700px]]

Placetel Schnittstelle

2022-03-29T13:42:05Z

Karsten:

<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
 

* 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 Integrationen gehen und dort die kostenlose Notify Api buchen / auswählen. 
 
[[Datei:Placetel-Api-Schritt1.jpg|400px]]
 
3.Dort auf den Reiter "Externe APIs" klicken. 
4.Die Checkbox "Call Control-/Notify-API aktivieren " aktivieren. 
5.Die genaue URL des Skriptes unter 2. im Feld "URL Ihres API-Endpoints" hinterlegen. 
6.Die Telefonnummern aktivieren, für die die API zugreifen soll. 
7.Mit "Eigenen API-Endpoint speichern" bestätigen. 
[[Datei:Placetel-Api-Schritt2.jpg]]

Placetel Schnittstelle

2022-03-29T13:40:28Z

Karsten:

<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
 

* 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 Integrationen gehen und dort die kostenlose Notify Api buchen / auswählen. 
 
[[Datei:Placetel-Api-Schritt1.jpg|upright=0.5|]]
 
3.Dort auf den Reiter "Externe APIs" klicken. 
4.Die Checkbox "Call Control-/Notify-API aktivieren " aktivieren. 
5.Die genaue URL des Skriptes unter 2. im Feld "URL Ihres API-Endpoints" hinterlegen. 
6.Die Telefonnummern aktivieren, für die die API zugreifen soll. 
7.Mit "Eigenen API-Endpoint speichern" bestätigen. 
[[Datei:Placetel-Api-Schritt2.jpg]]

Placetel Schnittstelle

2022-03-29T13:40:03Z

Karsten:

<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
 

* 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 Integrationen gehen und dort die kostenlose Notify Api buchen / auswählen. 
 
[[Datei:Placetel-Api-Schritt1.jpg]|upright=0.5|]
 
3.Dort auf den Reiter "Externe APIs" klicken. 
4.Die Checkbox "Call Control-/Notify-API aktivieren " aktivieren. 
5.Die genaue URL des Skriptes unter 2. im Feld "URL Ihres API-Endpoints" hinterlegen. 
6.Die Telefonnummern aktivieren, für die die API zugreifen soll. 
7.Mit "Eigenen API-Endpoint speichern" bestätigen. 
[[Datei:Placetel-Api-Schritt2.jpg]]

Datei:Placetel-Api-Schritt2.jpg

2022-03-29T13:36:41Z

Karsten: Karsten lud eine neue Version von „Datei:Placetel-Api-Schritt2.jpg“ hoch

Datei:Placetel-Api-Schritt1.jpg

2022-03-29T13:34:01Z

Karsten: Karsten lud eine neue Version von „Datei:Placetel-Api-Schritt1.jpg“ hoch

Placetel Schnittstelle

2022-03-29T13:32:54Z

Karsten:

<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
 

* 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 Integrationen gehen und dort die kostenlose Notify Api buchen / auswählen. 
 
[[Datei:Placetel-Api-Schritt1.jpg]]
 
3.Dort auf den Reiter "Externe APIs" klicken. 
4.Die Checkbox "Call Control-/Notify-API aktivieren " aktivieren. 
5.Die genaue URL des Skriptes unter 2. im Feld "URL Ihres API-Endpoints" hinterlegen. 
6.Die Telefonnummern aktivieren, für die die API zugreifen soll. 
7.Mit "Eigenen API-Endpoint speichern" bestätigen. 
[[Datei:Placetel-Api-Schritt2.jpg]]

Placetel Schnittstelle

2022-01-07T11:25:46Z

Karsten:

<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
 

* 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-Backend in den Bereich Administration-> Einstellungen gehen. 
 
[[Datei:Placetel-Api-Schritt1.jpg]]
 
3.Dort auf den Reiter "Externe APIs" klicken. 
4.Die Checkbox "Call Control-/Notify-API aktivieren " aktivieren. 
5.Die genaue URL des Skriptes unter 2. im Feld "URL Ihres API-Endpoints" hinterlegen. 
6.Die Telefonnummern aktivieren, für die die API zugreifen soll. 
7.Mit "Eigenen API-Endpoint speichern" bestätigen. 
[[Datei:Placetel-Api-Schritt2.jpg]]

Placetel Schnittstelle

2022-01-07T11:25:10Z

Karsten:

<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/api/initiateCall.xml?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
 

* 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-Backend in den Bereich Administration-> Einstellungen gehen. 
 
[[Datei:Placetel-Api-Schritt1.jpg]]
 
3.Dort auf den Reiter "Externe APIs" klicken. 
4.Die Checkbox "Call Control-/Notify-API aktivieren " aktivieren. 
5.Die genaue URL des Skriptes unter 2. im Feld "URL Ihres API-Endpoints" hinterlegen. 
6.Die Telefonnummern aktivieren, für die die API zugreifen soll. 
7.Mit "Eigenen API-Endpoint speichern" bestätigen. 
[[Datei:Placetel-Api-Schritt2.jpg]]

Sipgate Schnittstelle

2021-12-30T14:23:18Z

Karsten: /* Wählfunktion für sipgate */

Datei:Sipgate kennung.jpg

2021-12-30T14:22:44Z

Karsten:

Sipgate Schnittstelle

2021-12-30T14:22:28Z

Karsten:

Datei:Screen eingehendeanrufe.jpg

2021-12-30T14:20:47Z

Karsten: Karsten lud eine neue Version von „Datei:Screen eingehendeanrufe.jpg“ hoch

Sipgate Schnittstelle

2021-12-30T14:18:26Z

Karsten:

Sipgate Schnittstelle

2021-12-30T14:17:14Z

Karsten: /* Wählfunktion für sipgate */

== 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 
[[Datei:Screen eingehendeanrufe.jpg]]

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. 

[[Datei:Hinweis.png]]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!

[[Datei:Sipgate waelhilfe.jpg]]
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.: e0:p4

Datei:Sipgate item.jpg

2021-12-30T14:14:49Z

Karsten: Karsten lud eine neue Version von „Datei:Sipgate item.jpg“ hoch

Datei:Sipgate waelhilfe.jpg

2021-12-30T14:09:11Z

Karsten: Karsten lud eine neue Version von „Datei:Sipgate waelhilfe.jpg“ hoch

Sipgate Schnittstelle

2021-12-30T14:06:43Z

Karsten: /* Eingehende Signalisierung für sipgate */

== 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 
[[Datei:Screen eingehendeanrufe.jpg]]

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. 

[[Datei:Hinweis.png]]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. Weitere Parameter sind an dieser Stelle nicht notwendig. 
[[Datei:Sipgate waelhilfe.jpg]]
Setzen sie hier auch die Benutzerberechtigung für alle die diese Funktion verwenden möchten. 

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. 
Dazu müssen sie in der Menüverwaltung ein neues Menüitem erstellen. 
nach folgendem Schema. 
Name des items kann frei vergeben werden. 
URL:https://api.sipgate.com/v1/authorization/oauth/authorize 

Parameter:scope=all&response_type=code&client_id=FBMuwgyOI6&redirect_uri=''Hier muss die URL-Encoded URL zu unserem Sipgate-Client eingetragen werden'' 

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

Vollständig sieht der Eintrag als Parameter für das Menüitem dann so aus: 
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 
[[Datei:Sipgate item.jpg]] 

Nach der Einrichtung und Vergabe der entsprechenden Rechte kann das Menüitem aufgerufen werden. 
[[Datei:Auhorize sipgate1.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. 
Im Folgenden Fenster klicken sie dann auf "Authorize" 
[[Datei:Auhorize sipgate2.jpg]] 
Danach 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]]

Datei:Screen eingehendeanrufe.jpg

2021-12-30T14:05:49Z

Karsten: Karsten lud eine neue Version von „Datei:Screen eingehendeanrufe.jpg“ hoch