Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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
OAuth2passwordErforderlich

Use username and password.

Token URL:
Abfrageparameter
apiKeystringOptional
Body
Subjectstring · nullableOptional
Contentstring · nullableOptional
SourceIdinteger · int32Optional
PriorityIdinteger · int32Optional
DepartmentIdinteger · int32 · nullableOptional
UserIdinteger · int32 · nullableOptional
ExternalReferencestring · nullableOptional
Antworten
201

Created

Idinteger · int32Optional
IdNumstring · nullableOptional
post/openwowi/v1.2/CommunicationEdit/Ticket
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
    }
  ]
}
{
  "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
OAuth2passwordErforderlich

Use username and password.

Token URL:
Abfrageparameter
apiKeystringOptional
Body
TicketIdinteger · int32Optional
Contentstring · nullableOptional
PersonIdinteger · int32 · nullableOptional
Antworten
200

OK

Idinteger · int32Optional
IdNumstring · nullableOptional
CommentIdinteger · int32Optional
post/openwowi/v1.2/CommunicationEdit/Ticket/AddComment
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
}
{
  "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
OAuth2passwordErforderlich

Use username and password.

Token URL:
Abfrageparameter
apiKeystringOptional
Body
TicketIdinteger · int32Optional
TicketSourceIdinteger · int32Optional
PersonIdinteger · int32 · nullableOptional
UserIdinteger · int32 · nullableOptional
CreatedAtstring · date-timeOptional
Locationstring · nullableOptional
Contentstring · nullableOptional
Antworten
200

OK

Idinteger · int32Optional
IdNumstring · nullableOptional
CommentIdinteger · int32Optional
post/openwowi/v1.2/CommunicationEdit/Ticket/AddConversation
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-01-01T00:00:00.000Z",
  "Location": "text",
  "Content": "text"
}
{
  "Id": 1,
  "IdNum": "text",
  "CommentId": 1
}

Ticket löschen

Version 1.2

delete
Autorisierungen
OAuth2passwordErforderlich

Use username and password.

Token URL:
Pfadparameter
ticketIdinteger · int32Erforderlich
Abfrageparameter
apiKeystringOptional
Antworten
200

OK

Idinteger · int32Optional
IdNumstring · nullableOptional
delete/openwowi/v1.2/CommunicationEdit/Ticket/{ticketId}
DELETE /openwowi/v1.2/CommunicationEdit/Ticket/{ticketId} HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "Id": 1,
  "IdNum": "text"
}
VorherigeTicket lesen
NächsteKataloge

Zuletzt aktualisiert