====== Telefonanbindung ======

Diese Anleitung beschreibt, wie ein Telefon mit unserer Software verbunden und genutzt werden kann.\\
Es gibt die 3 folgenden Wege.

===== 1. SIP-Zugangsdaten =====

Zur Anmeldung des Telefons werden die folgenden SIP-Zugangsdaten benötigt:\\

Domain – SIP-Domain des Telefon-Accounts\\

Username – Benutzername des SIP-Accounts\\

Passwort – Passwort des SIP-Accounts\\

Diese Daten sind im Telefon oder Softphone entsprechend zu hinterlegen.\\

===== 2. IncomingCall.exe =====

Im Installationsverzeichnis der Software befindet sich die Datei IncomingCall.exe.\\
Diese Anwendung kann mit einer Rufnummer als Parameter aufgerufen werden.\\

Beispiel:

<code>IncomingCall.exe 01738833312</code>


Die übergebene Rufnummer wird von der Software weiterverarbeitet (z. B. zur Anzeige oder Zuordnung eines eingehenden Anrufs).\\
Hierfür muss der REST-Service aktiviert sein.

===== 3. REST-Service (Port 27001) =====

Die Software stellt einen integrierten REST-Service auf Port 27001 bereit.\\
Der Service wird über HTTP POST angesprochen und erwartet Daten im JSON-Format.\\

Endpoint:

http://localhost:27001/notification


Beispiel Request (JSON):
<code>
{
    "ClassName": "IncomingCall",
    "Number": "100000"
}
</code>

Beschreibung der Parameter:
^ Parameter ^ Beschreibung ^
| ClassName | Art der Benachrichtigung, z. B. ''IncomingCall'' |
| Number | Rufnummer des Anrufers |

Der REST-Service dient zur Übergabe von Anrufinformationen aus externen Systemen an die Software und kann für die Integration von Telefonanlagen oder Middleware verwendet werden.

Curl-Beispiel
<code>
curl -X POST http://localhost:27001/notification \
  -H "Content-Type: application/json" \
  -d '{
    "ClassName": "IncomingCall",
    "Number": "100000"
  }'

</code>

{{pasted:20260204-125031.png}}