Chatbot Settings

Chatbot Settings

Rufen Sie die vollständige Konfiguration Ihres KI-Agenten ab und aktualisieren Sie sie, einschließlich Persönlichkeit, Konversationsstil und System-Prompt.

Entspricht Identity > Profile und Identity > Conversation Style im Dashboard.

Chatbot Settings abrufen

Scope: read_all

GET https://app.quickchat.ai/v1/api/chatbot_settings

Shell

curl https://app.quickchat.ai/v1/api/chatbot_settings \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

response = requests.get(
    url="https://app.quickchat.ai/v1/api/chatbot_settings",
    headers={"Authorization": "Bearer <API_TOKEN>"},
)
data = response.json()

Antwort 200 OK

{
  "personality": 0,
  "profession": "helpful_assistant",
  "creativity_level": 1,
  "greeting": "<p>Hello! How can I help you today?</p>",
  "greeting2": "",
  "header": "Support Assistant",
  "header2": "",
  "language_chosen": "en",
  "reply_length": 1,
  "one_word_description": "Support Agent",
  "short_description": "A helpful customer support assistant.",
  "ai_commands": ["Be polite", "Stay on topic"]
}

Field	Description
one_word_description string	Name des KI-Agenten. Dashboard: Identity > Profile > AI Agent Name (max. 200 Zeichen)
short_description string	System-Prompt / Beschreibung des KI-Agenten. Dashboard: Identity > Profile > AI Agent Description (max. 2000 Zeichen)
ai_commands array of strings	Verhaltensrichtlinien für die KI. Dashboard: Identity > Conversation Style > AI Guidelines (max. 500 Zeichen pro Eintrag, max. 5000 Zeichen insgesamt über alle Einträge)
personality integer (0–13)	Persönlichkeits-Preset der KI. Dashboard: Identity > Conversation Style > Personality. Siehe Tabelle unten
profession string	Beruf/Rolle der KI. Dashboard: Identity > Conversation Style > Profession (max. 200 Zeichen). Siehe Tabelle unten
creativity_level integer (0–2)	Dashboard: Identity > Conversation Style > Creativity. 0 = Deterministic, 1 = Balanced, 2 = Creative
reply_length integer (0–2)	Dashboard: Identity > Conversation Style > Reply Length. 0 = Short, 1 = Medium, 2 = Long
greeting string	Primäre Begrüßungsnachricht (HTML). Dashboard: Identity > Profile > Greeting messages (max. 1000 Zeichen)
greeting2 string	Sekundäre Begrüßungsnachricht (HTML). Dashboard: Identity > Profile > Greeting messages
header string	Text der Chat-Kopfzeile. Dashboard: Identity > Profile > Chat header text (max. 200 Zeichen)
header2 string	Sekundärer Kopfzeilentext. Dashboard: Identity > Profile > Chat header text (max. 200 Zeichen)
language_chosen string	Kommagetrennte Sprachcodes (z. B. "en,es,de"). Dashboard: Identity > Profile > Languages (max. 10 Zeichen insgesamt)

Personality-Werte:

Value	Label	Description
0	Classic	Ausgewogen, balanciert zwischen Professionalität und Zugänglichkeit (Standard)
1	Humorous	Witziger Ton mit Wortspielen und Scherzen für unterhaltsame Interaktionen
2	Formal	Formell und seriös, knappe, sachliche Informationen für geschäftliche Umgebungen
3	Friendly	Lockere Gespräche mit persönlicher, zugänglicher Note
4	Sassy	Selbstbewusst und verspielt mit Humor
5	Intelligent	Detaillierte, präzise Informationen für ein umfassendes Verständnis
6	Empathetic	Fürsorgliche, mitfühlende Interaktionen, die Rücksicht auf Gefühle nehmen
7	Bold	Klare Meinungen und Empfehlungen, selbstbewusst vorgetragen
9	Excited	Lebhaftes und energiegeladenes Engagement
10	Mysterious	Kryptische, faszinierende Antworten für ein einzigartiges Erlebnis
11	Inspiring	Fördert positives Denken und das Erreichen von Zielen im Stil eines Coachs
12	Adventurous	Ermutigt dazu, die Komfortzone zu verlassen und neue Möglichkeiten zu erkunden
13	Elegant	Anspruchsvolles Erlebnis für einzigartige und erlesene Marken

Profession-Werte:

Value	Dashboard Label	Description
helpful_assistant	Helpful Assistant	Vielseitig, für viele Zwecke. Für die meisten Anwendungsfälle empfohlen
customer_support_representative	Support Agent	Empathisch, bietet Schritt-für-Schritt-Lösungen und Fehlerbehebung
shopping_assistant	Shopping Assistant	Bietet proaktiv Produktempfehlungen mit Links
field_expert	Field Expert	Professioneller Berater, stellt klärende Fragen, bietet fachkundige Anleitung
interviewer	Interviewer	Stellt Fragen, statt Antworten zu geben. Für Umfragen, Interviews, Feedback

Hinweis

Die Felder one_word_description, short_description und ai_commands sind auch über den Endpunkt Knowledge Base Settings verfügbar. Diese Felder werden gemeinsam genutzt — eine Aktualisierung über einen der beiden Endpunkte ändert dieselben zugrunde liegenden Daten.

Chatbot Settings aktualisieren

Scope: write_all

PATCH https://app.quickchat.ai/v1/api/chatbot_settings

Request-Body — Alle Felder sind optional. Geben Sie nur die Felder an, die Sie aktualisieren möchten.

Parameter	Description
personality integer (0–13)	Persönlichkeits-Preset der KI
profession string	Beruf/Rolle der KI (max. 200 Zeichen)
creativity_level integer (0–2)	0 = Deterministic, 1 = Balanced, 2 = Creative
greeting string	Primäre Willkommensnachricht (HTML, max. 1000 Zeichen)
greeting2 string	Sekundäre Willkommensnachricht
header string	Text der Chat-Kopfzeile (max. 200 Zeichen)
header2 string	Sekundärer Kopfzeilentext (max. 200 Zeichen)
language_chosen string	Kommagetrennte Sprachcodes (max. 10 Zeichen insgesamt)
reply_length integer (0–2)	0 = Short, 1 = Medium, 2 = Long
one_word_description string	Name des KI-Agenten (max. 200 Zeichen)
short_description string	System-Prompt / Beschreibung des KI-Agenten (max. 2000 Zeichen)
ai_commands array of strings	AI Guidelines (max. 500 Zeichen pro Eintrag)

Shell

curl -X PATCH https://app.quickchat.ai/v1/api/chatbot_settings \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "greeting": "<p>Welcome! Ask me anything.</p>",
  "creativity_level": 2
}'

Python

import requests

response = requests.patch(
    url="https://app.quickchat.ai/v1/api/chatbot_settings",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={
        "greeting": "<p>Welcome! Ask me anything.</p>",
        "creativity_level": 2,
    },
)
data = response.json()

Antwort 200 OK — Gibt die aktualisierten Chatbot Settings zurück (gleiches Schema wie die Antwort von Chatbot Settings abrufen).

---