Kundensupport-API für individuelle Integrationen und Kanäle
Die Kundensupport-API von Deskwoot deckt Konversationen, Kontakte, Nachrichten, Teammitglieder, Labels und benutzerdefinierte Attribute ab. Bau eigene Kanäle, einen Chat in deiner App oder das Weiterleiten von Warnungen auf dem gemeinsamen Posteingang auf.
Überblick
Viele Helpdesks behandeln die API stiefmütterlich und lassen genau die Endpunkte weg, die du brauchst. Die Kundensupport-API von Deskwoot gehört zum Enterprise-Plan und deckt Konversationen, Nachrichten, Kontakte, Posteingänge, Labels, Teams, Webhooks und mehr ab, dokumentiert in einer OpenAPI-Spezifikation.
REST und Webhooks: Konversationen, Kontakte, Nachrichten, Labels, Teams, benutzerdefinierte Attribute und mehr sind per REST verfügbar. Webhooks schicken Ereignisse wie erstellte, zugewiesene oder gelöste Konversationen, neue Nachrichten, Kontaktänderungen und CSAT-Bewertungen signiert an deine URL, dein Code reagiert also auf Ereignisse, statt abzufragen.
Authentifizierung: API-Tokens mit Scopes. Gib jeder Integration nur, was sie braucht, zum Beispiel Lesezugriff oder den eigenen Scope, der Nachrichten der Kundschaft in einen API-Posteingang schreiben darf.
Eigene Kanäle: Lege einen REST-API-Posteingang an, schick die Nachrichten deiner Kundschaft mit deiner eigenen ID pro Nachricht dorthin und hinterlege eine Callback-URL. Eine wiederholte Anfrage erzeugt nie ein Duplikat, und Antworten deines Teams und von Fynn gehen an deine Callback-URL, ein Chat in deiner App oder jeder andere Kanal, der nicht eingebaut ist, funktioniert also wie die anderen.
Typische Muster: 1) Chat in einer mobilen App, bei dem dein Backend Nachrichten an einen API-Posteingang schickt, 2) ein Kontaktformular auf deiner Website, das über die API eine Konversation eröffnet, 3) Geräte- oder Systemwarnungen, die als Konversationen im Posteingang landen, 4) das Abgleichen von Kontakten und Konversationsdaten mit deinen eigenen Systemen.
Das bekommst du mit API-Support
REST und Webhooks
Konversationen, Kontakte und Nachrichten lesen und schreiben und Webhooks für Ereignisse bekommen.
Sichere Wiederholungen
Jede eingehende Nachricht trägt deine eigene ID, eine wiederholte Anfrage erzeugt also nie ein Duplikat.
API-Tokens mit Scopes
Jedes Token bekommt nur die Scopes, die eine Integration braucht.
OpenAPI-Spezifikation
Die vollständige Referenz steht unter /docs/api, mit einer OpenAPI-Datei für Postman, Insomnia oder deinen eigenen Client-Generator.
Callbacks für Antworten
Hinterlege eine Callback-URL am API-Posteingang, und Antworten deines Teams und von Fynn gehen an dein System.
So legst du los
Verbinde API in 3 Schritten.
- Erstelle im Enterprise-Plan unter Einstellungen → API-Token ein API-Token.
- Lege einen REST-API-Posteingang an und schick Nachrichten der Kundschaft an seinen Inbound-Endpunkt.
- Hinterlege eine Callback-URL, um die Antworten zu empfangen.
