Deskwoot für API
Kundensupport-API für individuelle Integrationen und Kanäle
Die Deskwoot-Kundensupport-API legt alles offen: Konversationen, Kontakte, Nachrichten, Agent:innen, Tags, eigene Felder. Baue eigene Kanäle, In-App-Chat, IoT-Alert-Routing oder vollständige White-Label-Support-Flows.
Die meisten Helpdesks behandeln die API als Nachgedanken, hinter Enterprise-Plänen versteckt und ohne die Endpunkte, die du tatsächlich brauchst. Deskwoots Kundensupport-API ist in jedem Plan enthalten, einschließlich der kostenlosen Stufe.
REST + Webhooks: jede Entität (Konversationen, Kontakte, Nachrichten, Agent:innen, Tags, eigene Felder) hat ein vollständiges CRUD-Interface. Webhooks feuern bei jedem Statuswechsel, dein Integrationscode bleibt also event-gesteuert statt poll-basiert.
Authentifizierung: OAuth 2.0 für Endbenutzer-Kontexte (baue einen 'Mit Deskwoot anmelden'-Flow in deine eigene App), statische API-Tokens für Service-zu-Service. Per-Token-Scopes ermöglichen Read-only- oder eingeschränkte Berechtigungen für bestimmte Integrationen.
Eigene Kanäle: Tagge jede Konversation mit einem eigenen 'source'-Identifier, sodass du sie separat routen, filtern oder reporten kannst. Praktisch für In-App-Chat, IoT-Alert-Aufnahme oder jeden nicht standardmäßigen Kanal, den die eingebauten Posteingänge nicht abdecken.
Häufige API-first-Kundensupport-Muster, die wir sehen: 1) In-App-Chat aus einer Mobile-App, wo das SDK direkt an die API postet, 2) Form-zu-Ticket-Workflows, wo ein Kontaktformular auf deiner Seite per Webhook ein Deskwoot-Ticket erstellt, 3) IoT-Geräte-Support, wo ein Raspberry Pi oder Industriesensor die API bei Fehlern pingt, 4) White-Label-Support-Widgets, wo ein SaaS Deskwoot unter eigener Marke weiterverkauft.
Das bekommst du mit API-Support
REST + Webhooks
Nachrichten reinschicken, Callbacks für Antworten erhalten. Beide Richtungen dokumentiert. Event-gesteuerte Architektur out of the box.
Pro-Konversation-Quellen-Tagging
Tagge jede Konversation mit einem eigenen Quellen-Identifier, sodass du eigene Kanäle separat routen oder filtern kannst.
OAuth und API-Tokens
Verwende OAuth für Endbenutzer-Kontexte oder statische API-Tokens für Service-zu-Service. Per-Token-Scopes für granularen Zugriff.
SDK-Support
Offizielle SDKs für Node.js, Python und ein JavaScript-Widget-SDK für In-App-Chat. Community-SDKs für Ruby, PHP und Go.
Idempotency-Keys
Jeder Schreib-Endpunkt akzeptiert einen Idempotency-Key, Wiederholungen sind also sicher. Entscheidend für unzuverlässige Netzbedingungen.
Einrichtung in Minuten
Verbinde API in 3 Schritten. Kein Code nötig.
- 1Hole dein API-Token aus Einstellungen → API.
- 2POST an /api/v1/conversations, um eine Konversation zu erstellen.
- 3Richte eine Webhook-URL ein, um Antworten zu empfangen.
FAQ zum API-Kundensupport
- Was ist die beste Kundensupport-API für eigene Integrationen?
- Für eigene Kanäle und White-Label-Anwendungen braucht die Kundensupport-API: vollständiges CRUD auf Konversationen und Kontakte, Webhooks für Events, OAuth- und Token-Auth, Idempotency-Keys und gute Doku. Deskwoot deckt das alles ab. Zendesk und Intercom haben auch starke APIs, sind aber typischerweise hinter Premium-Plänen versteckt.
- Was ist eine API-first-Kundensupport-Software?
- API-first-Kundensupport-Software stellt ihren gesamten Funktionsumfang über die API bereit, nicht nur eine Teilmenge. Jede UI-Aktion (Tickets zuweisen, Nachrichten senden, Kontakte aktualisieren) hat einen entsprechenden API-Endpunkt. Deskwoot ist API-first; die API kam in unserem Build-Prozess vor der UI.
- Wo finde ich die Kundensupport-API-Doku?
- Die vollständige API-Referenz liegt unter /docs/api. SDKs für Node.js und Python sind dort verlinkt. Die OpenAPI-Spezifikation ist für Tools wie Postman und Insomnia veröffentlicht.
- Wie baue ich einen eigenen Kanal mit der API?
- POST an /api/v1/conversations mit deinem eigenen 'source'-Identifier. Richte einen Webhook ein, um Agenten-Antworten zu empfangen. Dein eigener Kanal (In-App-Chat, IoT etc.) sendet und empfängt über deinen eigenen Integrationscode; Deskwoot kümmert sich um Posteingangs-Semantik, KI, SLA und Reporting.
- Gibt es Rate Limits für die Kundensupport-API?
- Ja. Standardmäßig 1000 Anfragen pro Minute pro Token. Höhere Limits in bezahlten Plänen oder auf Anfrage. 429-Antworten enthalten Retry-After-Header.
- Unterstützt die API Webhooks für jedes Event?
- Ja. Konversation erstellt, gelöst, wiedereröffnet, Nachricht empfangen, Kontakt aktualisiert, Tag hinzugefügt, Status geändert. Webhook-Zustellung ist at-least-once mit Wiederholungen bei 5xx-Antworten.
- Kann ich die API nutzen, um aus einem anderen Helpdesk zu migrieren?
- Ja. Der Bulk-Import-Endpunkt akzeptiert Kontakte, Konversationen und Nachrichten in einem Aufruf. Wir haben fertige Migrationsskripte für Zendesk, Intercom, Help Scout, Front und Chatwoot.