Chatbot Settings

Recupera y actualiza la configuración completa de tu Agente de IA mediante la API REST.

Chatbot Settings

Recupera y actualiza la configuración completa de tu Agente de IA, incluidas la personalidad, el estilo de conversación y el system prompt.

Corresponde a Identity > Profile e Identity > Conversation Style en el 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	Nombre del Agente de IA. Dashboard: Identity > Profile > AI Agent Name (máx. 200 caracteres)
`short_description` string	System prompt / descripción del Agente de IA. Dashboard: Identity > Profile > AI Agent Description (máx. 2000 caracteres)
`ai_commands` array of strings	Directrices de comportamiento para la IA. Dashboard: Identity > Conversation Style > AI Guidelines (máx. 500 caracteres por elemento, máx. 5000 caracteres en total sumando todos los elementos)
`personality` integer (0–13)	Preset de personalidad de la IA. Dashboard: Identity > Conversation Style > Personality. Consulta la tabla siguiente
`profession` string	Profesión/rol de la IA. Dashboard: Identity > Conversation Style > Profession (máx. 200 caracteres). Consulta la tabla siguiente
`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	Mensaje de saludo principal (HTML). Dashboard: Identity > Profile > Greeting messages (máx. 1000 caracteres)
`greeting2` string	Mensaje de saludo secundario (HTML). Dashboard: Identity > Profile > Greeting messages
`header` string	Texto de la cabecera del chat. Dashboard: Identity > Profile > Chat header text (máx. 200 caracteres)
`header2` string	Texto de cabecera secundario. Dashboard: Identity > Profile > Chat header text (máx. 200 caracteres)
`language_chosen` string	Códigos de idioma separados por comas (p. ej. `"en,es,de"`). Dashboard: Identity > Profile > Languages (máx. 10 caracteres en total)

Valores de personality:

Value	Label	Description
0	Classic	Equilibrado y versátil, entre profesionalidad y cercanía (por defecto)
1	Humorous	Tono ingenioso con juegos de palabras y bromas para interacciones entretenidas
2	Formal	Formal y serio, información concisa y factual para entornos de negocio
3	Friendly	Conversaciones distendidas con un toque personal y cercano
4	Sassy	Seguro y desenfadado, con humor
5	Intelligent	Información detallada y precisa para una comprensión exhaustiva
6	Empathetic	Interacciones cuidadosas y compasivas, mostrando preocupación por los sentimientos
7	Bold	Opiniones y recomendaciones firmes transmitidas con seguridad
9	Excited	Implicación animada y enérgica
10	Mysterious	Respuestas crípticas e intrigantes para una experiencia única
11	Inspiring	Fomenta el pensamiento positivo y la consecución de objetivos, al estilo de un coach
12	Adventurous	Anima a salir de la zona de confort y explorar nuevas oportunidades
13	Elegant	Experiencia sofisticada para marcas únicas y exquisitas

Valores de profession:

Value	Dashboard Label	Description
`helpful_assistant`	Helpful Assistant	Versátil y multipropósito. Recomendado para la mayoría de los casos de uso
`customer_support_representative`	Support Agent	Empático, ofrece soluciones paso a paso y resolución de problemas
`shopping_assistant`	Shopping Assistant	Ofrece recomendaciones de productos de forma proactiva, con enlaces
`field_expert`	Field Expert	Consultor profesional, hace preguntas aclaratorias y ofrece orientación experta
`interviewer`	Interviewer	Hace preguntas en lugar de dar respuestas. Para encuestas, entrevistas y feedback

Update Chatbot Settings

Scope: write_all

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

Request Body — Todos los campos son opcionales. Incluye solo los campos que quieras actualizar.

Parameter	Description
`personality` integer (0–13)	Preset de personalidad de la IA
`profession` string	Profesión/rol de la IA (máx. 200 caracteres)
`creativity_level` integer (0–2)	`0` = Deterministic, `1` = Balanced, `2` = Creative
`greeting` string	Mensaje de bienvenida principal (HTML, máx. 1000 caracteres)
`greeting2` string	Mensaje de bienvenida secundario
`header` string	Texto de la cabecera del chat (máx. 200 caracteres)
`header2` string	Texto de cabecera secundario (máx. 200 caracteres)
`language_chosen` string	Códigos de idioma separados por comas (máx. 10 caracteres en total)
`reply_length` integer (0–2)	`0` = Short, `1` = Medium, `2` = Long
`one_word_description` string	Nombre del Agente de IA (máx. 200 caracteres)
`short_description` string	System prompt / descripción del Agente de IA (máx. 2000 caracteres)
`ai_commands` array of strings	AI Guidelines (máx. 500 caracteres por elemento)

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 — Devuelve la configuración de chatbot actualizada (mismo esquema que la respuesta de Get Chatbot Settings).

Chatbot Settings