> ## 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.

# Encuadrado

> Cómo conectar tu agenda clínica de Encuadrado a un agente de ChatNorris para que consulte disponibilidad real y cree reservas verificadas, y cómo configurar los servicios, la disponibilidad y los datos que se piden al paciente.

# Encuadrado

Con la integración de Encuadrado, tu agente de ChatNorris atiende a los pacientes de tu agenda clínica sin que salgan del chat. Según lo que actives, el agente:

* identifica qué servicio le interesa al paciente;
* consulta los horarios reales disponibles en tu agenda y se los propone;
* recolecta los datos que pide la reserva, muestra un resumen y, recién después de que el paciente **confirma explícitamente**, crea la reserva.

Nunca reserva de forma automática en medio de la charla. Funciona en el widget web, WhatsApp, Instagram, Messenger, Telegram, Email y la API.

## Requisitos

* Una cuenta de ChatNorris con plan **Standard** o **Premium**. Puedes ver los planes en [chatnorris.ai/pricing](https://chatnorris.ai/pricing).
* Al menos un agente creado en ChatNorris. Si todavía no tienes uno, sigue [Crear un agente](https://docs.chatnorris.ai/guias/crear-agente-wizard.md).
* Una cuenta de Encuadrado y la API key del profesional.
* Rol **Owner** o **Admin** en tu organización de ChatNorris.

## Conectar Encuadrado

Cada agente se conecta a una cuenta de Encuadrado.

**1. Abre el hub de Integraciones del agente**

En ChatNorris, entra a `Agentes → [tu agente] → Integraciones` y elige **Encuadrado**.

**2. Pega la API key y conecta**

Pega tu API key de Encuadrado en **API key** y haz clic en **Conectar**.

**3. Prueba la conexión**

Usa **Probar conexión** para confirmar que la clave funciona antes de configurar la Acción.

La API key se guarda cifrada y nunca se muestra en texto plano. Si cambias la clave en Encuadrado, pega la nueva con **Reemplazar clave**.

## Configurar la Acción

Conectar la cuenta no activa nada todavía. Para elegir qué hace el agente:

**1. Crea la Acción Encuadrado**

Entra a `Agentes → [tu agente] → Acciones`, haz clic en **Nueva acción** y elige **Encuadrado**. La sección **Cuenta de Encuadrado** muestra el estado de la conexión.

**2. Elige qué puede hacer**

En **Qué puede hacer**, activa las capacidades (ver la tabla de abajo).

**3. Configura los servicios y la disponibilidad**

Define qué servicios de tu agenda debe poder ofrecer el agente y cuántos días y horarios busca (ver más abajo).

**4. Activa la Acción y guarda**

Con **Habilitada** encendido, el agente usa tu agenda en sus conversaciones.

| Capacidad | Qué hace |
| - | - |
| **Consultar disponibilidad** | Consulta horarios reales y los propone al paciente. Viene activada. |
| **Crear reservas** | Recolecta datos, pide confirmación explícita y crea la reserva. Requiere **Consultar disponibilidad**. |

Sin **Crear reservas**, el agente solo ofrece horarios y el enlace público del servicio para que el paciente reserve por su cuenta, y no le pide datos personales.

> [!WARNING]
>
> **Crear reservas** crea agenda real en la clínica: verifica los datos configurados antes de activarla. **Se recomienda Claude Sonnet o superior** como modelo principal del agente (`Configuración → IA`) cuando activas esta capacidad. En pruebas, Haiku a veces ignora la confirmación y responde como si la reserva ya estuviera hecha. El formulario de la acción muestra este aviso con un enlace a la configuración de IA.

### Cuándo usar

En **Comportamiento**, el campo **Cuándo usar esta acción** trae un texto por defecto que puedes adaptar: cuándo el paciente quiere saber horarios o agendar, y que primero se identifica el servicio. Con **Restaurar texto predeterminado** vuelves al original.

### Servicios

Agrega en **Servicios** cada servicio que el agente puede ofrecer. Cada uno necesita su **UUID del servicio** de Encuadrado, que se obtiene desde la URL al editar el servicio en el panel de Encuadrado.

| Campo | Para qué sirve |
| - | - |
| **Nombre** y **Descripción** | Cómo el agente identifica y presenta el servicio. |
| **UUID del servicio** | El identificador del servicio en Encuadrado. Sin él, el servicio no se puede consultar. |
| **Duración (min)** | Cuánto dura la cita. |
| **Modalidad** | **Online**, **Presencial** o **A domicilio**. |
| **Precio** | El precio que el agente informa. |
| **Enlace público** | La página de reservas del servicio. El agente la ofrece cuando no puede confirmar un horario o la fecha está fuera del rango de búsqueda. |
| **Nombre del profesional** | Quién atiende el servicio. |
| **Emite boleta electrónica** | El servicio emite boleta: la reserva pide además dirección y comuna. |
| **Requiere prepago** | El paciente tiene que pagar para confirmar la hora. |
| **Habilitado** | Si el agente puede ofrecer este servicio. |

Con **Nuevos servicios emiten boleta por defecto** y **Nuevos servicios requieren prepago por defecto** eliges cómo parte cada servicio que agregas.

> [!NOTE]
>
> Para servicios que emiten boleta, el agente valida la comuna del paciente contra el listado oficial. Las reservas respetan el huso horario de Chile (`America/Santiago`).

En un servicio con prepago, la hora queda reservada temporalmente: el agente le informa al paciente el enlace de pago y el plazo para pagar, y no le dice que la cita quedó agendada. Si no paga a tiempo, el cupo se libera.

### Disponibilidad

| Opción | Qué hace |
| - | - |
| **Días de búsqueda** | Hasta cuántos días desde hoy busca horarios el agente (1 a 60; por defecto, 14). |
| **Horarios ofrecidos** | Cuántos horarios propone de una vez (1 a 10; por defecto, 3). |

Si el paciente pide una fecha más lejana que **Días de búsqueda**, o no hay horarios en ese rango, el agente se lo explica y le ofrece los horarios más próximos o el enlace público del servicio.

### Datos requeridos de la cuenta

Estos datos se piden en toda reserva, además de los que exija cada servicio (boleta → dirección y comuna):

| Dato | Detalle |
| - | - |
| **Email** | Requerido para confirmar la reserva. Viene activado. |
| **Teléfono** | Se guarda únicamente como hash. |
| **RUT** | Se usa solo para la reserva; nunca se guarda. |
| **Fecha de nacimiento** | Se usa solo para la reserva; nunca se guarda. |
| **Términos y condiciones** | Requiere aceptación explícita del paciente. |

### Cómo reserva el paciente

1. El agente identifica el servicio y consulta los horarios reales disponibles.
2. Si **Crear reservas** está activa, pide los datos requeridos, resume la cita (servicio y horario) y espera una confirmación explícita. Ver qué respuestas cuentan como confirmación en [Confirmaciones del visitante](https://docs.chatnorris.ai/guias/acciones.md#confirmaciones-del-visitante).
3. Recién entonces crea la reserva y se la informa al paciente. Si Encuadrado no confirma la reserva, el agente no dice que quedó agendada ni reintenta solo: le pide al paciente verificar con la clínica o por el enlace público.

> [!WARNING]
>
> En el **Playground** las reservas de Encuadrado son reales. Si el agente tiene esta Acción, antes del primer mensaje verás el aviso **Esta prueba puede crear datos reales**. Ver [Probar un agente](https://docs.chatnorris.ai/guias/chatbots.md#probar-un-agente).

### Citas en Leads y en tu CRM

Las citas agendadas por el agente con Encuadrado aparecen en [Leads](https://docs.chatnorris.ai/guias/leads.md), en la columna **Cita** y en la sección **Citas** del detalle del lead. Si el agente también tiene la Acción [Pipedrive](https://docs.chatnorris.ai/guias/pipedrive.md) con **Registrar reuniones agendadas**, cada cita confirmada se registra en el Lead de Pipedrive como actividad **Reunión**.

Con una acción de agenda lista, pedir una reunión o una llamada no es un handoff, aunque el visitante nombre a un ejecutivo o asesor: el agente le ofrece horarios. Ver [Human Handoff](https://docs.chatnorris.ai/guias/acciones.md#human-handoff).

## Desconectar

En `Agentes → [tu agente] → Integraciones → Encuadrado`, haz clic en **Desconectar**. La Acción Encuadrado se deshabilita y conserva su configuración, y la API key se borra de ChatNorris. Para volver a usarla, conecta la cuenta de nuevo y reactiva la Acción.

## Preguntas frecuentes

> [accordion] ¿Dónde se conecta la cuenta de Encuadrado?
>
> En **Integraciones**, el hub centralizado de cada agente, no en la pantalla de la Acción. Ver [Integraciones](https://docs.chatnorris.ai/guias/integraciones.md).

> [accordion] El agente no ofrece un servicio que sí existe en Encuadrado
>
> Revisa que el servicio esté agregado en **Servicios**, con su **UUID del servicio** y **Habilitado** encendido. El agente solo ofrece los servicios configurados en la Acción.

> [accordion] ¿Por qué el agente no crea la reserva y solo comparte un enlace?
>
> La capacidad **Crear reservas** está apagada: en ese caso el agente solo ofrece horarios y el enlace público del servicio. Actívala en **Qué puede hacer**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.