Benutzerdefinierte Integrationen in Demodesk einrichten und verwenden
Benutzerdefinierte Integrationen ermöglichen es Ihrem Team, externe Tools mit Demodesk zu verbinden und zu steuern, welche API-Endpunkte die KI verwenden darf. Dadurch können Systeme wie HubSpot, Slack, Intercom, GitLab, Gmail und mehr verbunden werden. Der API-Schlüssel muss weiterhin in den Einstellungen hinzugefügt werden. Jede Verbindung enthält konfigurierbare Endpunkt-Berechtigungen, sodass Administratoren festlegen können, was die KI tun darf.
Wo Sie Benutzerdefinierte Integrationen finden
Um eine Benutzerdefinierte Integration in Demodesk hinzuzufügen oder zu verwalten, gehen Sie zu:
Hier können Administratoren neue API-Verbindungen erstellen, bestehende verwalten, API-Schlüssel hinzufügen und Endpunkt-Berechtigungen festlegen.
So fügen Sie eine Benutzerdefinierte Integration hinzu
So erstellen Sie eine neue benutzerdefinierte API-Verbindung:
Öffnen Sie Einstellungen
Gehen Sie zu Integrationen
Wählen Sie Verbindungen
Öffnen Sie Benutzerdefinierte APIs
Klicken Sie, um eine neue benutzerdefinierte API hinzuzufügen oder eine bestehende zu öffnen
Geben Sie die folgenden Details ein:
Name
Basis-URL
API-Schlüssel
Aktivieren Sie die Integration für den KI-Analysten
Fügen Sie die erlaubten Endpunkt-Berechtigungen hinzu
Optional: Fügen Sie Anweisungen für die KI hinzu
Klicken Sie auf Speichern
Was Sie verbinden können
Sie können benutzerdefinierte APIs verwenden, um Demodesk mit externen Systemen zu verbinden, z. B.:
HubSpot
Slack
GitLab
Gmail
Intercom
Amplemarket
Wie benutzerdefinierte APIs funktionieren
Eine benutzerdefinierte API-Verbindung ist mehr als nur ein gespeicherter API-Schlüssel. Sie legt auch fest, wie die KI diese API verwenden kann.
Jede Verbindung umfasst:
Einen Namen zur Identifizierung der Integration
Eine Basis-URL für den externen Dienst
Einen API-Schlüssel
Einen Aktiviert-Schalter, um die Integration für den KI-Analysten verfügbar zu machen
Eine oder mehrere Endpunkt-Berechtigungen
Optionale Anweisungen für die KI
Dieses Setup gibt Administratoren die Kontrolle darüber, auf welche Teile einer externen API die KI zugreifen kann.
Endpunkt-Berechtigungen konfigurieren
Endpunkt-Berechtigungen legen fest, welche Anfragen die KI stellen darf.
Für jede Berechtigung können Sie konfigurieren:
Ob die Berechtigung aktiviert ist
Die erlaubten HTTP-Methoden, z. B. GET oder POST
Ein URL-Muster, z. B. /* oder /crm/v3/objects/*/search
Einen optionalen Kommentar zur Beschreibung des Zwecks der Berechtigung
Beispielsweise erlaubt eine Berechtigung GET-Anfragen an /*, während eine andere POST-Anfragen erlaubt.
Dadurch können Administratoren den Zugriff genau auf die für den Anwendungsfall benötigten Endpunkte beschränken, anstatt die gesamte API ohne Einschränkungen freizugeben.
Anweisungen für die KI hinzufügen
Sie können auch optionale Anweisungen hinzufügen, um zu steuern, wie die KI die API verwenden soll.
Dies kann hilfreich sein, wenn Sie klarstellen möchten, welche Endpunkte für bestimmte Aktionen vorgesehen sind, Kontext über das verbundene System bereitstellen oder die KI zu einer sicheren und erwartungsgemäßen Nutzung lenken möchten.
Wichtiger Sicherheitshinweis
Jeder Benutzer im Unternehmen kann jede konfigurierte benutzerdefinierte API verwenden. Daher sollten Administratoren sorgfältig abwägen, welche API-Schlüssel sie hinzufügen und wie viel Zugriff diese Schlüssel gewähren.
Als Best Practice empfiehlt sich:
Nur die Endpunkte erlauben, die die KI tatsächlich benötigt
Nur die erforderlichen HTTP-Methoden erlauben
Möglichst API-Schlüssel mit eingeschränkten Berechtigungen verwenden
Übermäßig weitreichende oder hochprivilegierte API-Schlüssel vermeiden
Im Idealfall sollte der API-Schlüssel nur so viele Rechte haben, wie der vorgesehene Anwendungsfall erfordert.