Die Endpunkte dieser Endpunktberechtigung finden Sie im Controller "CommunicationRead", "CommunicationEdit" und "CommunicationCatalog".
Bei dem Kommunikationsmodul handelt es sich um ein kostenpflichtiges Zusatzmodul. Bitte informieren Sie sich bei Ihrem Kunden, ob dieses Modul gebucht wurde. Aufgrund von Erweiterungsarbeiten am Kommunikationsmodul kann es derzeit zu Inkonsistenzen in der Datenstrukur kommen. Eine vollständige Stabilität kann aktuell nicht garantiert werden.
Um auf die Endpunkte des Kommunikationsmoduls zugreifen zu können, benötigen Sie die Endpunktberechtigungen "Ticket lesen" und "Ticket ändern".
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.
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 seiner Gruppenverwaltung die Kataloge öffnen.
Als Modul wird die Kommunikationszentrale gewählt.
Der Katalog "FIO-CC-Nachrichtenquelle" kann über das "Editieren"-Symbol bearbeitet werden.
Im folgenden Dialog kann durch Klick auf den Button "Neu" ein neuer Eintrag erstellt werden.
Für jede Nachrichtenquelle müssen zudem die möglichen Status der Nachricht definiert werden.
Hierfür legen Sie einen neuen Nachrichtenstatus im Katalog "FIO-CC-Nachrichtenstatus" an.
Bitte selektieren Sie hier die gerade angelegte Nachrichtenquelle, vergeben Sie einen Namen und wählen Sie eines der Auswahlfelder aus um die Bedeutung des Nachrichtenstatus festzulegen.
Die Nachrichtenquelle muss dann einem Nutzer und einem API-Key zugewiesen werden. In der API-Key-Konfiguration können beide Einstellungen vorgenommen werden.
Hier finden Sie Beispiele, wie die API in der Praxis angewendet werden kann.
In diesem Beispiel findet ein Startereignis in einer Partneranwendung auf Ebene der Nutzungseinheit statt. Die Anwendung erzeugt eine Nachricht und der Sachbearbeiter antwortet innerhalb der Nachricht. Die Partneranwendung ergänzt dann eine weitere Antwort.
Mit diesen Endpunkten können Sie Tickets bearbeiten.
Die Endpunkte der Version 1.2 sind momentan in der Entwicklung und können noch Änderungen erfahren.
Dieser Endpunkt wird zukünftig zugunsten der Konversationen abgekündigt. Der Endpunkt ist mit den Tickets weiterhin kompatibel, allerdings fehlen wesentliche Daten für die Konversationen.
Use username and password.
OK
Bad Request
Unauthorized
{
"Id": 1,
"IdNum": "text"
}POST /openwowi/v1.2/CommunicationEdit/Ticket/AddConversation HTTP/1.1
Host:
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 120
{
"TicketId": 1,
"TicketSourceId": 1,
"PersonId": 1,
"CreatedAt": "2025-12-15T10:51:33.510Z",
"Location": "text",
"Content": "text"
}Use username and password.
20falseOK
Bad Request
Unauthorized
Use username and password.
falseOK
Bad Request
Unauthorized
Use username and password.
falseOK
Bad Request
Unauthorized
Use username and password.
falseOK
Bad Request
Unauthorized
Use username and password.
falseOK
Bad Request
Unauthorized
Use username and password.
Created
Bad Request
Unauthorized
Use username and password.
OK
Bad Request
Unauthorized
Use username and password.
OK
Bad Request
Unauthorized
GET /openwowi/v1.2/CommunicationRead/Ticket HTTP/1.1
Host:
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
[
{
"Id": 1,
"IdNum": "text",
"TimeReceived": "2025-12-15T10:51:33.510Z",
"Subject": "text",
"Content": "text",
"ExternalReference": "text",
"Department": {
"Id": 1,
"Name": "text"
},
"UserId": 1,
"CreatedByUserId": 1,
"CreatedByApiUser": true,
"ShareStatus": true,
"Priority": {
"Id": 1,
"Code": "text"
},
"Status": {
"Id": 1,
"Code": "text"
},
"Source": {
"Id": 1,
"Code": "text",
"TicketSourceClassification": {
"Id": 1,
"Code": "text"
},
"DefaultTicketPriority": {
"Id": 1,
"Code": "text"
},
"DefaultTicketStatus": {
"Id": 1,
"Code": "text"
},
"IsPersonMandatory": true,
"IsSubjectMandatory": true,
"IsContentMandatory": true,
"IncomingSourceOnly": true,
"DefaultTicketStatusDuringProcessing": {
"Id": 1,
"Code": "text"
},
"AllowTicketCreationForApiKey": true
},
"Comments": [
{
"Id": 1,
"TicketSource": {
"Id": 1,
"Code": "text"
},
"CreatedAt": "2025-12-15T10:51:33.510Z",
"Content": "text",
"Location": "text",
"Person": {
"Id": 1,
"IdNum": "text",
"Name": "text"
},
"UserName": "text",
"UserId": 1,
"Read": true,
"CommentFromApi": true
}
],
"MainAssignment": {
"Id": 1,
"AssignmentEntity": {
"Id": 1,
"Code": "text"
},
"EntityId": 1
},
"Assignment": [
{
"Id": 1,
"AssignmentEntity": {
"Id": 1,
"Code": "text"
},
"EntityId": 1
}
]
}
]GET /openwowi/v1.2/CommunicationCatalog/TicketAssignmentEntity HTTP/1.1
Host:
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
[
{
"Id": 1,
"Code": "text"
}
]GET /openwowi/v1.2/CommunicationCatalog/TicketPriority HTTP/1.1
Host:
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
[
{
"Id": 1,
"Code": "text"
}
]GET /openwowi/v1.2/CommunicationCatalog/TicketSource HTTP/1.1
Host:
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
[
{
"Id": 1,
"Code": "text",
"TicketSourceClassification": {
"Id": 1,
"Code": "text"
},
"DefaultTicketPriority": {
"Id": 1,
"Code": "text"
},
"DefaultTicketStatus": {
"Id": 1,
"Code": "text"
},
"IsPersonMandatory": true,
"IsSubjectMandatory": true,
"IsContentMandatory": true,
"IncomingSourceOnly": true,
"DefaultTicketStatusDuringProcessing": {
"Id": 1,
"Code": "text"
},
"AllowTicketCreationForApiKey": true
}
]GET /openwowi/v1.2/CommunicationCatalog/TicketStatus HTTP/1.1
Host:
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
[
{
"Id": 1,
"Code": "text"
}
]{
"Id": 1,
"IdNum": "text"
}POST /openwowi/v1.2/CommunicationEdit/Ticket HTTP/1.1
Host:
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 239
{
"Subject": "text",
"Content": "text",
"SourceId": 1,
"PriorityId": 1,
"DepartmentId": 1,
"UserId": 1,
"ExternalReference": "text",
"MainEntityAssignment": {
"AssignmentEntityId": 1,
"EntityId": 1
},
"EntityAssignments": [
{
"AssignmentEntityId": 1,
"EntityId": 1
}
]
}POST /openwowi/v1.2/CommunicationEdit/Ticket/AddComment HTTP/1.1
Host:
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 44
{
"TicketId": 1,
"Content": "text",
"PersonId": 1
}DELETE /openwowi/v1.2/CommunicationEdit/Ticket/{ticketId} HTTP/1.1
Host:
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
"Id": 1,
"IdNum": "text"
}{
"Id": 1,
"IdNum": "text"
}