Integrationen einrichten
Integrationen verbinden Ihren KI-Agenten mit externen Systemen — zum Beispiel einem CRM, einem Kalender oder einer eigenen API. Jede Integration stellt Aktionen bereit, die der Agent rund um ein Gespräch ausführen kann.
Was Sie erreichen werden
Nach dieser Anleitung können Sie:
- Eine Integration aus dem Plattform-Katalog oder als eigene API-Anbindung anlegen
- Zugangsdaten hinterlegen und die Verbindung testen
- Die Integration Ihrem Agenten zuweisen — der entscheidende Schritt
- Aktionen pro Agent aktivieren und den Ausführungszeitpunkt wählen
Voraussetzungen
- Ein eingerichteter Agent (Agent erstellen)
- Berechtigung für Integrationen: Ihre Benutzerrolle muss Integrationen anzeigen und erstellen dürfen. Fehlt die Berechtigung, sehen Sie die Seite nicht oder die Meldung Keine Berechtigung für Integrationen.
- Freischaltung im Paket: Integrationen müssen in Ihrem Paket enthalten sein. Ist das Feature nicht freigeschaltet, können Sie keine neue Integration erstellen, auch mit passender Rolle nicht.
Hinweis: Wenn der Button Neue Integration fehlt oder nicht reagiert, liegt es fast immer an einem dieser beiden Punkte. Klären Sie die Rolle mit dem Administrator Ihrer Organisation; bei Fragen zur Paket-Freischaltung hilft support@dalvon.ai.
Konzept: Plattform-Katalog oder eigene API
Beim Erstellen einer Integration haben Sie zwei Wege:
| Verfügbare Plattformen | Eigene API (Custom API) | |
|---|---|---|
| Was ist das? | Vorgefertigte Anbindungen aus dem Katalog mit fertigen Aktionen | Anbindung einer beliebigen REST-API mit eigenen Zugangsdaten |
| Konfiguration | Nur die vorgegebenen Felder ausfüllen | Basis-URL, Authentifizierungsmethode und Aktionen selbst definieren |
| Verbindung testbar | Ja (wenn Zugangsdaten hinterlegt sind) | Nein |
| Geeignet für | Standard-Systeme aus dem Katalog | Eigene Systeme und Spezialfälle |
Für eigene APIs definieren Sie die Aktionen selbst — wie das geht, beschreibt Eigene Aktionen.
Schritt 1: Integration anlegen
- Öffnen Sie in der Seitenleiste Agenten → Integrationen
- Klicken Sie auf Neue Integration
- Wählen Sie im Panel Integration erstellen eine Plattform aus Verfügbare Plattformen — oder Custom API unter Eigene API
Über das Suchfeld Plattformen durchsuchen finden Sie Plattformen nach Name oder Beschreibung.
Schritt 2: Verbindung konfigurieren
Allgemein
| Feld | Eingabe |
|---|---|
| Name | Eindeutiger Name, z. B. CRM Production (Pflichtfeld) |
| Beschreibung | Optional: Wofür wird diese Integration verwendet? |
| Base URL | Nur bei eigener API oder wenn die Plattform es erlaubt — die Basis-Adresse der API |
Zusätzlich wählen Sie die Sichtbarkeit: Sie bestimmt, wer in Ihrer Organisation die Integration sehen und verwenden darf.
Authentifizierung
Bei Katalog-Plattformen zeigt das Formular genau die Felder an, die die Plattform benötigt — meist einen API-Schlüssel oder Zugangsdaten des externen Systems. Hilfetexte unter den Feldern erklären, woher die Werte kommen.
Bei einer eigenen API wählen Sie unter Auth Methode selbst, wie sich der Agent gegenüber Ihrem System ausweist:
| Methode | Wann verwenden |
|---|---|
| Keine | Die API benötigt keine Authentifizierung |
| Bearer Token | Token im Authorization: Bearer-Header |
| API Key (Header) | API-Schlüssel in einem eigenen Header, z. B. X-Api-Key |
| API Key (Query) | API-Schlüssel als Query-Parameter in der URL |
| Basic Auth | Benutzername und Passwort |
| OAuth2 Client | Client-ID, Client-Secret und Token-URL (Client-Credentials-Flow) |
| Custom Headers | Eigene Header als JSON definieren |
Klicken Sie anschließend auf Speichern.
Hinweis: Beim Bearbeiten einer Integration werden hinterlegte Zugangsdaten aus Sicherheitsgründen nicht angezeigt. Lassen Sie die Felder leer, um die bestehenden Zugangsdaten zu behalten.
Schritt 3: Verbindung testen
Bei Katalog-Plattformen mit Zugangsdaten wird die Verbindung direkt beim Erstellen geprüft. Sie können den Test jederzeit wiederholen:
- Öffnen Sie Agenten → Integrationen
- Starten Sie den Verbindungstest an der gewünschten Integration — alternativ über den Button Verbindung testen beim Bearbeiten
- Bei Erfolg erscheint Verbindung erfolgreich getestet; der Status der Integration zeigt Verbunden
Schlägt der Test fehl, zeigt die Integration den Status Fehler. Prüfen Sie in dem Fall die hinterlegten Zugangsdaten und tragen Sie sie beim Bearbeiten neu ein.
Eigene API-Anbindungen (Custom API) lassen sich nicht automatisch testen — prüfen Sie diese mit einem Testanruf (Agent testen).
Schritt 4: Integration dem Agenten zuweisen
Eine angelegte Integration ist noch nicht aktiv. Sie müssen sie jedem Agenten zuweisen, der sie nutzen soll:
- Öffnen Sie Ihren Agenten im Dashboard
- Wechseln Sie zum Tab Integrationen
- Unter Verfügbare Integrationen sehen Sie alle angelegten Integrationen — klicken Sie auf eine Integration, um sie zu aktivieren
- Die Integration erscheint nun unter Aktiv für diesen Agent
- Speichern Sie den Agenten
Wichtig: Ohne diese Zuweisung nutzt der Agent die Integration nicht — er kann dann keine oder falsche Daten liefern, obwohl die Integration korrekt angelegt ist. Prüfen Sie bei Datenproblemen immer zuerst den Tab Integrationen am Agenten.
Schritt 5: Aktionen aktivieren und Ausführungszeitpunkt wählen
Jede Integration bringt eine oder mehrere Aktionen mit. Pro Agent steuern Sie, welche davon verfügbar sind:
- Klicken Sie im Tab Integrationen auf das Einstellungssymbol einer aktiven Integration
- Aktivieren oder deaktivieren Sie unter Aktionen die einzelnen Aktionen — deaktivierte Aktionen stehen dem Agenten nicht zur Verfügung
- Wählen Sie pro Aktion den Ausführungszeitpunkt:
| Zeitpunkt | Verhalten |
|---|---|
| Vor dem Anruf | Die Aktion läuft vor Gesprächsbeginn, z. B. um Daten für die Begrüßung zu laden |
| Während des Anrufs | Der Agent ruft die Aktion live im Gespräch auf und kann mit dem Ergebnis weiterarbeiten |
| Nach dem Anruf | Die Aktion läuft nach Gesprächsende, befüllt mit Informationen aus dem Gesprächsverlauf |
- Bei manchen Plattformen können Sie zusätzlich unter Einstellungen überschreiben Standardwerte nur für diesen Agenten anpassen — leere Felder übernehmen den Standardwert der Integration
- Klicken Sie auf Fertig und speichern Sie den Agenten
Machen Sie abschließend einen Testanruf und prüfen Sie, ob der Agent die erwarteten Daten liefert.
Fehlerbehebung
Ich kann keine neue Integration erstellen
Prüfen Sie die beiden Voraussetzungen: Ihre Rolle braucht die Berechtigung zum Erstellen von Integrationen, und das Feature muss in Ihrem Paket freigeschaltet sein. Wenden Sie sich an den Administrator Ihrer Organisation oder an support@dalvon.ai.
Der Agent liefert keine oder falsche Daten aus dem externen System
Die häufigste Ursache: Die Integration ist angelegt, aber dem Agenten nicht zugewiesen. Öffnen Sie den Agenten, wechseln Sie zum Tab Integrationen und prüfen Sie, ob die Integration unter Aktiv für diesen Agent steht. Prüfen Sie außerdem, ob die benötigten Aktionen aktiviert sind.
Der Verbindungstest schlägt fehl
Die hinterlegten Zugangsdaten sind ungültig oder abgelaufen. Bearbeiten Sie die Integration und tragen Sie die Zugangsdaten neu ein — der Test läuft beim Speichern automatisch erneut.
Nächste Schritte
- Eigene Aktionen - API-Aktionen für eigene Systeme definieren
- Agent testen - Mit Testanrufen prüfen, ob die Integration greift
- Fähigkeiten konfigurieren - Weitere Tools und Funktionen des Agenten
- Kalender verbinden - Terminbuchung über eine Kalender-Anbindung