# Integration & Anbindung externer Dienste

Die Kauz.ai-Plattform erlaubt die umfassende Integration unterschiedlichster externer Dienste. Untenstehend finden Sie eine Auswahl.

Sie haben eine Frage zu einer Integration, die unten nicht aufgelistet ist? Sprechen Sie uns an! Unser Kauz-Support hilft Ihnen gerne weiter.

# Datenquellen

Für die Wissensbasis des KI-Assistenten können Daten aus unterschiedlichen Systemen angebunden werden, darunter Sharepoint. Weitere Informationen können Sie dem Kapitel Datenimport entnehmen.

Für Webseiten können außerdem Daten aus dem CMS-System bezogen werden, z. B. imperia CMS.

# Anbindung über API-Tools

Ein Aufruf von externen Diensten zur Laufzeit erfolgt i. d. R. über Tool-Calls durch das LLM. Diese können über das Tool-Management frei konfiguriert werden.

Hierbei können Dienste entweder direkt angesprochen oder über Integrationsplattformen wie n8n, zapier oder make integriert werden. Legen Sie hierfür in dem dort designten Workflow einen Webhook als Ausgangspunkt an und hinterlegen diesen als Request-Url in Ihrem Custom-API-Tool.

Auch ein eigener aiWorkflow lässt sich aus dem Chatbot heraus anstoßen und mit Werten aus dem Gespräch befüllen. Stellen Sie ihn dafür über die API bereit: Damit erhalten Sie die Antwort des Workflows direkt zurück, ein Webhook würde ihn dagegen nur einseitig auslösen.

Bauen Sie den Workflow mit dem Trigger aiWorkplace (wenn er zusätzlich von Kolleg*innen im aiWorkplace genutzt werden soll) oder Start (wenn er ausschließlich über die API laufen soll).
Stellen Sie den Workflow im aiWorkflowBuilder über Deploy bereit und wechseln Sie im Dialog Workflow Deployment auf den Reiter API (siehe Workflow bereitstellen ). Dort finden Sie die Endpunkt-URL für die Ausführung des Workflows.
Erzeugen Sie unter Sim Keys in den Workspace-Einstellungen einen API-Key.
Legen Sie im aiStudio ein Custom-API-Tool mit der HTTP-Methode POST an. Tragen Sie die Endpunkt-URL aus Schritt 2 als Request-URL ein und wählen Sie als Authentifizierung API Key mit dem Header-Namen X-API-Key und dem Sim Key aus Schritt 3 als Wert.
Definieren Sie im Body ein JSON-Objekt mit einem input-Feld, das die Werte für den Workflow enthält, und ersetzen Sie diese durch Platzhalter, die das Sprachmodell aus dem Gespräch befüllt, zum Beispiel:
```
{
  "input": {
    "kundennummer": "$kundennummer",
    "anliegen": "$anliegen"
  }
}
```
Die Antwort des Workflows erhält der Agent direkt als Ergebnis des Tool-Calls zurück und kann sie in seiner Antwort verwenden.

Bitte beachten Sie: Ein Workflow kann deutlich länger laufen als ein einzelner Modell-Aufruf. Führen Sie länger laufende Prozesse deshalb nicht synchron im Chat aus, Nutzer*innen warten dort meist nicht so lange auf eine Antwort. Für solche Prozesse eignet sich eher die Nachbearbeitung, zum Beispiel indem der Workflow das Ergebnis im Nachgang per E-Mail oder Ticket zustellt, statt den Chatbot direkt darauf warten zu lassen.

Hier einige Beispiele von Systemen, die typischerweise angebunden werden:

Diverse Automatisierungen und Systeme über Integrationsplattformen wie n8n, zapier oder make
E-Mail-Versand an Outlook, Googlemail, uvm. (s. dazu E-Mail-Tool )
Terminvereinbarung über Kalender-Systeme wie Calendly, Microsoft 365 Calendar, Google Calendar, uvm.
Ticket-Erstellung und -status aus Ticketing-Systemen wie Jira, Zendesk, Freshdesk, uvm.
Lead-Erstellung über CRM-Systeme wie Hubspot, Brevo, uvm.
Kunden- und Bestellstatus in ERP-Systemen wie Xentral und Shop-Systemen wie Shopify
Custom-Systeme, z. B. Zählerstandsmitteilungen, Tarifrechner
Zugriff auf Dokumentenmanagementsysteme wie GoogleDrive, OneDrive, uvm.
HR-Prozesse in HRIS-Systemen wie Personio, Workday, SAP
Übersetzungssoftware wie DeepL, Google Translate
Bezahlsysteme wie Stripe
Umfrage-Software wie SurveyMonkey
Wetterauskünfte über OpenWeatherMap
Datenvalidierung, z.B. Postleitzahlprüfung
News-APIs, z.B. Jobbörse, KI-News, Börseninfo, Sportinfo, uvm.

Beschränkungen sind durch den API-Scope der einzelnen Systeme definiert.

# Livechat-Anbindung

Kauz.ai bietet zwar keine native Livechat-Integration, ermöglicht jedoch die Einbindung verschiedener Livechat-Anbieter.

Typische Einstiegspunkte für den Livechat sind:

Wenn der KI-Assistent wiederholt keine Antwort auf die Nutzerfrage findet
Wenn Nutzer*innen um Kontakt zu einem menschlichen Ansprechpartner bitten
Bei von Ihnen definierten Themen, die den Beratungsumfang des Chatbots überschreiten, etwa bei sensiblen oder komplexeren Beratungssituationen

Unser Service-Team unterstützt Sie gerne bei der Auswahl passender Livechat-Lösungen und der Formulierung Ihrer individuellen Use Cases.

Die meisten Livechat-Anbieter stellen eine API bereit, mit der zunächst geprüft wird, ob ein Livechat-Mitarbeiter verfügbar ist, bevor der Livechat dem Kunden angeboten wird. Ebenso sind Routing-Optionen an unterschiedliche Teams möglich.

Der Chatverlauf wird dabei nahtlos an den Livechat übertragen, um eine reibungslose Übergabe und optimale Betreuung sicherzustellen.

Es können diverse weitere Livechat-Anbieter eingebunden werden, zum Beispiel Userlike, Talkevent, Purpleview oder Rocketchat. Sprechen Sie uns gerne an! Die Integration kann entweder über die Nutzung der API des jeweiligen Anbieters erfolgen oder über die Ausgabe der Livechat-URL.

# Userlike

Um den Livechat von Userlike einzurichten, schicken Sie uns bitte Ihren Widget-Key an service@kauz.ai. Wir verknüpfen den Chatbot dann mit Ihrem Userlike-Account.

Nach der Einrichtung können Sie im Prompt Ihres Agenten steuern, wann der Livechat angesteuert werden soll:

Nutze das folgende Mark-Up, um den Livechat-Button zu generieren: <button action="userlike"/>

# Zendeskintegration über AdaptiveCards

Wie unter Anbindung über API-Tools beschrieben, kann ein Ticketing-System über Tool-Calls aus dem LLM integriert werden. Für den Anbieter Zendesk unterstützt Kauz zusätzlich die Möglichkeit, Tickets über eine AdaptiveCard aufzugeben.

Dies erlaubt die Abfrage relevanter Daten oder Informationen per Formular direkt im Chatfenster. Diese Daten werden durch das Absenden der AdaptiveCard in ein Ticket überführt, das in Ihrer Zendesk-Subdomain erstellt wird. Bei Interesse unterstützt Sie unser Service-Team gerne bei der Einrichtung der Zendeskintegration.