> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuración avanzada del agente

> Seguridad, variables, respuestas predefinidas, límites de créditos y notificaciones por agente.

# Configuración avanzada del agente

Además de las instrucciones del sistema y el modelo de IA, cada agente tiene una pestaña **Settings** con sub-secciones para seguridad, variables, respuestas predefinidas, límites de créditos y notificaciones propias del agente.

Para llegar ahí: `Chatbots → [tu agente] → Settings`.

## Seguridad (Security)

Controla quién puede acceder al widget web de este agente.

<CardGroup cols={2}>
  <Card title="Whitelist de dominios" icon="globe">
    Lista de dominios donde el widget puede cargarse. Cualquier sitio fuera de la lista no podrá mostrarlo. Formato: `ejemplo.com`, sin protocolo ni espacios.
  </Card>

  <Card title="Geo-blocking" icon="map-pin">
    Bloquea visitantes de países específicos — el widget queda oculto para esos países.
  </Card>

  <Card title="Usuarios bloqueados" icon="user-slash">
    Bloqueá visitantes puntuales por su `visitor ID` para que no puedan usar el widget.
  </Card>

  <Card title="Rate limiting" icon="gauge">
    Límite de mensajes que un mismo usuario puede enviar en una ventana de tiempo (minuto, hora o día), con un mensaje de error personalizable cuando se supera.
  </Card>
</CardGroup>

<Tip>
  Estas protecciones aplican al canal web (widget). Los canales de WhatsApp e Instagram no se ven afectados por whitelist de dominios ni geo-blocking.
</Tip>

## Variables

Las variables te permiten inyectar datos dinámicos en el system prompt del agente.

### Variables custom

Creá tus propias variables desde `Settings → Variables → Nueva variable`:

| Campo             | Descripción                                                     |
| ----------------- | --------------------------------------------------------------- |
| **Name**          | El identificador de la variable (se usa en el prompt).          |
| **Type**          | `text`, `number` o `boolean`.                                   |
| **Description**   | Para qué sirve — te ayuda a recordarlo al escribir el prompt.   |
| **Default value** | Valor que toma si no se especifica otro en tiempo de ejecución. |

### Variables de sistema

Además de las que vos creás, ChatNorris expone variables de sistema de solo lectura (identificadas con el badge **System** en la tabla) que se completan automáticamente según el visitante y la conversación:

| Variable                                                                                                      | Qué contiene                                                         |
| ------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| `contact_fname`, `contact_city`, `contact_state`, `contact_country`, `contact_postal_code`, `contact_address` | Datos de ubicación/contacto del visitante, cuando están disponibles. |
| `contact_company`, `contact_job_title`, `contact_industry`, `contact_website`                                 | Datos de la empresa del contacto, cuando están disponibles.          |
| `webpage_title`, `webpage_url`                                                                                | Título y URL de la página donde está el widget — solo widget web.    |
| `user_id`, `chat_id`                                                                                          | Identificadores únicos del visitante y de la conversación actual.    |
| `conversation_content`                                                                                        | Transcripción del chat (últimos 50 mensajes).                        |

## Respuestas predefinidas (Canned responses)

Atajos de texto para que un agente humano responda más rápido durante un handoff, sin tener que volver a escribir las mismas respuestas.

<Steps>
  <Step title="Ve a Settings → Canned responses">
    Verás la lista de respuestas guardadas para este agente.
  </Step>

  <Step title="Creá una respuesta">
    Completá **Título** (para identificarla en la lista), un **Shortcut** opcional (atajo de texto) y el **Body** (el mensaje que se va a enviar).
  </Step>

  <Step title="Usala durante un handoff">
    Desde el chat en vivo, seleccioná la respuesta guardada para insertarla sin tipearla de nuevo.
  </Step>
</Steps>

## Límites de créditos (Limits)

Además del límite de mensajes de tu plan, podés poner un tope de créditos de IA mensual **por agente** — útil si tenés varios agentes y querés repartir el consumo entre ellos.

* **Activar límite** — habilita un tope mensual específico para este agente.
* **Créditos mensuales** — la cantidad máxima de créditos que puede consumir el agente en el mes.
* El uso actual del mes y la fecha de reinicio del contador se muestran en la misma pantalla.

<Note>
  Este límite es adicional al límite de mensajes de tu plan general — sirve para controlar el consumo de un agente puntual, no para ampliarlo por encima de tu plan.
</Note>

## Notificaciones del agente

<Note>
  Esta sección es distinta de las [alertas de uso por email](/guias/notificaciones) a nivel de toda la organización — acá configurás avisos específicos de este agente.
</Note>

Desde `Settings → Notifications` podés activar, por agente, dos alertas por email con lista de destinatarios propia:

| Alerta                 | Cuándo avisa                                                                     |
| ---------------------- | -------------------------------------------------------------------------------- |
| **Nuevo contacto**     | Cada vez que este agente captura un nuevo contacto (por ejemplo, vía Lead Form). |
| **Nueva conversación** | Cuando se inicia una conversación nueva con este agente.                         |

Para cada alerta podés agregar uno o más emails de destino, independientes de los configurados en las alertas de uso de la organización.

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿La whitelist de dominios afecta a WhatsApp e Instagram?">
    No. Solo aplica al widget web. WhatsApp e Instagram se gestionan por separado desde la pestaña Deploy.
  </Accordion>

  <Accordion title="¿Puedo usar variables custom junto con las variables de sistema en el mismo prompt?">
    Sí. Ambas se referencian de la misma forma en el system prompt del agente.
  </Accordion>

  <Accordion title="¿Las respuestas predefinidas se comparten entre agentes?">
    No, cada agente tiene su propia lista de respuestas predefinidas.
  </Accordion>

  <Accordion title="¿Qué pasa si un agente llega a su límite de créditos mensual?">
    El agente deja de responder hasta que el contador se reinicie el mes siguiente, aunque tu plan general todavía tenga cupo disponible. Podés desactivar el límite en cualquier momento.
  </Accordion>
</AccordionGroup>