Saturn Studio – Calendly

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.

📌 ¿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.

Para obtener la credencial de este módulo, puede ingresar en el siguiente enlace Calendly credencial

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

1. 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 en listaEventos.
2. Obtener un Tipo de Evento: Seleccionar un URI de evento de la listaEventos (ej. https://api.calendly.com/event_types/EBH...) y usar Obtener un Tipo de Evento para conseguir sus detalles completos, almacenándolos en detallesEvento.
3. Crear una Reunión Única: Utilizar el comando Crear una Reunión Única para 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 en nuevaReunionInfo.

🧩 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.