> For the complete documentation index, see [llms.txt](https://docs.openwowi.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.openwowi.de/schnittstelle-v1.x/kommunikationsmodul.md).

# Kommunikationsmodul

Die Endpunkte dieser Endpunktberechtigung finden Sie im Controller "CommunicationRead", "CommunicationEdit" und "CommunicationCatalog".

{% hint style="danger" %}
Bei dem Kommunikationsmodul handelt es sich um ein kostenpflichtiges Zusatzmodul. Bitte informieren Sie sich bei Ihrem Kunden, ob dieses Modul gebucht wurde.
{% endhint %}

{% hint style="warning" %}
Um auf die Endpunkte des Kommunikationsmoduls zugreifen zu können, benötigen Sie die Endpunktberechtigungen "Ticket lesen" und "Ticket ändern".
{% endhint %}

## Einleitung

Das Kommunikationsmodul ist eine neue Applikation in WOWIPORT. Dieses Modul ist vorrangig darauf ausgerichtet, die Kommunikation von Partneranwendungen mit den Anwendern von WOWIPORT zu gewährleisten.

Bei der Verwendung von schreibenden Endpunkten kommt es unweigerlich zu Situationen, in denen ein Teil des Prozesses in der Partneranwendung abgebildet wird, während Folgeprozesse in WOWIPORT vollzogen werden müssen. Das Kommunikationsmodul soll diese Lücke schließen.

Sie können das Modul nutzen, um den Sachbearbeitern in WOWIPORT Nachrichten zu senden und erstellte Objekte beizufügen.

## Einrichtung

Das Kommunikationsmodul ist an Quellen gebunden. Die Absenderquelle definiert, wer auf ein Ticket oder eine Nachricht Zugriff hat. Hierdurch ist gewährleistet, dass unbefugte Dritte keinen Zugriff auf die Kommunikation zwischen Ihrer Anwendung und WOWIPORT erhalten.

Um eine neue Nachrichtenquelle anzulegen, muss der Kunde in WOWIPORT die Berechtigungen "Kommunikation" / "Nachrichtenquelle" haben.

Im Menü "Kommunikation" können dann unter "Einstellungen" die Nachrichtenquellen angelegt werden.<br>

<figure><img src="https://619896158-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfOXt8VHk6GRwZ0LymzOn%2Fuploads%2FqEocM8nAT11RPbcSZNss%2Fimage.png?alt=media&amp;token=60f4741f-35f5-4892-a0cf-63ab96b1700c" alt=""><figcaption></figcaption></figure>

Wenn eine Nachrichtenquelle angelegt wird, können Sie Pflichtfelder für diese Nachrichten definieren. Zudem benötigt die Nachrichtenquelle jeweils einen Nachrichtenstatus für jeden Zustand der Nachricht:<br>

<figure><img src="https://619896158-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfOXt8VHk6GRwZ0LymzOn%2Fuploads%2FSYu8Hnq38u70QaWBJTGK%2Fimage.png?alt=media&amp;token=35b4c436-4097-4f7d-9c14-4f936f6d8c1c" alt=""><figcaption></figcaption></figure>

Es müssen mindestens Status für "neu", "gelesen" und "beendet" definiert werden.

Die Nachrichtenquelle muss dann einem Nutzer und einem API-Key zugewiesen werden. In der API-Key-Konfiguration können beide Einstellungen vorgenommen werden.

<figure><img src="https://619896158-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfOXt8VHk6GRwZ0LymzOn%2Fuploads%2F9mDoSKqkJznmHj2wmoZd%2Fimage.png?alt=media&amp;token=62709bc8-6390-4a77-b21b-6e27805e033e" alt=""><figcaption><p>Nutzer und Nachrichtenquelle verknüpfen</p></figcaption></figure>
