Cal.com
Esta guía explica cómo conectar Cal.com con OneChat, vincular tus calendarios y proveedores de reuniones, y usar acciones de Cal.com dentro de las automatizaciones de tu chatbot.
_pso4256m96uSECCIÓN 1: Conectar Cal.com a OneChat
_fxi8a1welh6gPaso 1: Generar una API Key en Cal.com
Inicia sesión en tu cuenta de Cal.com. Ve a Settings. En la sección Developer, haz clic en API Keys. Allí puedes crear una API Key. Crea la clave y cópiala de inmediato.
Puedes ir directamente a la sección de API Key con esta URL: https://app.cal.com/settings/developer/api-keys
Usarás esta API Key dentro de OneChat para conectar tu cuenta.
_2iet7nq7dtsxPaso 2: Conectar Cal.com dentro de OneChat
Inicia sesión en tu panel de OneChat. Ve a Integrations. Busca Cal.com en la lista de integraciones. Pega tu API Key. Haz clic en Connect.
Una vez conectado, aparecerá correctamente un ícono de verificación. Se mostrarán tu correo electrónico y nombre de usuario de Cal.com. Esto confirma que la conexión está activa.
_97u6h8s8zxwSECCIÓN 2: Uso de acciones de Cal.com en OneChat
Después de la integración, puedes usar las siguientes acciones dentro de los flujos de automatización.
_v1a7vu8yiya4Acción: Obtener perfil de usuario
Recupera los detalles del perfil del usuario de Cal.com conectado.
Datos devueltos: Nombre, correo electrónico, zona horaria, día de inicio de semana, etc.
Cuándo usarla: Usa esta acción para obtener información del anfitrión para personalización, manejo de zona horaria o lógica de programación.
_1edod62v0oybAcción: Generar URL de reserva
Genera un enlace de reserva para un tipo de evento y asistente específicos.
Campos obligatorios: ID del tipo de evento, nombre del asistente, correo electrónico del asistente
Datos devueltos: URL de reserva
Cuándo usarla: Úsala cuando quieras que los usuarios seleccionen manualmente un horario mediante un enlace compartido.
_dsqi02hmeq0mAcción: Buscar reservas
Campos obligatorios: ID del tipo de evento
Campos opcionales: hora de inicio (formato ISO 8601), hora de fin (formato ISO 8601), correo electrónico del asistente, nombre del asistente, etc.
Datos devueltos: ID de reserva, UID, título, descripción, estado, etc.
Cuándo usarla: Úsala para revisar reservas existentes o filtrar reservas dentro de un rango de fechas.
_ut0ob8okh5vsAcción: Crear una reserva
Crea una reserva directamente sin enviar un enlace.
Campos obligatorios: ID del tipo de evento, hora de inicio (formato ISO 8601), correo electrónico del asistente, nombre del asistente
Campos opcionales: teléfono del asistente, zona horaria del asistente, idioma del asistente, etc.
Datos devueltos: ID de reserva, UID, título, URL de reunión, detalles del evento, hora de inicio, etc.
Cuándo usarla: úsala cuando el chatbot gestione toda la programación automáticamente.
_v6osk9f4kr6rAcción: Obtener una reserva
Recupera los detalles de una reserva específica.
Campo obligatorio: UID de la reserva
Datos devueltos: detalles completos de la reserva, incluidos el evento, el asistente y la información de la reunión.
Cuándo usarla: Úsala cuando necesites información completa de una reserva específica.
_ocd8ga7zq67gAcción: Reprogramar una reserva
Actualiza la hora programada de una reserva existente.
Campos obligatorios: UID de la reserva, nueva hora de inicio (formato ISO 8601), reprogramado por (correo electrónico)
Campo opcional: motivo de reprogramación
Cuándo usarla: Úsala cuando un usuario quiera cambiar la hora de su cita.
_d5b0sysnbdsnAcción: Cancelar una reserva
Cancela una reserva existente.
Campo obligatorio: UID de la reserva
Campos opcionales: motivo de cancelación, cancelar reservas posteriores
Cuándo usarla: Úsala cuando sea necesario cancelar una reserva.
_xlr1ch4uphu0Acción: Marcar ausencia en una reserva
Marca a un asistente como ausente (un "no-show") en una reunión programada específica. También puede marcar la ausencia del anfitrión.
Campo obligatorio: UID de la reserva
Cuándo usarla: Registra ausencias. Permite que los sistemas automatizados registren cuando un invitado no asiste a un evento programado.
_deytbrj7bxz5Acción: Confirmar una reserva
Confirma una reserva que requiere aprobación.
Campo obligatorio: UID de la reserva
Cuándo usarla: Úsala cuando las reservas requieran confirmación manual.
_7k6b555rvy9mAcción: Rechazar una reserva
Rechaza una solicitud de reserva.
Campo obligatorio: UID de la reserva
Campo opcional: motivo del rechazo
Cuándo usarla: Úsala cuando no se pueda aceptar una solicitud de reserva.
_bv71imsjawr9Acción: Obtener enlaces de calendario
Recupera enlaces de calendario y reunión para una reserva.
Campo obligatorio: UID de la reserva
Datos devueltos: enlace de Google Meet, enlace de Microsoft Office, enlace de Outlook, archivo ICS
Cuándo usarla: Úsala para enviar enlaces de reunión o calendario a los usuarios.
_uq208mkh0bfyAcción: Obtener referencias de reserva
Recupera los datos de referencia asociados con una reserva.
Campo obligatorio: UID de la reserva
Datos devueltos: identificadores de referencia, metadatos
Cuándo usarla: Úsala para integraciones, seguimiento o sistemas externos.
_vajf80ajuh5jAcción: Listar tipos de evento
Recupera todos los tipos de evento disponibles.
Cuándo usarla: Úsala para mostrar o seleccionar los tipos de reserva disponibles.
_w6bdpyt1kfwaAcción: Obtener tipo de evento
Recupera los detalles de un tipo de evento específico.
Campo obligatorio: ID del tipo de evento
Cuándo usarla: Úsala para obtener los detalles de configuración de un evento específico.
_5udbrhxugrx2Acción: Eliminar tipo de evento
Elimina un tipo de evento.
Campo obligatorio: ID del tipo de evento
Cuándo usarla: Úsala al eliminar tipos de evento no utilizados o desactualizados.
_cblldt3mx2lzAcción: Listar horarios
Recupera todos los horarios.
Cuándo usarla: Úsala para ver todos los horarios de disponibilidad configurados.
_pcdj6torb0nmAcción: Obtener horario predeterminado
Recupera el horario predeterminado.
Cuándo usarla: Úsala al aplicar reglas de disponibilidad predeterminadas.
_lcpsokvm2c6rAcción: Obtener horario
Recupera los detalles de un horario específico.
Campo obligatorio: ID del horario
Cuándo usarla: Úsala para revisar un horario en particular.
_g1oao9t068isAcción: Eliminar horario
Elimina un horario.
Campo obligatorio: ID del horario
Cuándo usarla: Úsala al eliminar horarios que ya no se necesitan.
_1ltc6qg37ifaAcción: Buscar horarios disponibles
Encuentra horarios disponibles para reservar.
Campo obligatorio: se requiere ID del tipo de evento o Event Slug, hora de inicio (formato ISO 8601), hora de fin (formato ISO 8601)
Cuándo usarla: Úsala para mostrar horarios disponibles a los usuarios antes de reservar.
_y0sgfjerwa53Acción: Reservar un horario
Reserva temporalmente un horario.
Campo obligatorio: detalles del horario
Cuándo usarla: Úsala para apartar un horario antes de confirmar la reserva.
_r4tjvb53c097Acción: Obtener un horario reservado
Recupera los detalles de un horario reservado.
Campo obligatorio: UID del horario
Cuándo usarla: Úsala para verificar los detalles de la reserva.
_ss3sbyhgn1cxAcción: Eliminar horario reservado
Libera un horario reservado.
Campo obligatorio: UID del horario
Cuándo usarla: Úsala para liberar un horario si no se reservó.
_r945obwofw0uAcción: Actualizar horario reservado
Actualiza los detalles de un horario reservado.
Campos obligatorios: UID del horario, ID del evento, hora de inicio (formato ISO 8601)
Cuándo usarla: Úsala al modificar los detalles de la reserva.