AI Chat Integration

Whitelabel ChatKit Widget für Partner-Integrationen

Widget Testen

Geben Sie eine Client-ID ein, um das Widget mit der entsprechenden Konfiguration zu laden:

Client ID (UUID)

Hinweis: Für eine funktionsfähige Demo benötigen Sie einen gültigen OpenAI API-Key in der .env.local Datei.

Integration

Fügen Sie das folgende Script in Ihre Website ein, um den Chat-Widget zu aktivieren:

<script
  src="https://your-domain.com/widget.js"
  data-client-id="YOUR_CLIENT_UUID"
  data-version="optional"
  data-position="bottom-right"
  data-primary-color="#0066FF"
  data-accent-color="#003399"
  async
></script>

Konfigurationsoptionen

Attribut	Erforderlich	Beschreibung
`data-client-id`	Ja	Die Client-UUID für die Konfiguration
`data-version`	Nein	Optionale Workflow-Version
`data-position`	Nein	Position des Widgets: `bottom-right` (Standard) oder `bottom-left`
`data-primary-color`	Nein	Primärfarbe (Hex-Format, z.B. #0066FF)
`data-accent-color`	Nein	Akzentfarbe (Hex-Format, z.B. #003399)

API Endpoint

Der Session-Endpoint erstellt eine neue ChatKit-Session:

POST/api/chatkit/session

Request Body

{
  "client_id": "uuid",
  "version": "optional",
  "user_id": "optional",
  "config_overrides": {
    "primaryColor": "#FF0000",
    "accentColor": "#CC0000"
  }
}

Response

{
  "client_secret": "...",
  "config": {
    "name": "Partner Name",
    "primaryColor": "#0066FF",
    "accentColor": "#003399",
    "logoUrl": null,
    "position": "bottom-right",
    "welcomeMessage": "Wie kann ich helfen?"
  }
}

Hinweis: Die workflow_id wird serverseitig aus der Client-Konfiguration geladen und ist nicht in der Response enthalten.