Herramientas de VoiceAgent: Cal.com - CloudTalk Help Center

Este ejemplo muestra cómo configurar dos herramientas que funcionan juntas para gestionar la programación de citas a través de Cal.com. Una herramienta sirve para obtener los horarios disponibles y la otra para reservar la hora elegida una vez que el cliente confirma.

Nivel de usuario: Admin

Antes de empezar

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

Herramienta 1: obtener los horarios disponibles

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}}`	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.
	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.

Herramienta 2: reservar la cita

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`	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.
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 — estamos aquí para ayudarte.