Ticket

WARNING

Ticket-Endpunkte hängen von den Gruppenberechtigungen ab und ob der Benutzer, den Sie verwenden, ein Agent ist. Aus diesem Grund können Tickets unter Umständen nicht verfügbar sein.

Auflisten

Erforderliche Berechtigung: ticket.agent oder ticket.customer

GET-Anfrage gesendet: /api/v1/tickets

Show response

Anzeigen

Erforderliche Berechtigung: ticket.agent oder ticket.customer

GET-Anfrage gesendet: /api/v1/tickets/{ticket id}

Show response

// HTTP-Code 200 OK

{
  "id": 3,
  "group_id": 1,
  "priority_id": 2,
  "state_id": 4,
  "organization_id": 3,
  "number": "22003",
  "title": "Order 787556",
  "owner_id": 3,
  "customer_id": 7,
  "note": null,
  "first_response_at": null,
  "first_response_escalation_at": null,
  "first_response_in_min": null,
  "first_response_diff_in_min": null,
  "close_at": null,
  "close_escalation_at": null,
  "close_in_min": null,
  "close_diff_in_min": null,
  "update_escalation_at": null,
  "update_in_min": null,
  "update_diff_in_min": null,
  "last_contact_at": "2021-06-03T09:57:17.987Z",
  "last_contact_agent_at": "2021-06-03T09:57:17.987Z",
  "last_contact_customer_at": "2021-06-01T11:57:17.935Z",
  "last_owner_update_at": null,
  "create_article_type_id": 1,
  "create_article_sender_id": 2,
  "article_count": 2,
  "escalation_at": null,
  "pending_time": null,
  "type": null,
  "time_unit": null,
  "preferences": {},
  "updated_by_id": 4,
  "created_by_id": 7,
  "created_at": "2021-06-01T11:57:17.935Z",
  "updated_at": "2021-11-03T11:57:17.997Z"
}

Erstellen

Erforderliche Berechtigung: ticket.agent oder ticket.customer

POST-Anfrage gesendet: /api/v1/tickets

TIP

Im Namen anderer Benutzer

Wenn Sie Tickets im Namen anderer Benutzer erstellen möchten, verwenden Sie das Attribut customer_id. Das Attribut ticket.agent ist dabei zwingend erforderlich. Verwenden Sie guess:{E-Mail-Adresse}, um einen API-Aufruf zu speichern, wenn Sie die ID des Benutzers nicht kennen oder den betreffenden Benutzer anlegen wollen (customer_id: "guess:jane@doe.com").

Erwähnungen sofort hinzufügen

Fügen Sie das Attribut mentions zu Ihrem Ticket Payload hinzu und übermitteln Sie ein Array von Benutzer IDs, um sie direkt bei der Erstellung des Tickets als Abonnenten anzulegen.

Z.B.: "mentions": [1, 5, 7, 8],

Show request/response

{
  "title": "Help me!",
  "group": "2nd Level",
  "customer": "david@example.com",
  "article": {
    "subject": "My subject",
    "body": "I am a message!",
    "type": "note",
    "internal": false
  }
}

TIP

Weitere Artikel-Attribute und Optionen finden Sie unter Artikel.

Aktualisierung

Erforderliche Berechtigung: ticket.agent oder ticket.customer

PUT-Anfrage gesendet: /api/v1/tickets/{ticket id}

Details

{
  "title": "No help for you",
  "group": "Sales",
  "state": "open",
  "priority": "3 high",
  "article": {
    "subject": "Update via API",
    "body": "Here's my reason for updating this ticket...",
    "internal": true
  }
}

INFO

Das obige Beispiel liefert einen Artikel. Dieser Artikel ist ein neuer Artikel und hat keine Auswirkungen auf bestehende Artikel.

TIP

Anhänge hinzufügen

Der Payload von Anhängen ist identisch mit dem POST-Request, es wird stattdessen lediglich PUT verwendet.

Löschen

Erforderliche Berechtigung: admin

DELETE-Anfrage gesendet: /api/v1/tickets/{ticket id}

DANGER

Dies ist eine dauerhafte Entfernung

Bitte beachten Sie, dass das Entfernen von Tickets nicht rückgängig gemacht werden kann. Alle Daten (z.B. Artikel & Anhänge) gehen dabei verloren.

Show response

Response:

// HTTP-Code 200 OK

{}