Zum Inhalt springen

API-Schlüssel generieren und Webhooks verwalten

Aktualisiert 20. November 2026

Auf dieser Seite

Beide Funktionen finden Sie unter Einstellungen > Integrationen > Verbindungen im Bereich Demodesk API.

API-Schlüssel

Mit einem API-Schlüssel authentifizieren Sie Anfragen an die Demodesk API.

So generieren Sie Ihren API-Schlüssel

Bereich Demodesk API mit einem maskierten API-Schlüssel und der Schaltfläche zum Rotieren des Schlüssels

  1. Öffnen Sie Einstellungen
  2. Öffnen Sie Integrationen
  3. Wählen Sie Verbindungen
  4. Scrollen Sie zum Bereich Demodesk API
  5. Klicken Sie unter API-Schlüssel auf API-Schlüssel generieren

Wenn Sie bereits einen API-Schlüssel haben, können Sie ihn mit API-Schlüssel rotieren durch einen neuen ersetzen.

Über den Sichtbarkeitsschalter blenden Sie den Schlüssel auf dem Bildschirm ein oder aus.

⚠️ Wenn Sie Ihren API-Schlüssel rotieren, wird der aktuelle Schlüssel ungültig. Alle Integrationen, die den bisherigen Schlüssel verwenden, funktionieren dann nicht mehr.

Wer kann einen API-Schlüssel generieren?

Jeder angemeldete Nutzer in einem Unternehmen mit Zugriff auf den Bereich Demodesk API kann seinen eigenen API-Schlüssel generieren und verwalten.

Wann ist der Bereich für API-Schlüssel verfügbar?

Der Bereich Demodesk API ist in jedem kostenpflichtigen Tarif verfügbar und in Testphasen, die mit dem Demodesk-Vertriebsteam eingerichtet wurden. In einer selbst gestarteten Testphase erscheint der Bereich nicht unter Einstellungen > Integrationen > Verbindungen. Er erscheint, sobald Ihr Unternehmen einen kostenpflichtigen Tarif abonniert.

Webhooks

Mit Webhooks sendet Demodesk Ereignisse in Echtzeit an einen externen Endpunkt.

Wer kann Webhooks verwalten?

Nur Unternehmens-Admins können Webhook-Endpunkte erstellen, bearbeiten oder löschen. Manager und reguläre Nutzer können die Webhook-Endpunkte des Unternehmens nicht verwalten.

So fügen Sie einen Webhook-Endpunkt hinzu

Bereich Demodesk API mit dem maskierten API-Schlüssel über dem Webhook-Bereich und der Schaltfläche zum Hinzufügen eines Webhooks

Dialog zum Hinzufügen eines Webhook-Endpunkts mit einem URL-Feld, einer Event-Auswahl mit demo scheduled und benutzerdefinierten Kopfzeilen

  1. Öffnen Sie Einstellungen
  2. Öffnen Sie Integrationen
  3. Wählen Sie Verbindungen
  4. Scrollen Sie zum Bereich Demodesk API
  5. Klicken Sie im Bereich Webhooks auf Webhook
  6. Geben Sie die Webhook-URL ein
  7. Wählen Sie das Event, das Sie abonnieren möchten
  8. Fügen Sie optional benutzerdefinierte Kopfzeilen hinzu
  9. Klicken Sie auf Endpunkt hinzufügen

So bearbeiten Sie einen Webhook-Endpunkt

  1. Öffnen Sie Einstellungen > Integrationen > Verbindungen
  2. Öffnen Sie den Bereich Demodesk API
  3. Suchen Sie in der Liste Webhooks den Endpunkt, den Sie ändern möchten
  4. Klicken Sie auf Webhook bearbeiten
  5. Ändern Sie URL, Event oder Kopfzeilen
  6. Klicken Sie auf Änderungen speichern

So löschen Sie einen Webhook-Endpunkt

  1. Öffnen Sie Einstellungen > Integrationen > Verbindungen
  2. Öffnen Sie den Bereich Demodesk API
  3. Suchen Sie den Webhook-Endpunkt, den Sie entfernen möchten
  4. Klicken Sie auf das Löschen-Symbol
  5. Bestätigen Sie das Entfernen

Danach empfängt dieser Endpunkt keine Demodesk-Ereignisse mehr.

Was lässt sich für einen Webhook konfigurieren?

Jeder Webhook-Endpunkt kann Folgendes enthalten:

  • Eine Webhook-URL
  • Ein Event
  • Optional benutzerdefinierte Kopfzeilen

Benutzerdefinierte Kopfzeilen eignen sich zum Beispiel für die Authentifizierung:

  • Authorization: Bearer abc123

Webhook-Status

Webhook-Endpunkte können folgende Status haben:

  • Fehlerfrei
  • Fehlerhaft
  • Deaktiviert

Wenn ein Webhook dauerhaft fehlschlägt, kann er nach zu vielen fehlgeschlagenen Zustellversuchen deaktiviert werden.

Regeln für benutzerdefinierte Kopfzeilen

Beim Konfigurieren von Webhook-Kopfzeilen gilt:

  • Jede benutzerdefinierte Kopfzeile braucht einen Namen und einen Wert
  • Kopfzeilennamen müssen eindeutig sein
  • Einige Kopfzeilen sind reserviert und werden von Demodesk automatisch verwaltet

Diese HTTP-Kopfzeilen können Sie nicht manuell setzen:

  • Content-Type
  • Content-Length
  • Host

Verfügbare Webhook-Events

Demodesk unterstützt Webhook-Events für wichtige Meeting- und Aufzeichnungsaktionen, darunter:

  • demo.scheduled
  • demo.rescheduled
  • demo.event_response_updated
  • demo.handovered
  • demo.canceled
  • demo.started
  • demo.call_note_updated
  • demo.ended
  • recording.uploaded
  • recording.transcription_postprocessed

Details zu den Nutzdaten finden Sie in der Webhook-Nutzdaten API-Referenz (auf Englisch).

FAQ

Welche Tarife enthalten die Demodesk API?

Jeder kostenpflichtige Tarif enthält die Demodesk API. Eine mit dem Demodesk-Vertriebsteam eingerichtete Testphase enthält sie ebenfalls. In einer selbst gestarteten Testphase erscheint der Bereich Demodesk API, sobald Ihr Unternehmen einen kostenpflichtigen Tarif abonniert. Sobald Ihr Unternehmen den Bereich hat, kann jeder Nutzer seinen eigenen API-Schlüssel generieren, und Unternehmens-Admins können zusätzlich Webhooks verwalten.

Sie brauchen weitere Hilfe?

Wenn Sie den Bereich Demodesk API nicht sehen, prüfen Sie bitte:

  • ob Ihr Unternehmen einen kostenpflichtigen Tarif oder eine mit dem Demodesk-Vertriebsteam eingerichtete Testphase hat
  • ob Sie Unternehmens-Admin sind, falls Sie Webhooks verwalten möchten

Wenn Sie weitere Hilfe benötigen, wenden Sie sich an den Demodesk Support unter support@demodesk.com

Verwandte Artikel

Noch Fragen?

Unser Support-Team antwortet im App-Chat oder unter support@demodesk.com.