Chatbot Settings

Hämta och uppdatera din AI Agents fullständiga konfiguration via REST API:et.

Chatbot Settings

Hämta och uppdatera din AI Agents fullständiga konfiguration, inklusive personlighet, konversationsstil och systemprompt.

Motsvarar Identity > Profile och Identity > Conversation Style i Dashboard.

Get Chatbot Settings

Scope: read_all

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

Shell
Python

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

import requests

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

Response 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	AI Agent-namn. Dashboard: Identity > Profile > AI Agent Name (max 200 tecken)
`short_description` string	Systemprompt / AI Agent-beskrivning. Dashboard: Identity > Profile > AI Agent Description (max 2000 tecken)
`ai_commands` array of strings	Beteenderiktlinjer för AI:n. Dashboard: Identity > Conversation Style > AI Guidelines (max 500 tecken per objekt, max 5000 tecken totalt över alla objekt)
`personality` integer (0–13)	Förinställd AI-personlighet. Dashboard: Identity > Conversation Style > Personality. Se tabellen nedan
`profession` string	AI-profession/roll. Dashboard: Identity > Conversation Style > Profession (max 200 tecken). Se tabellen nedan
`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ärt hälsningsmeddelande (HTML). Dashboard: Identity > Profile > Greeting messages (max 1000 tecken)
`greeting2` string	Sekundärt hälsningsmeddelande (HTML). Dashboard: Identity > Profile > Greeting messages
`header` string	Text i chattens header. Dashboard: Identity > Profile > Chat header text (max 200 tecken)
`header2` string	Sekundär headertext. Dashboard: Identity > Profile > Chat header text (max 200 tecken)
`language_chosen` string	Kommaseparerade språkkoder (t.ex. `"en,es,de"`). Dashboard: Identity > Profile > Languages (max 10 tecken totalt)

Personality-värden:

Value	Label	Description
0	Classic	Allsidig, balanserad mellan professionalism och tillgänglighet (standard)
1	Humorous	Spirituell ton med ordvitsar och skämt för underhållande interaktioner
2	Formal	Formell och seriös, koncis faktainformation för affärssammanhang
3	Friendly	Avslappnade samtal med en personlig och tillmötesgående touch
4	Sassy	Självsäker och lekfull med humor
5	Intelligent	Detaljerad, korrekt information för en heltäckande förståelse
6	Empathetic	Omtänksamma, medkännande interaktioner som visar omsorg om känslor
7	Bold	Starka åsikter och rekommendationer som levereras med självförtroende
9	Excited	Livligt och energiskt engagemang
10	Mysterious	Kryptiska, fängslande svar för en unik upplevelse
11	Inspiring	Främjar positivt tänkande och måluppfyllelse på ett coach-likt sätt
12	Adventurous	Uppmuntrar till att lämna bekvämlighetszonen och utforska nya möjligheter
13	Elegant	Sofistikerad upplevelse för unika och utsökta varumärken

Profession-värden:

Value	Dashboard Label	Description
`helpful_assistant`	Helpful Assistant	Mångsidig, för flera syften. Rekommenderas för de flesta användningsfall
`customer_support_representative`	Support Agent	Empatisk, ger steg-för-steg-lösningar och felsökning
`shopping_assistant`	Shopping Assistant	Erbjuder proaktivt produktrekommendationer med länkar
`field_expert`	Field Expert	Professionell konsult, ställer förtydligande frågor, ger expertvägledning
`interviewer`	Interviewer	Ställer frågor i stället för att ge svar. För enkäter, intervjuer, feedback

Update Chatbot Settings

Scope: write_all

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

Request Body — Alla fält är valfria. Inkludera bara de fält du vill uppdatera.

Parameter	Description
`personality` integer (0–13)	Förinställd AI-personlighet
`profession` string	AI-profession/roll (max 200 tecken)
`creativity_level` integer (0–2)	`0` = Deterministic, `1` = Balanced, `2` = Creative
`greeting` string	Primärt välkomstmeddelande (HTML, max 1000 tecken)
`greeting2` string	Sekundärt välkomstmeddelande
`header` string	Text i chattens header (max 200 tecken)
`header2` string	Sekundär headertext (max 200 tecken)
`language_chosen` string	Kommaseparerade språkkoder (max 10 tecken totalt)
`reply_length` integer (0–2)	`0` = Short, `1` = Medium, `2` = Long
`one_word_description` string	AI Agent-namn (max 200 tecken)
`short_description` string	AI Agent-systemprompt / beskrivning (max 2000 tecken)
`ai_commands` array of strings	AI Guidelines (max 500 tecken per objekt)

Shell
Python

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
}'

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()

Response 200 OK — Returnerar de uppdaterade chatbot-inställningarna (samma schema som svaret för Get Chatbot Settings).

Chatbot Settings