Flujos relacionados: Crear cita (Cal.com).Agentes relacionados: Gestión de citas (Cal.com).
Qué hace
El agente le pasa el tipo de cita (event_type_id) y el rango horario a consultar (start_time y end_time, en hora local), y el flujo devuelve los huecos libres de Cal.com para ese tipo de cita dentro de esa franja, ya en hora local.
Cada hueco de la lista viene con fecha y hora en hora local, más un campo inicio_utc interno que el agente debe ignorar por completo.
Es un flujo durante llamada: el agente lo ejecuta a mitad de conversación y espera el resultado para seguir hablando.
Cómo funciona
Si no queda ningún hueco en el rango pedido, la respuesta se lo dice explícitamente al agente para que pida otro día.
Qué necesitas
- Una conexión de Cal.com
- El tipo de cita (
event_type_id) que va a consultar, que el agente obtiene del flujo Obtener tipos de cita (Cal.com)
Puesta en marcha
1
Copia la plantilla
Desde la sección Flujos, abre el catálogo de plantillas y cópiala. El flujo se crea deshabilitado. También puedes crearlo desde la plantilla de agente Gestión de citas (Cal.com).
2
Selecciona la conexión de Cal.com
En el paso Obtener huecos disponibles en Cal, indica tu conexión de Cal.com.
3
Revisa la zona horaria
Europe/Madrid aparece en tres sitios: el input zona del paso Convertir rango a UTC (dos veces, para el inicio y el fin) y el campo Time Zone del paso Obtener huecos disponibles en Cal. Si operas en otra zona horaria, cámbialos en los tres. El cambio de hora de verano/invierno se aplica solo.4
Publica el flujo
Publica el flujo.
5
Asígnalo al agente
Añádelo desde la sección Flujos del agente. El nombre del flujo es el nombre de la herramienta que ve el agente, así que déjalo en
comprobar_disponibilidad. Este paso no es necesario si el flujo se ha creado a partir del agente.Antes de publicar
- El flujo solo consulta. El alta de la cita corre a cargo de
crear_cita. - El
event_type_idtiene que existir en Cal.com. Si el agente manda un id que no corresponde a ningún tipo de cita, la consulta a Cal.com falla y el flujo no llega a devolver huecos. - Los huecos se calculan según la configuración de disponibilidad de ese tipo de cita en Cal.com (horario, buffers, días bloqueados), no según nada que defina el flujo. Para cambiar cuándo se puede agendar, edítalo directamente en Cal.com.
- El campo
inicio_utcde cada hueco es interno: solo sirve para ordenar la lista. Si el agente lo lee en voz alta, va a sonar mal — la instrucción para ignorarlo está en el mensaje de Devolver respuesta, no lo quites si editas el paso.
Siguientes Pasos
Gestión de citas (Cal.com)
El agente que usa este flujo.
Crear cita (Cal.com)
El flujo que crea la cita en el hueco elegido.
Flujos durante llamada
Si quieres modificar los pasos del flujo.