Recupera y actualiza la configuración completa de tu Agente de IA mediante la API REST.
Chatbot Settings
Sección titulada «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.
Los ajustes de comportamiento están en Identidad > Persona de IA en el panel. Los textos que ven los visitantes están en Canales > Tu sitio web > Contenido de texto. La tabla siguiente indica la ubicación exacta de cada ajuste.
Get Chatbot Settings
Sección titulada «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 | Nombre del Agente de IA. Panel: Identidad > Persona de IA > Nombre. La API acepta hasta 200 caracteres; el campo de la aplicación lo limita a 40. |
short_description string | El Prompt principal (system prompt). Panel: Identidad > Persona de IA > Prompt principal. La API acepta hasta 25 000 caracteres en todos los planes; el editor de la aplicación lo limita al máximo de tu plan, que empieza en 15 000. |
ai_commands array of strings | Directrices de comportamiento para la IA, una directriz por elemento del array. Panel: Identidad > Persona de IA > Directrices. Hasta 250 elementos, 5 000 caracteres por elemento y 10 000 caracteres en total sumando todos los elementos. |
personality integer (0–13) | Preset de personalidad de la IA. Panel: Identidad > Persona de IA > Personalidad. Consulta la tabla siguiente |
profession string | Profesión/rol de la IA. Panel: Identidad > Persona de IA > Profesión (máx. 200 caracteres). Consulta la tabla siguiente |
creativity_level integer (0–2) | Panel: Identidad > Persona de IA > Creatividad. 0 = Bajo, 1 = Normal, 2 = Alto |
reply_length integer (0–2) | Panel: Identidad > Persona de IA > Longitud de Respuesta. 0 = Corto, 1 = Normal, 2 = Más largo |
greeting string | Mensaje de saludo principal (HTML). Panel: Canales > Tu sitio web > Contenido de texto > Mensaje de bienvenida (máx. 1000 caracteres). Es el mismo campo que welcome_message en Widget Configuration. |
greeting2 string | Mensaje de saludo secundario (HTML). Disponible a través de la API; no tiene un campo de edición en el panel. |
header string | Texto del encabezado del chat. Panel: Canales > Tu sitio web > Contenido de texto > Texto del encabezado (máx. 200 caracteres) |
header2 string | Texto del encabezado secundario (máx. 200 caracteres). Disponible a través de la API como header2, o subtitle en Widget Configuration; no tiene un campo de edición en el panel. |
language_chosen string | Códigos de idioma separados por comas (p. ej. "en,es,de"). Panel: Identidad > Persona de IA > Idiomas (máx. 200 caracteres en total; se descartan los códigos que excedan el límite de 30 idiomas) |
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 |
Los campos one_word_description, short_description y ai_commands también están disponibles a través del endpoint de Knowledge Base Settings. Estos campos son compartidos: actualizar mediante cualquiera de los dos endpoints modifica los mismos datos subyacentes.
Update Chatbot Settings
Sección titulada «Update Chatbot Settings»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 = Bajo, 1 = Normal, 2 = Alto |
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. 200 caracteres en total; se descartan los códigos que excedan el límite de 30 idiomas) |
reply_length integer (0–2) | 0 = Corto, 1 = Normal, 2 = Más largo |
one_word_description string | Nombre del Agente de IA. Máximo de 200 caracteres en la API; el campo de la aplicación lo limita a 40. |
short_description string | System prompt / Prompt principal del Agente de IA. La API acepta hasta 25 000 caracteres en todos los planes; el editor in-app lo limita al máximo de tu plan, que empieza en 15 000. Un valor demasiado largo devuelve 422. |
ai_commands array of strings | AI Guidelines, una directriz por elemento del array. Hasta 250 elementos, 5 000 caracteres por elemento y 10 000 caracteres en total sumando todos los elementos. Un valor demasiado largo devuelve 422. |
Cada elemento del array es una directriz y se guarda exactamente como la envías. La puntuación se conserva, incluidos los puntos y coma. Antes, este endpoint eliminaba los ; de tu texto antes de guardarlo. Si los quitabas o los sustituías por ese motivo, ya no hace falta.
Omite ai_commands, o envía null, para dejar las directrices sin cambios. Envía [] para borrarlas.
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).