Tickets aus eigenen Anwendungen eröffnen (Ticket-API)

Aktualisiert am 19 Nov. 2026 3 Min. Lesezeit
Ticketix-Artikel durchsuchen

Ihre eigenen Anwendungen, zum Beispiel ein Plugin, eine Desktop-App oder eine Website, können Tickets für ihre Nutzer eröffnen und technische Details mitsenden, etwa die Version der Anwendung oder des Servers. Jede Anwendung erhält ihren eigenen Schlüssel. Widerrufen Sie einen Schlüssel, wird die betreffende Anwendung sofort gestoppt.

Wo Sie es finden: Einrichtung → Support → Anwendungsschlüssel (nur Administratoren).

Anwendungsschlüssel erstellen

  1. Öffnen Sie Einrichtung → Support → Anwendungsschlüssel.
  2. Geben Sie den Namen der Anwendung ein, zum Beispiel WordPress plugin. Mitarbeitende sehen diesen Namen als Kanal der damit eröffneten Tickets.
  3. Wählen Sie das Produkt, wenn die Anfrage keines nennt, oder Anfrage muss das Produkt nennen.
  4. Klicken Sie auf Schlüssel erstellen.
  5. Kopieren Sie den Schlüssel jetzt und hinterlegen Sie ihn in den Einstellungen der Anwendung. Er wird nur dieses eine Mal angezeigt; Ticketix speichert nur einen Hash davon.

Die Liste zeigt jede Anwendung mit dem Anfang ihres Schlüssels, ihrem Produkt, der Anzahl ihrer Tickets, wann sie Zuletzt verwendet wurde und wann sie erstellt wurde. Widerrufen sperrt einen Schlüssel sofort; Tickets, die die Anwendung eröffnet hat, behalten ihren Namen.

Ein Ticket eröffnen

Senden Sie eine POST-Anfrage mit einem JSON-Body an /api/ticket-create.php unter der Adresse Ihrer Installation, zum Beispiel https://support.example.com/api/ticket-create.php. Senden Sie den Schlüssel im Header Authorization: Bearer oder in X-Ticketix-Key, falls Ihr Server den Header Authorization verwirft.

POST /api/ticket-create.php
Authorization: Bearer tkx_…
Content-Type: application/json

{
  "email": "customer@example.com",
  "name": "Customer Name",
  "product": "helpdesk",
  "subject": "Licence shows Inactive after moving the site",
  "message": "We moved the site to a new domain …",
  "priority": "normal",
  "technical_details": {
    "WordPress": "6.8",
    "PHP": "8.3",
    "Plugin version": "2.0.2"
  }
}
FeldErforderlichBedeutung
emailJaDie E-Mail-Adresse des Kunden; für eine unbekannte Adresse wird ein neuer Kunde angelegt
nameNeinDer Name des Kunden, bis zu 120 Zeichen
productNeinEin Produktschlüssel; ohne ihn wird das Produkt des Schlüssels verwendet
subjectJaBis zu 200 Zeichen
messageJaReiner Text, bis zu 20.000 Zeichen
priorityNeinlow, normal (Standard) oder high
technical_detailsNeinBis zu 30 Namen und Werte; ein Name bis zu 60 und ein Wert bis zu 500 Zeichen; Werte sind Text, Zahlen oder true und false

Der Anfrage-Body darf bis zu 64 KB groß sein.

Was mit dem Ticket geschieht

  • Das Ticket ist sofort geöffnet; der Schlüssel bürgt für die Anfrage, daher gibt es keine E-Mail-Bestätigung.
  • Der Kunde erhält die übliche E-Mail Ticket erstellt mit dem Ticket-Link, und die Mitarbeiter erhalten die üblichen Benachrichtigungen.
  • Routing-Regeln, Workflows, SLA-Richtlinien und KI-Triage laufen wie bei jedem neuen Ticket.
  • Die Ticket-Ansicht zeigt den Namen der Anwendung als Kanal, „mit technischen Details“, und die technischen Details unter der ersten Nachricht („Gesendet von“ und der Name der Anwendung). Der Kunde sieht dieselben Details in seinem Ticket.

Antworten

StatusBedeutung
201Das Ticket wurde eröffnet; die Antwort enthält ticket_no und status
401Der Schlüssel fehlt, ist falsch oder wurde widerrufen
405Die Anfrage war kein POST
413Der Body ist größer als 64 KB
415Der Body ist kein JSON (Content-Type: application/json)
422Ein Feld ist fehlerhaft; fields nennt jedes Feld mit dem Grund
429Zu viele Tickets: 60 pro Stunde je Anwendung und 10 pro Stunde je Kunde

Unter Nginx muss der Server PHP im Ordner api ausführen; siehe Serveranforderungen von Ticketix.

Verwandte Artikel

Auf dieser Seite

Ticket senden

Erstellen Sie eine neue Supportanfrage, ohne ein Portalkonto zu benötigen.

Priorität
Anhänge
Nur Sie und unser Team sehen ein Ticket. Senden Sie niemals Passwörter oder Lizenzcodes.

Ticket verfolgen

Verwenden Sie die Ticketnummer und das Passwort aus Ihrer Bestätigungs-E-Mail.

Die Nummer und das Passwort finden Sie in Ihrer Bestätigungs-E-Mail.

Anmelden

Greifen Sie auf Ihr Konto im Support-Portal zu.

Neu hier?

Konto erstellen

Erstellen Sie Ihr Konto für das Support-Portal.

Sie haben bereits ein Konto?

Passwort vergessen?

Wir senden Ihnen per E-Mail einen Link, um ein neues Passwort zu wählen.

Verlauf

War das hilfreich?
Ganzen Artikel öffnen
↑ ↓ zum NavigierenEnter zum ÖffnenEsc zum Schließen