Supporttickets per REST-API direkt aus Ihrer App erstellen

Ihr Produkt weiß oft schon von einem Problem, bevor Ihr Kunde sich meldet. Eine Zahlung schlägt fehl, ein Sync-Job bricht mit einem Fehler ab, ein Nutzer tippt auf „Problem melden”. Landen diese Ereignisse in derselben Queue wie die E-Mails Ihrer Kunden, hat Ihr Team nur einen Ort, an dem es nachsehen muss – und Kunden bekommen Hilfe, bevor sie danach fragen müssen.

Dieser Leitfaden zeigt, wie Sie mit der Uplio REST-API Supporttickets direkt aus Ihrem eigenen Code erstellen.

Was Sie brauchen

• Ein Uplio-Konto mit einem Workspace
• Einen API-Key, den Sie in Ihren Kontoeinstellungen erstellen
• Ihre Workspace-ID, die im Dashboard mit einem Kopier-Button angezeigt wird

Ein Ticket mit curl erstellen

Die API spricht JSON über HTTPS und authentifiziert per Bearer-Token:

curl -X POST "https://app.uplio.io/api/v1/tickets?workspaceId=YOUR_WORKSPACE_ID" \
  -H "Authorization: Bearer $UPLIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Zahlung für Bestellung #1042 fehlgeschlagen",
    "description": "Stripe hat beim Checkout card_declined zurückgegeben.",
    "priority": "high",
    "userId": "[email protected]"
  }'

Nur title ist ein Pflichtfeld. userId ist die E-Mail-Adresse (oder Nutzer-ID) der Person, um die es im Ticket geht, und priority ist low, normal oder high. Das neue Ticket erscheint in der Spalte „Offen” Ihres Boards, und die Manager Ihres Workspaces erhalten eine Benachrichtigung per E-Mail.

Ein Ticket aus JavaScript erstellen

Dieselbe Anfrage aus einem Node.js-Backend:

async function createTicket({ title, description, email, priority = "normal" }) {
  const res = await fetch(
    `https://app.uplio.io/api/v1/tickets?workspaceId=${process.env.UPLIO_WORKSPACE_ID}`,
    {
      method: "POST",
      headers: {
        Authorization: `Bearer ${process.env.UPLIO_API_KEY}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({ title, description, priority, userId: email }),
    },
  );
  if (!res.ok) throw new Error(`Uplio-API-Fehler: ${res.status}`);
  return res.json();
}

Bewahren Sie den API-Key auf Ihrem Server auf. Liefern Sie ihn niemals in Browser- oder Mobile-Code aus; senden Sie In-App-Meldungen zuerst an Ihr eigenes Backend und erstellen Sie das Ticket von dort aus.

Drei Muster, die sich lohnen

1. Der „Problem melden”-Button in der App

Erfassen Sie in Ihrer Oberfläche eine kurze Beschreibung, ergänzen Sie Kontext, den der Nutzer nie selbst eintippen würde (Konto-ID, App-Version, aktuelle Seite), und erstellen Sie daraus ein Ticket. So hat Ihr Team von Anfang an alles, was es braucht.

2. Automatische Eskalation von Fehlern

Wenn ein Hintergrundjob so fehlschlägt, dass ein Kunde davon betroffen ist, eröffnen Sie ein Ticket mit Priorität high. Der Support kann sich proaktiv melden – und das bemerken und schätzen Kunden.

3. Behalten Sie Ihr eigenes Formulardesign

Wenn Sie bereits ein sorgfältig gestaltetes Kontaktformular haben, behalten Sie es. Senden Sie die Einträge an die API statt an eine E-Mail-Adresse, und sie kommen als strukturierte Tickets an.

Nächste Schritte

Tickets unterstützen auch Nachrichten: Mit POST /api/v1/tickets/{id}/messages fügen Sie einem Ticket eine Nachricht hinzu, mit PATCH /api/v1/tickets/{id} aktualisieren Sie Status oder Priorität. Die vollständige Liste aller Endpunkte und Schemas finden Sie in der interaktiven API-Referenz.