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
- Öffnen Sie Einrichtung → Support → Anwendungsschlüssel.
- Geben Sie den Namen der Anwendung ein, zum Beispiel
WordPress plugin. Mitarbeitende sehen diesen Namen als Kanal der damit eröffneten Tickets. - Wählen Sie das Produkt, wenn die Anfrage keines nennt, oder Anfrage muss das Produkt nennen.
- Klicken Sie auf Schlüssel erstellen.
- 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"
}
}
| Feld | Erforderlich | Bedeutung |
|---|---|---|
| Ja | Die E-Mail-Adresse des Kunden; für eine unbekannte Adresse wird ein neuer Kunde angelegt | |
| name | Nein | Der Name des Kunden, bis zu 120 Zeichen |
| product | Nein | Ein Produktschlüssel; ohne ihn wird das Produkt des Schlüssels verwendet |
| subject | Ja | Bis zu 200 Zeichen |
| message | Ja | Reiner Text, bis zu 20.000 Zeichen |
| priority | Nein | low, normal (Standard) oder high |
| technical_details | Nein | Bis 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
| Status | Bedeutung |
|---|---|
| 201 | Das Ticket wurde eröffnet; die Antwort enthält ticket_no und status |
| 401 | Der Schlüssel fehlt, ist falsch oder wurde widerrufen |
| 405 | Die Anfrage war kein POST |
| 413 | Der Body ist größer als 64 KB |
| 415 | Der Body ist kein JSON (Content-Type: application/json) |
| 422 | Ein Feld ist fehlerhaft; fields nennt jedes Feld mit dem Grund |
| 429 | Zu 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.