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

# Cal.com

> Cómo configurar la Acción Cal.com en un agente de ChatNorris para que el visitante agende una reunión sin salir del chat, con el calendario embebido en el widget web, pegando solo el link público de tu tipo de evento.

# Cal.com

Con la Acción Cal.com, el visitante agenda una reunión contigo sin salir del chat. Cuando la conversación calza con lo que defines:

* en el **widget web** y en el **Playground**, el agente abre tu calendario de Cal.com embebido dentro de la conversación;
* en **WhatsApp, Instagram, Messenger, Telegram y Email**, el agente comparte el link directo del evento;
* si el visitante ya dejó sus datos de contacto, el formulario de reserva se precompleta.

No hace falta conectar ninguna cuenta: solo pegas el link público de tu tipo de evento.

## Requisitos

* Una cuenta de ChatNorris en cualquier plan. Cal.com está incluida en **todos los planes**, también en Free. 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).
* Un tipo de evento (event type) de Cal.com con su link público.
* Rol **Owner** o **Admin** en tu organización de ChatNorris.

> [!NOTE]
>
> Cal.com aparece en el catálogo de **Integraciones**, en la categoría Agenda, pero no requiere conexión ni credenciales: se configura directamente en la Acción.

## Configurar la Acción

**1. Crea la Acción Cal.com**

Entra a `Agentes → [tu agente] → Acciones`, haz clic en **Nueva acción** y elige **Cal.com**.

**2. Pega el link público de tu evento de Cal.com**

En **Enlace del evento**, pega la URL pública de tu event type de Cal.com (`cal.com/...` o `www.cal.com/...`) o solo el slug `usuario/evento`. No requiere conectar una cuenta ni credenciales.

**3. Define cuándo ofrecer el calendario**

En **Comportamiento**, describe en **Cuándo usar** en qué situaciones el agente debe ofrecer el calendario de reservas. Puedes volver al texto original con **Restaurar texto predeterminado**. El calendario se ofrece cada vez que corresponda, salvo que el visitante ya haya reservado en esa conversación.

**4. Personaliza la apariencia y los mensajes**

Ajusta el diseño y el tema del calendario embebido, además de los mensajes de éxito y de error que ve el visitante (ver abajo).

**5. Habilita la Acción y guarda**

Con **Habilitado** encendido, el agente ofrece el calendario cuando corresponda.

### Apariencia del calendario

| Opción | Qué hace |
| - | - |
| **Diseño** | **Mes (calendario completo)**, **Semana (compacto en el chat)** o **Columna (compacto)**, que viene por defecto. En el chat, Semana y Columna usan la vista compacta de días y horarios. |
| **Tema** | **Automático** (por defecto), **Claro** u **Oscuro**. |
| **Ocultar detalles del evento** | Recomendado en el chat (activado por defecto): oculta título, duración y zona horaria para dejar solo días y horarios. |

En **Mensajes posteriores a la reserva** defines el **Mensaje de éxito** y el **Mensaje de error** que ve el visitante según el resultado de la reserva.

### Cómo agenda el visitante

En el **widget web** y en el **Playground**, el calendario de Cal.com se abre embebido dentro de la conversación. En los canales de mensajería (WhatsApp, Instagram, Telegram, Messenger) y en Email, el agente comparte el link directo del evento. El agente nunca inventa horarios ni confirma una reserva por su cuenta: el visitante elige el horario y reserva en Cal.com.

> [!TIP]
>
> Si el visitante ya dejó sus datos de contacto antes (por ejemplo, en un Lead Form o durante la charla), el formulario de reserva de Cal.com se precompleta automáticamente con su nombre, email y teléfono.

> [!WARNING]
>
> En el **Playground** las reservas de Cal.com 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).

### Varias acciones de agenda en el mismo agente

Si un agente tiene más de una acción de agenda (por ejemplo, Cal.com, [Calendly](https://docs.chatnorris.ai/guias/calendly.md) y [Google Calendar](https://docs.chatnorris.ai/guias/google-calendar.md)), muestra **un solo calendario por respuesta**: el que mejor calza con lo que pidió el visitante. Describe bien en **Cuándo usar** qué tipo de reunión cubre cada una para que acierte.

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 el calendario. Ver [Human Handoff](https://docs.chatnorris.ai/guias/acciones.md#human-handoff).

## Preguntas frecuentes

> [accordion] ¿Tengo que conectar mi cuenta de Cal.com?
>
> No. Solo necesitas el link público de tu tipo de evento. No se cargan credenciales ni API keys.

> [accordion] ¿Cal.com está incluida en el plan Free?
>
> Sí. La Acción Cal.com está incluida en todos los planes, también en Free.

> [accordion] Las reservas de Cal.com no aparecen en Pipedrive
>
> Cal.com no avisa la reserva a ChatNorris, así que la capacidad **Registrar reuniones agendadas** de [Pipedrive](https://docs.chatnorris.ai/guias/pipedrive.md) no las registra. Solo registra las citas de Google Calendar, Encuadrado y AgendaPro.


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