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.
¿Cómo obtener las credenciales? Haz clic aquí
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.