Haal de volledige configuratie van je AI-agent op en werk deze bij via de REST API.
Chatbotinstellingen
Section titled “Chatbotinstellingen”Haal de volledige configuratie van je AI-agent op en werk deze bij, inclusief persoonlijkheid, gespreksstijl en systeemprompt.
Gedragsinstellingen staan in het dashboard onder Identiteit > AI-persona. Tekst voor bezoekers staat onder Kanalen > Je website > Tekstinhoud. De onderstaande veldentabel geeft de exacte locatie van elke instelling.
Chatbotinstellingen ophalen
Section titled “Chatbotinstellingen ophalen”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()Antwoord 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"]}| Veld | Beschrijving |
|---|---|
one_word_description string | Naam van de AI-agent. Dashboard: Identiteit > AI-persona > Naam. De API accepteert maximaal 200 tekens; het veld in de app beperkt dit tot 40. |
short_description string | De Hoofdprompt (systeemprompt). Dashboard: Identiteit > AI-persona > Hoofdprompt. De API accepteert bij elk abonnement maximaal 25.000 tekens; de editor in de app beperkt dit tot de limiet van je abonnement, vanaf 15.000. |
ai_commands array van strings | Gedragsrichtlijnen voor de AI, één per array-item. Dashboard: Identiteit > AI-persona > Richtlijnen. Maximaal 250 items, 5.000 tekens per item en 10.000 tekens over alle items samen. |
personality integer (0–13) | Voorinstelling voor de AI-persoonlijkheid. Dashboard: Identiteit > AI-persona > Persoonlijkheid. Zie de onderstaande tabel |
profession string | Beroep of rol van de AI. Dashboard: Identiteit > AI-persona > Rol (maximaal 200 tekens). Zie de onderstaande tabel |
creativity_level integer (0–2) | Dashboard: Identiteit > AI-persona > Creativiteit. 0 = Laag, 1 = Normaal, 2 = Hoog |
reply_length integer (0–2) | Dashboard: Identiteit > AI-persona > Antwoordlengte. 0 = Kort, 1 = Normaal, 2 = Langer |
greeting string | Primair begroetingsbericht (HTML). Dashboard: Kanalen > Je website > Tekstinhoud > Welkomstbericht (maximaal 1.000 tekens). Dit is hetzelfde veld als welcome_message in Widgetconfiguratie. |
greeting2 string | Secundair begroetingsbericht (HTML). Beschikbaar via de API; hiervoor is geen editorveld in het dashboard. |
header string | Koptekst van de chat. Dashboard: Kanalen > Je website > Tekstinhoud > Koptekst (maximaal 200 tekens) |
header2 string | Secundaire koptekst (maximaal 200 tekens). Beschikbaar via de API als header2 of als subtitle in Widgetconfiguratie; hiervoor is geen editorveld in het dashboard. |
language_chosen string | Door komma’s gescheiden taalcodes (bijvoorbeeld "en,es,de"). Dashboard: Identiteit > AI-persona > Talen (maximaal 200 tekens totaal; codes boven de limiet van 30 talen worden weggelaten) |
Waarden voor persoonlijkheid:
| Waarde | Label | Beschrijving |
|---|---|---|
| 0 | Klassiek | Veelzijdig, met een balans tussen professionaliteit en toegankelijkheid (standaard) |
| 1 | Humoristisch | Geestige toon met woordspelingen en grappen voor vermakelijke interacties |
| 2 | Formeel | Formeel en serieus, met beknopte feitelijke informatie voor zakelijke situaties |
| 3 | Vriendelijk | Informele gesprekken met een persoonlijke, toegankelijke benadering |
| 4 | Brutaal | Zelfverzekerd en speels, met humor |
| 5 | Intelligent | Gedetailleerde, nauwkeurige informatie voor diepgaand begrip |
| 6 | Empathisch | Zorgzame, meelevende interacties met aandacht voor gevoelens |
| 7 | Zelfverzekerd | Duidelijke meningen en aanbevelingen, met overtuiging gebracht |
| 9 | Enthousiast | Levendige en energieke interactie |
| 10 | Mysterieus | Raadselachtige, intrigerende antwoorden voor een unieke ervaring |
| 11 | Inspirerend | Stimuleert positief denken en doelen bereiken, als een coach |
| 12 | Avontuurlijk | Moedigt aan om de comfortzone te verlaten en nieuwe kansen te verkennen |
| 13 | Elegant | Verfijnde ervaring voor unieke en exclusieve merken |
Waarden voor rol:
| Waarde | Label in dashboard | Beschrijving |
|---|---|---|
helpful_assistant | Behulpzame assistent | Veelzijdig en breed inzetbaar. Aanbevolen voor de meeste toepassingen |
customer_support_representative | Supportmedewerker | Empathisch, biedt stapsgewijze oplossingen en probleemoplossing |
shopping_assistant | Winkelassistent | Geeft proactief productaanbevelingen met links |
field_expert | Vakexpert | Professionele adviseur, stelt verduidelijkende vragen en geeft deskundige begeleiding |
interviewer | Interviewer | Stelt vragen in plaats van antwoorden te geven. Voor enquêtes, interviews en feedback |
De velden one_word_description, short_description en ai_commands zijn ook beschikbaar via het endpoint Kennisbank-instellingen. Deze velden worden gedeeld: bijwerken via een van beide endpoints wijzigt dezelfde onderliggende gegevens.
Chatbotinstellingen bijwerken
Section titled “Chatbotinstellingen bijwerken”PATCH https://app.quickchat.ai/v1/api/chatbot_settings
Requestbody: alle velden zijn optioneel. Neem alleen de velden op die je wilt bijwerken.
| Parameter | Beschrijving |
|---|---|
personality integer (0–13) | Voorinstelling voor de AI-persoonlijkheid |
profession string | Beroep of rol van de AI (maximaal 200 tekens) |
creativity_level integer (0–2) | 0 = Laag, 1 = Normaal, 2 = Hoog |
greeting string | Primair welkomstbericht (HTML, maximaal 1.000 tekens) |
greeting2 string | Secundair welkomstbericht |
header string | Koptekst van de chat (maximaal 200 tekens) |
header2 string | Secundaire koptekst (maximaal 200 tekens) |
language_chosen string | Door komma’s gescheiden taalcodes (maximaal 200 tekens totaal; codes boven de limiet van 30 talen worden weggelaten) |
reply_length integer (0–2) | 0 = Kort, 1 = Normaal, 2 = Langer |
one_word_description string | Naam van de AI-agent. API maximaal 200 tekens; het veld in de app beperkt dit tot 40. |
short_description string | Hoofdprompt van de AI (systeemprompt). De API accepteert bij elk abonnement maximaal 25.000 tekens; de editor in de app beperkt dit tot de limiet van je abonnement, vanaf 15.000. Een te lange waarde retourneert 422. |
ai_commands array van strings | AI-richtlijnen, één per array-item. Maximaal 250 items, 5.000 tekens per item en 10.000 tekens over alle items samen. Een te lange waarde retourneert 422. |
Elk array-item is één richtlijn en wordt exact opgeslagen zoals je die verstuurt. Leestekens, inclusief puntkomma’s, blijven behouden. Dit endpoint verwijderde vroeger ; uit je tekst vóór het opslaan. Als je puntkomma’s daarom verwijderde of verving, hoeft dat niet meer.
Laat ai_commands weg of stuur null om de richtlijnen ongewijzigd te laten. Stuur [] om ze te wissen.
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()Antwoord 200 OK: retourneert de bijgewerkte chatbotinstellingen (hetzelfde schema als het antwoord van Chatbotinstellingen ophalen).