Chatbot Settings
Section titled “Chatbot Settings”Hämta och uppdatera din AI Agents fullständiga konfiguration, inklusive personlighet, konversationsstil och systemprompt.
Beteendeinställningarna finns under Identitet > AI-persona i panelen. Text som besökarna ser finns under Kanaler > Din webbplats > Textinnehåll. Fälttabellen nedan visar den exakta platsen för varje inställning.
Get Chatbot Settings
Section titled “Get Chatbot Settings”GET https://app.quickchat.ai/v1/api/chatbot_settings
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. Panelen: Identitet > AI-persona > Namn. API:et accepterar upp till 200 tecken; fältet i appen begränsar namnet till 40. |
short_description string | Huvudprompt (systemprompt). Panelen: Identitet > AI-persona > Huvudprompt. API:et accepterar upp till 25 000 tecken på alla planer; redigeraren i appen begränsar värdet till din plans tak, som börjar vid 15 000. |
ai_commands array of strings | Beteenderiktlinjer för AI:n, en riktlinje per arrayobjekt. Panelen: Identitet > AI-persona > Riktlinjer. Upp till 250 objekt, 5 000 tecken per objekt och 10 000 tecken totalt över alla objekt. |
personality integer (0–13) | Förinställd AI-personlighet. Panelen: Identitet > AI-persona > Personlighet. Se tabellen nedan |
profession string | AI-yrke/roll. Panelen: Identitet > AI-persona > Yrke (max 200 tecken). Se tabellen nedan |
creativity_level integer (0–2) | Panelen: Identitet > AI-persona > Kreativitet. 0 = Låg, 1 = Normal, 2 = Hög |
reply_length integer (0–2) | Panelen: Identitet > AI-persona > Svarslängd. 0 = Kort, 1 = Normal, 2 = Längre |
greeting string | Primärt hälsningsmeddelande (HTML). Panelen: Kanaler > Din webbplats > Textinnehåll > Välkomstmeddelande (max 1000 tecken). Det här är samma fält som welcome_message i Widget Configuration. |
greeting2 string | Sekundärt hälsningsmeddelande (HTML). Tillgängligt via API:et; det finns inget redigeringsfält för det i panelen. |
header string | Chattens rubriktext. Panelen: Kanaler > Din webbplats > Textinnehåll > Rubriktext (max 200 tecken) |
header2 string | Sekundär rubriktext (max 200 tecken). Tillgängligt via API:et som header2 eller som subtitle i Widget Configuration; det finns inget redigeringsfält för det i panelen. |
language_chosen string | Kommaseparerade språkkoder (t.ex. "en,es,de"). Panelen: Identitet > AI-persona > Språk (max 200 tecken totalt; koder utöver gränsen på 30 språk tas bort) |
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 |
Fälten one_word_description, short_description och ai_commands är också tillgängliga via endpointen Knowledge Base Settings. Dessa fält delas — att uppdatera via någon av endpointsen ändrar samma underliggande data.
Update Chatbot Settings
Section titled “Update Chatbot Settings”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 = Låg, 1 = Normal, 2 = Hög |
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 200 tecken totalt; koder utöver gränsen på 30 språk tas bort) |
reply_length integer (0–2) | 0 = Kort, 1 = Normal, 2 = Längre |
one_word_description string | AI Agent-namn. API:et accepterar högst 200 tecken; fältet i appen begränsar namnet till 40. |
short_description string | AI Agent-huvudprompt / systemprompt. API:et accepterar upp till 25 000 tecken på alla planer; in-app-editorn begränsar värdet till din plans tak, som börjar vid 15 000. Ett för långt värde returnerar 422. |
ai_commands array of strings | AI Guidelines, en riktlinje per arrayobjekt. Upp till 250 objekt, 5 000 tecken per objekt och 10 000 tecken totalt över alla objekt. Ett för långt värde returnerar 422. |
Varje arrayobjekt är en riktlinje som sparas exakt så som du skickar den. Skiljetecken bevaras, inklusive semikolon. Tidigare tog den här endpointen bort ; ur texten innan den sparades. Om du utelämnade eller ersatte semikolon på grund av det behöver du inte längre göra det.
Utelämna ai_commands, eller skicka null, för att lämna riktlinjerna oförändrade. Skicka [] för att rensa dem.
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).