Was kann die Deskwoot REST API?

Die Deskwoot REST API gibt dir programmatischen Zugriff auf deine Support-Daten, sodass du Unterhaltungen lesen und erstellen, Kontakte verwalten, Nachrichten senden und abrufen sowie Deskwoot in deine eigenen Werkzeuge und Skripte einbinden kannst. Sie ist eine Enterprise-Funktion, und du authentifizierst jede Anfrage mit einem Token, den du unter Einstellungen > API-Tokens erstellst.

Was kannst du mit der API tun?

Die REST API deckt die alltäglichen Objekte in deinem Helpdesk ab. Mit den richtigen Token-Geltungsbereichen kannst du:

• Unterhaltungen: Unterhaltungen auflisten, lesen, erstellen und aktualisieren sowie ihren Status oder ihre Zuweisung ändern.
• Nachrichten: die Nachrichten in einer Unterhaltung abrufen und neue Antworten oder private Notizen posten.
• Kontakte: die Personen, die sich melden, lesen, erstellen und aktualisieren, einschließlich ihrer Attribute.

Das macht die API gut geeignet, um Tickets mit einem internen System zu synchronisieren, ein eigenes Dashboard zu bauen, Routineaktualisierungen zu automatisieren oder Unterhaltungsdaten in ein anderes Werkzeug einzuspeisen.

Welcher Tarif enthält die REST API?

Die REST API ist eine Enterprise-Funktion. Sie ist außerdem während der 7-tägigen Enterprise-Testphase verfügbar, mit der jedes neue Konto startet, sodass du dagegen entwickeln kannst, bevor du dich festlegst. Wenn du auf einem niedrigeren Tarif bist und API-Zugriff brauchst, musst du auf Enterprise sein.

Wie bekomme ich einen Token?

Tokens werden unter Einstellungen > API-Tokens erstellt und verwaltet. Gib jedem Token einen klaren Namen, gewähre nur die Geltungsbereiche, die die Integration braucht, und kopiere ihn sofort nach der Erstellung, da der vollständige Wert möglicherweise nicht erneut angezeigt wird. Im Leitfaden zu API-Tokens findest du die vollständige Anleitung, einschließlich der Basis-URL und wie du den Token im Authorization-Header übergibst.

Was, wenn ich einen KI-Agenten möchte, statt Code zu schreiben?

Wenn dein Ziel ist, einen externen KI-Agenten das Helpdesk bedienen zu lassen, statt deine eigene Integration zu schreiben, ist der MCP-Server möglicherweise besser geeignet. Er stellt einem MCP-fähigen Agenten über einen eingegrenzten Bot-Token eine definierte Reihe von Werkzeugen bereit, und wie die REST API ist er eine Enterprise-Funktion.