Ticket bearbeiten

Hinweise zur Funktion

Das Kommunikationsmodul sollte Anwendung finden, wenn Sie über eine API ein neues Objekt erstellen und erwartet wird, dass dieses Objekt in WOWIPORT weiterverarbeitet wird. Beispiele hierfür wären:

• Ein vorgeschlagener Vertragsnehmer wird erstellt.

• Eine Rechnung wird übergeben.

• Ein Auftrag wurde erstellt.

"AssignmentEntityId" verweist auf die Entitäts-ID aus dem entsprechenden Katalog. Die ID des Objektes wird im Schlüssel "EntityId" angegeben. Daten zu den Abteilungen können in den Objektdaten abgerufen werden. https://docs.openwowi.de/schnittstelle-v1.x/objektdaten/abteilung

Die Endpunkte der Version 1.2 sind momentan in der Entwicklung und können noch Änderungen erfahren.

Ticket anlegen

Version 1.2

---

post

Autorisierungen

Authorization

OAuth2passwordErforderlich

Use username and password.

Token URL:

Abfrageparameter

apiKeystringOptional

Body

application/jsontext/jsonapplication/*+json

Subjectstring · nullableOptional

Contentstring · nullableOptional

SourceIdinteger · int32Optional

PriorityIdinteger · int32Optional

DepartmentIdinteger · int32 · nullableOptional

UserIdinteger · int32 · nullableOptional

ExternalReferencestring · nullableOptional

Antworten

201

Created

text/plainapplication/jsontext/json

400

Bad Request

text/plainapplication/jsontext/json

401

Unauthorized

post

/openwowi/v1.2/CommunicationEdit/Ticket

HTTPcURLJavaScriptPython

POST /openwowi/v1.2/CommunicationEdit/Ticket HTTP/1.1
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
    }
  ]
}

application/jsontext/jsonapplication/*+json

{
  "Id": 1,
  "IdNum": "text"
}

---

Kommentar hinzufügen

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.

Version 1.2

---

post

Autorisierungen

Authorization

OAuth2passwordErforderlich

Use username and password.

Token URL:

Abfrageparameter

apiKeystringOptional

Body

application/jsontext/jsonapplication/*+json

TicketIdinteger · int32Optional

Contentstring · nullableOptional

PersonIdinteger · int32 · nullableOptional

Antworten

200

OK

text/plainapplication/jsontext/json

Idinteger · int32Optional

IdNumstring · nullableOptional

CommentIdinteger · int32Optional

400

Bad Request

text/plainapplication/jsontext/json

401

Unauthorized

post

/openwowi/v1.2/CommunicationEdit/Ticket/AddComment

HTTPcURLJavaScriptPython

POST /openwowi/v1.2/CommunicationEdit/Ticket/AddComment HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "TicketId": 1,
  "Content": "text",
  "PersonId": 1
}

application/jsontext/jsonapplication/*+json

{
  "Id": 1,
  "IdNum": "text",
  "CommentId": 1
}

---

Konversationen hinzufügen

Hinweise zur Funktion

Sie können in den Konversationen andere Ticketquellen verwenden, wenn diese Ihrem API Key zugeordnet sind.

Die "Location" kann nur in der Nachrichtenquelle "Gesprächsnotiz" verwendet werden.

Version 1.2

---

post

Autorisierungen

Authorization

OAuth2passwordErforderlich

Use username and password.

Token URL:

Abfrageparameter

apiKeystringOptional

Body

application/jsontext/jsonapplication/*+json

TicketIdinteger · int32Optional

TicketSourceIdinteger · int32Optional

PersonIdinteger · int32 · nullableOptional

UserIdinteger · int32 · nullableOptional

CreatedAtstring · date-timeOptional

Locationstring · nullableOptional

Contentstring · nullableOptional

Antworten

200

OK

text/plainapplication/jsontext/json

Idinteger · int32Optional

IdNumstring · nullableOptional

CommentIdinteger · int32Optional

400

Bad Request

text/plainapplication/jsontext/json

401

Unauthorized

post

/openwowi/v1.2/CommunicationEdit/Ticket/AddConversation

HTTPcURLJavaScriptPython

POST /openwowi/v1.2/CommunicationEdit/Ticket/AddConversation HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 131

{
  "TicketId": 1,
  "TicketSourceId": 1,
  "PersonId": 1,
  "UserId": 1,
  "CreatedAt": "2026-06-10T17:36:53.415Z",
  "Location": "text",
  "Content": "text"
}

application/jsontext/jsonapplication/*+json

{
  "Id": 1,
  "IdNum": "text",
  "CommentId": 1
}

---

Ticket löschen

Version 1.2

---

delete

Autorisierungen

Authorization

OAuth2passwordErforderlich

Use username and password.

Token URL:

Pfadparameter

ticketIdinteger · int32Erforderlich

Abfrageparameter

apiKeystringOptional

Antworten

200

OK

text/plainapplication/jsontext/json

Idinteger · int32Optional

IdNumstring · nullableOptional

400

Bad Request

text/plainapplication/jsontext/json

401

Unauthorized

delete

/openwowi/v1.2/CommunicationEdit/Ticket/{ticketId}

HTTPcURLJavaScriptPython

DELETE /openwowi/v1.2/CommunicationEdit/Ticket/{ticketId} HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "Id": 1,
  "IdNum": "text"
}

---