Chatbot Settings

Pobieraj i aktualizuj pełną konfigurację swojego AI Agenta za pomocą REST API.

Chatbot Settings

Pobieraj i aktualizuj pełną konfigurację swojego AI Agenta, w tym osobowość, styl rozmowy i system prompt.

Odpowiada sekcjom Identity > Profile i Identity > Conversation Style w Dashboardzie.

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	Nazwa AI Agenta. Dashboard: Identity > Profile > AI Agent Name (maks. 200 znaków)
`short_description` string	System prompt / opis AI Agenta. Dashboard: Identity > Profile > AI Agent Description (maks. 2000 znaków)
`ai_commands` array of strings	Wytyczne dotyczące zachowania AI. Dashboard: Identity > Conversation Style > AI Guidelines (maks. 500 znaków na element, maks. 5000 znaków łącznie dla wszystkich elementów)
`personality` integer (0–13)	Preset osobowości AI. Dashboard: Identity > Conversation Style > Personality. Zobacz tabelę poniżej
`profession` string	Profesja/rola AI. Dashboard: Identity > Conversation Style > Profession (maks. 200 znaków). Zobacz tabelę poniżej
`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	Główna wiadomość powitalna (HTML). Dashboard: Identity > Profile > Greeting messages (maks. 1000 znaków)
`greeting2` string	Dodatkowa wiadomość powitalna (HTML). Dashboard: Identity > Profile > Greeting messages
`header` string	Tekst nagłówka czatu. Dashboard: Identity > Profile > Chat header text (maks. 200 znaków)
`header2` string	Dodatkowy tekst nagłówka. Dashboard: Identity > Profile > Chat header text (maks. 200 znaków)
`language_chosen` string	Kody języków oddzielone przecinkami (np. `"en,es,de"`). Dashboard: Identity > Profile > Languages (maks. 10 znaków łącznie)

Wartości Personality:

Value	Label	Description
0	Classic	Wszechstronna, zrównoważona między profesjonalizmem a przystępnością (domyślna)
1	Humorous	Dowcipny ton z grą słów i żartami dla zabawnych interakcji
2	Formal	Formalny i poważny, zwięzłe rzeczowe informacje dla zastosowań biznesowych
3	Friendly	Swobodne rozmowy z osobistym, przystępnym charakterem
4	Sassy	Pewny siebie i przekorny, z humorem
5	Intelligent	Szczegółowe, dokładne informacje dla pełnego zrozumienia
6	Empathetic	Troskliwe, pełne współczucia interakcje, okazujące zainteresowanie uczuciami
7	Bold	Zdecydowane opinie i rekomendacje wyrażane z pewnością
9	Excited	Żywe i energiczne zaangażowanie
10	Mysterious	Tajemnicze, intrygujące odpowiedzi dla wyjątkowego doświadczenia
11	Inspiring	Promuje pozytywne myślenie i osiąganie celów w stylu coacha
12	Adventurous	Zachęca do wychodzenia ze strefy komfortu i poznawania nowych możliwości
13	Elegant	Wyrafinowane doświadczenie dla wyjątkowych i wykwintnych marek

Wartości Profession:

Value	Dashboard Label	Description
`helpful_assistant`	Helpful Assistant	Wszechstronny, wielozadaniowy. Zalecany dla większości zastosowań
`customer_support_representative`	Support Agent	Empatyczny, dostarcza rozwiązania krok po kroku i pomaga w diagnostyce
`shopping_assistant`	Shopping Assistant	Proaktywnie oferuje rekomendacje produktów z linkami
`field_expert`	Field Expert	Profesjonalny konsultant, zadaje pytania doprecyzowujące, udziela eksperckich wskazówek
`interviewer`	Interviewer	Zadaje pytania zamiast udzielać odpowiedzi. Do ankiet, wywiadów, zbierania opinii

Update Chatbot Settings

Scope: write_all

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

Request Body — Wszystkie pola są opcjonalne. Dołącz tylko te pola, które chcesz zaktualizować.

Parameter	Description
`personality` integer (0–13)	Preset osobowości AI
`profession` string	Profesja/rola AI (maks. 200 znaków)
`creativity_level` integer (0–2)	`0` = Deterministic, `1` = Balanced, `2` = Creative
`greeting` string	Główna wiadomość powitalna (HTML, maks. 1000 znaków)
`greeting2` string	Dodatkowa wiadomość powitalna
`header` string	Tekst nagłówka czatu (maks. 200 znaków)
`header2` string	Dodatkowy tekst nagłówka (maks. 200 znaków)
`language_chosen` string	Kody języków oddzielone przecinkami (maks. 10 znaków łącznie)
`reply_length` integer (0–2)	`0` = Short, `1` = Medium, `2` = Long
`one_word_description` string	Nazwa AI Agenta (maks. 200 znaków)
`short_description` string	System prompt / opis AI Agenta (maks. 2000 znaków)
`ai_commands` array of strings	AI Guidelines (maks. 500 znaków na element)

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 — Zwraca zaktualizowane ustawienia chatbota (ten sam schemat co odpowiedź Get Chatbot Settings).

Chatbot Settings