Calendly es una herramienta de programación que simplifica la coordinación de reuniones, permitiendo a los usuarios programar eventos sin necesidad de correos electrónicos de ida y vuelta.
Table of Contents
📌 ¿Qué es este módulo?
Este módulo integra Saturn Studio con Calendly, la herramienta de programación de reuniones. Te permite gestionar tipos de eventos y crear reuniones directamente desde tus automatizaciones, simplificando la coordinación de agendas y la interacción con la plataforma Calendly sin necesidad de intercambios manuales.
Descripción de los comandos
Listar Tipos de Eventos
Listar todos los tipos de eventos configurados en Calendly para un usuario u organización.
| Parámetro | Descripción | Ejemplo |
| Credencial | Credencial de Calendly necesaria para listar los tipos de eventos. | credential |
| Tipo de búsqueda evento | Indica si la búsqueda se realizará a nivel de Usuario o de Organización. | User o Organization |
| Usuario | Seleccione el usuario donde se encuentran los eventos | https://api.calendly.com/users/b35404f6-e07c-4p2e-beb9-1b6f49d5ed5e |
| Organización | Seleccione la organización donde se realizaran los actos. | https://api.calendly.com/organizations/b35404f6-e07c-4p2e-beb9-1b6f49d5ed5e |
| Asignar resultado a variable | Variable donde se almacenará la lista de tipos de eventos. {“events”: [{“active”: true, “admin_managed”: false, “booking_method”: “instant”, “color”: “#8247f5”, “created_at”: “2025-02-06T20:14:21.261173Z”, “custom_questions”: [{“answer_choices”: [], “enabled”: true, “include_other”: false, “name”: “Please share anything that will help prepare for our meeting.”, “position”: 0, “required”: false, “type”: “text”}], “deleted_at”: null, “description_html”: null, “description_plain”: null, “duration”: 30, “duration_options”: null, “internal_note”: null, “kind”: “solo”, “locations”: [{“kind”: “google_conference”}], “name”: “30 Minute Meeting”, “pooling_type”: null, “position”: 1, “profile”: {“name”: “John Doe”, “owner”: “https://api.calendly.com/users/3ebfdf0d-830c-476d-a5ae-19c58053c772”, “type”: “User”}, “scheduling_url”: “https://calendly.com/johndoe/30min”, “secret”: false, “slug”: “30min”, “type”: “StandardEventType”, “updated_at”: “2025-02-06T20:35:33.776350Z”, “uri”: “https://api.calendly.com/event_types/fa91ae2a-fc4e-4992-838f-1fd570f38554”}]} | {var} |
Obtener un Tipo de Evento
Obtener un tipo de evento en Calendly
| Parámetro | Descripción | Ejemplo |
| Credencial | Credencial de Calendly necesaria para obtener el tipo de evento. | credential |
| Tipo de Evento | Tipo de evento que se desea obtener. | https://api.calendly.com/event_types/EBHAAFHDCAEQTSEZ |
| Asignar resultado a variable | Variable donde se almacenarán los detalles del tipo de evento. {“event_type”: {“resource”: {“active”: true, “admin_managed”: false, “booking_method”: “instant”, “color”: “#8247f5”, “created_at”: “2025-02-06T20:14:21.261173Z”, “custom_questions”: [{“answer_choices”: [], “enabled”: true, “include_other”: false, “name”: “Please share anything that will help prepare for our meeting.”, “position”: 0, “required”: false, “type”: “text”}], “deleted_at”: null, “description_html”: null, “description_plain”: null, “duration”: 30, “duration_options”: null, “internal_note”: null, “kind”: “solo”, “locations”: [{“kind”: “google_conference”}], “name”: “30 Minute Meeting”, “pooling_type”: null, “position”: 1, “profile”: {“name”: “John Doe”, “owner”: “https://api.calendly.com/users/9ebfdfed-830c-4767-w2ae-39c58053c772”, “type”: “User”}, “scheduling_url”: “https://calendly.com/johndoe/30min”, “secret”: false, “slug”: “30min”, “type”: “StandardEventType”, “updated_at”: “2025-02-06T20:35:33.776350Z”, “uri”: “https://api.calendly.com/event_types/sa92ae2f-fc4e-3992-831f-1dd370f38554”}}} | {var} |
Crear una Reunión Única
Crear una reunión única (one-off) en Calendly con parámetros específicos.
| Parámetro | Descripción | Ejemplo |
| Credencial | Credencial de Calendly necesaria para crear la reunión. | credential |
| Nombre | Nombre del tipo de evento para la reunión única. | Mi Evento |
| Anfitrión | Nombre del anfitrión | https://api.calendly.com/users/9ebfdfed-830c-4767-w2ae-39c58053c772 |
| Co-anfitrión(es) | Nombre del co-anfitrión | https://api.calendly.com/users/9ebfdfed-830c-4767-w2ae-39c58053c772, https://api.calendly.com/users/9ebfdfed-830c-4767-w2ae-39c58053c772 |
| Duración | Duración de la reunión en minutos. | 30 |
| Zona Horaria | Zona horaria en la que se establecerá la reunión. | America/New_York |
| Fecha de Inicio | Fecha de inicio de la disponibilidad para la reunión. Formato: YYYY-MM-DD. Debe ser anterior a la Fecha de Fin. | 2025-02-25 |
| Fecha de Fin | Fecha de fin de la disponibilidad para la reunión. Formato: YYYY-MM-DD. Debe ser futura y a menos de 365 días de la Fecha de Inicio. | 2025-02-25 |
| Ubicación | Descripción de la ubicación de la reunión | Oficina Principal |
| Asignar resultado a variable | Variable donde se almacenarán los detalles de la reunión única creada. | {"event_type": {"resource": {"active": true, "admin_managed": false, "booking_method": "instant", "color": "#0069ff", "created_at": "2025-02-07T16:38:06.225078Z", "custom_questions": [{"answer_choices": [], "enabled": true, "include_other": false, "name": "Please share anything that will help prepare for our meeting.", "position": 0, "required": false, "type": "text"}], "deleted_at": null, "description_html": null, "description_plain": null, "duration": 50, "duration_options": null, "internal_note": null, "kind": "solo", "locations": [{"additional_info": null, "kind": "physical", "location": "Main Office"}], "name": "Saturn event", "pooling_type": null, "position": 0, "profile": {"name": "John Doe", "owner": "https://api.calendly.com/users/3ebfdf0t-830j-4567-y5ae-69c58053c772", "type": "User"}, "scheduling_url": "https://calendly.com/d/cqse-m72-ssq/saturn-event", "secret": true, "slug": "sf9c96xn", "type": "AdhocEventType", "updated_at": "2025-02-07T16:38:06.225078Z", "uri": "https://api.calendly.com/event_types/24606510-1wbf-51eh-8c55-nbd1d4909887"}}}{var} |
🧪 Ejemplo de uso
- Listar Tipos de Eventos: Obtener la lista de todos los tipos de eventos disponibles para un usuario específico (ej.
https://api.calendly.com/users/b354...) y guardar el resultado enlistaEventos. - Obtener un Tipo de Evento: Seleccionar un URI de evento de la
listaEventos(ej.https://api.calendly.com/event_types/EBH...) y usarObtener un Tipo de Eventopara conseguir sus detalles completos, almacenándolos endetallesEvento. - Crear una Reunión Única: Utilizar el comando
Crear una Reunión Únicapara programar una nueva reunión puntual, especificando el anfitrión, duración, fechas, ubicación y otros detalles necesarios, y guardar la información de la reunión creada ennuevaReunionInfo.
🧩 Requisitos
- Tener una credencial válida de Calendly configurada en Saturn Studio.
- Para listar o crear eventos, conocer la URI del Usuario o de la Organización correspondiente.
- Para obtener un tipo de evento, se necesita la URI específica del evento.
- Para crear una reunión única, se deben proporcionar todos los parámetros obligatorios como nombre, anfitrión, duración y fechas válidas.