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

# Herramientas de VoiceAgent: Cal.com

> Este ejemplo muestra cómo configurar dos herramientas que funcionan juntas para gestionar la programación de citas a través de Cal.com.

<Note>
  Este ejemplo muestra cómo configurar dos herramientas que funcionan juntas para gestionar la programación de citas a través de [Cal.com](https://cal.com/). Una herramienta sirve para **obtener los horarios disponibles** y la otra para **reservar la hora elegida** una vez que el cliente confirma.
</Note>

**Nivel de usuario:** Admin

***

<h2 id="h_6c37ea78bb">
  Antes de empezar
</h2>

Antes de empezar, asegúrate de tener:

* una cuenta activa en Cal.com y acceso de administrador a ella

* una suscripción activa a Recepcionista de IA o Especialista de IA en tu cuenta

<h3 id="h_7232ab609f">
  Herramienta 1: obtener los horarios disponibles
</h3>

| **Sección** | **Campo** | **Valor** | **Descripción** |
| - | - | - | - |
| **General** | Nombre de la herramienta | `get_free_slots` | Describe lo que hace la herramienta. |
| | Descripción | Cuando el cliente pregunte por los horarios disponibles, usa esta herramienta para obtener la lista. La respuesta incluirá fechas y horas en UTC. | Ayuda al LLM a decidir cuándo llamar a esta herramienta. |
| | Mensaje de espera de respuesta | Voy a comprobar la disponibilidad. Un momento, por favor. | Mensaje que se reproduce mientras se procesa la solicitud de la herramienta. |
| **Definición de la solicitud** | Método | `GET` | Método de la solicitud. |
| | URL | [`https://api.cal.com/v2/slots?username=#{{userName}}&eventTypeSlug=#{{eventType}}&start=#{{startDate}}&end=#{{endDate}}`](https://api.cal.com/v2/slots?username=\&eventTypeSlug=\&start=\&end=) | URL del endpoint con parámetros. |
| **Encabezados** | cal-api-version | `2024-09-04` | Obligatorio para Cal.com. |
| | Authorization | `Bearer cal_live_76***REDACTED***17` | Sustitúyelo por tu clave de API de Cal.com. |
| **Parámetros de ruta** | username | Constante: `elise-marshall` | Tu nombre de usuario de Cal.com. Puedes encontrarlo en [tu perfil](https://app.cal.com/settings/my-account/profile). |
| | eventType | Constante: `30min` | Slug de la página de detalles del evento en Cal.com. Usa LLM Prompt si hay varios tipos disponibles. |
| | startDate | Parámetro: `startDate` | Define el inicio de la ventana de búsqueda. Debe pasarse como variable del System Prompt. |
| | endDate | Parámetro: `endDate` | Define el final de la ventana de búsqueda. También se pasa mediante una variable del System Prompt. |

<h3 id="h_667269c8a4">
  Herramienta 2: reservar la cita
</h3>

| **Sección** | **Campo** | **Valor** | **Descripción** |
| - | - | - | - |
| **General** | Nombre de la herramienta | `book_meeting` | Nombre descriptivo de la herramienta. |
| | Descripción | Esta herramienta reserva una reunión en el calendario después de que el cliente elija una hora. | Ayuda al LLM a entender cuándo usar la herramienta. |
| | Mensaje de espera de respuesta | Estoy programando la reunión. Espera un momento, por favor. | Mensaje que se reproduce mientras se realiza la reserva. |
| **Definición de la solicitud** | Método | `POST` | Método de la solicitud. |
| | URL | [`https://api.cal.com/v2/bookings`](https://api.cal.com/v2/bookings) | Endpoint para reservar una reunión. |
| **Encabezados** | cal-api-version | `2024-08-13` | Según lo requiere Cal.com. |
| | Authorization | `Bearer cal_live_76***REDACTED***17` | Sustitúyelo por tu clave de API de la [configuración de API de Cal.com](https://app.cal.com/settings/developer/api-keys). |
| **Parámetros del cuerpo** | username | Constante: `elise-marshall` | Tu nombre de usuario de Cal.com. |
| | eventTypeSlug | Constante: `30min` | Tipo de evento que se programa. |
| | start | LLM Prompt: La hora de inicio de la reserva en formato ISO 8601 y zona horaria UTC, p. ej. `2024-08-13T09:00:00Z`. | Se extrae de la conversación. |
| | attendee.name | Parámetro: `name` | Se pasa mediante el System Prompt. |
| | attendee.email | LLM Prompt: Correo electrónico del cliente que reserva la reunión. | Se extrae dinámicamente. |
| | attendee.timezone | Constante o LLM Prompt | Se define según tu flujo de trabajo. |

***

*¿Necesitas ayuda o tienes alguna pregunta?* Escríbenos a través de nuestro [Portal de atención al cliente](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — estamos aquí para ayudarte.


## Related topics

- [Herramientas para VoiceAgent](/es/articles/11275049-tools-for-voiceagent.md)
- [VoiceAgents para llamadas salientes](/es/articles/11401649-voiceagents-for-outbound-calls.md)
- [Activar una llamada de VoiceAgent desde Zapier](/es/articles/11831224-triggering-a-voiceagent-call-from-zapier.md)


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