Entwicklerdokumentation
Alles, was du brauchst, um Deskwoot mit deinem Stack zu verbinden. Bau das Chat-Widget in deine Website ein oder steuere Konversationen, Kontakte und Posteingänge aus deinem Backend.
Mit der REST-API können deine eigenen Systeme Konversationen anlegen und beantworten, Kontakte und benutzerdefinierte Attribute pflegen und auf Webhook-Events reagieren. Du authentifizierst dich mit einem Bearer-Token aus Einstellungen → API-Tokens. Jeder Token hat eigene Berechtigungen: Ein Reporting-Job bekommt nur Lesezugriff, deine Backoffice-Integration darf schreiben. API-Tokens gibt es im Enterprise-Tarif.
Das JavaScript-Widget bringt den Deskwoot-Live-Chat auf deine Website. Es besteht aus einem Script-Tag und einem kleinen Einstellungsobjekt und bringt Live-Nachrichten, Dateianhänge, eine verifizierte Anmeldung für eingeloggte Nutzer und Fynn, unseren KI-Agenten, mit. Für mehr Kontrolle, etwa um den Chat über deinen eigenen Button zu öffnen oder einen Nutzer nach dem Laden der Seite anzumelden, stellt der Loader eine kleine API unter window.deskwoot bereit.
Neu hier? Fang mit dem Widget an: Es ist ein einziges Snippet in deinem Seiten-Template. Wechsle zur REST-API, sobald du CRM-Daten synchronisieren oder Konversationen aus deinen eigenen Apps eröffnen willst.
JavaScript-Chat-Widget
Bring den Deskwoot-Live-Chat auf deine Website. Füge ein Snippet ein, verifiziere eingeloggte Nutzer und öffne den Chat über deine eigenen Buttons.
- Embed-Snippet
- Konfigurationsoptionen
- JavaScript-API
- Nutzer-Verifizierung
- CSP-Hinweise
REST-API
Programmatischer Zugriff auf Konversationen, Kontakte, Posteingänge, Teams und mehr. Authentifiziere dich mit einem API-Token und steuere Deskwoot aus deinem Backend.
- Authentifizierung
- Konversationen
- Kontakte
- Posteingänge
- Webhooks
Verwandtes im Dashboard
Manche Integrationen richtest du direkt in deinem Deskwoot-Dashboard ein:
- Einstellungen → Webhooks
- Abonniere Konversations-, Nachrichten- und Kontakt-Events über HTTP-Callbacks.
- Einstellungen → Integrationen
- Verbinde Shopify, Stripe und WooCommerce, poste Benachrichtigungen in Slack und schick Ereignisse über Zapier an Tausende andere Apps.
- Einstellungen → API-Tokens
- Erstelle Tokens mit eigenen Berechtigungen für die REST-API.
Fehlt eine Integration oder brauchst du Hilfe beim Verkabeln? Erreiche uns unter hello@deskwoot.com.
Häufig gestellte Fragen
Die kurzen Antworten stehen hier. Für alles andere frag unten Fynn.
Hat Deskwoot eine REST-API?
Ja. Die REST-API deckt Konversationen, Nachrichten, Kontakte, Posteingänge, Agenten, Teams, Labels, benutzerdefinierte Attribute, Automatisierungsregeln, Webhooks und Hilfecenter-Artikel ab. Die vollständige Referenz mit curl-Beispielen findest du unter deskwoot.com/docs/api. API-Tokens gibt es im Enterprise-Tarif.
Wie authentifiziere ich API-Anfragen?
Erstelle einen Token unter Einstellungen → API-Tokens und sende ihn bei jeder Anfrage als Bearer-Token im Authorization-Header. Jeder Token gehört zu einem Workspace, hat eigene Berechtigungen (zum Beispiel read, write oder contacts:read) und lässt sich jederzeit widerrufen, ohne deine anderen Tokens zu berühren.
Gibt es Webhooks für neue Konversationen und Nachrichten?
Ja. Deskwoot sendet Webhooks, wenn eine Konversation erstellt, aktualisiert, zugewiesen oder gelöst wird, wenn eine Nachricht erstellt wird, wenn ein Kontakt erstellt oder aktualisiert wird und wenn eine CSAT-Umfrage abgeschickt wird. Webhook-URLs legst du für den ganzen Workspace unter Einstellungen → Webhooks an und wählst pro URL die Events. Jede Zustellung trägt einen X-Deskwoot-Signature-Header (HMAC SHA256), damit du prüfen kannst, dass sie von uns kommt.
Gibt es eine OpenAPI-Spezifikation oder eine Postman-Collection?
Ja. Die OpenAPI-3.1-Spezifikation liegt unter deskwoot.com/openapi.yaml. Importiere sie in Postman, Insomnia oder ein anderes OpenAPI-Tool, um die Endpunkte zu durchsuchen oder einen Client in deiner Sprache zu erzeugen.