Ir al contenido principal

Integración de Calendly - Guía de configuración

Conecta tu cuenta de Calendly a Goodweek para gestionar enlaces de programación, eventos y disponibilidad directamente desde tu espacio de trabajo de IA.

A
Escrito por Antoine Stempien

Conecta tu cuenta de Calendly a Goodweek para gestionar enlaces de programación, eventos y disponibilidad directamente desde tu espacio de trabajo de IA.

ℹ️ Nota de gobernanza

Goodweek nunca superará los niveles de acceso otorgados al usuario dentro de Calendly, garantizando la alineación con las políticas de gobernanza de tu organización. Los resultados y las funciones disponibles pueden variar según los permisos específicos y el acceso autenticado de cada usuario.

📋 Requisitos previos

Antes de que un usuario pueda ver y conectar la integración de Calendly, el administrador de tu organización debe habilitarla primero desde el Panel de administración de Goodweek, en la pestaña Integraciones.

Configuración del administrador

La integración de Calendly utiliza OAuth 2.0 y no requiere ninguna aprobación a nivel de administrador dentro de Calendly antes de que los usuarios puedan conectarse.

⚠️ Si tu cuenta de Calendly está conectada a Microsoft 365 / Outlook

Si los usuarios de tu organización utilizan Calendly con inicio de sesión único de Microsoft 365 o tienen su calendario de Outlook conectado a Calendly, es posible que vean un aviso de "Aprobación requerida" o "Se requiere el consentimiento del administrador" durante el proceso de conexión. Esto se debe a que Microsoft Entra ID requiere el consentimiento del administrador para los permisos de Microsoft Graph que solicita Calendly (específicamente Calendars.ReadWrite.shared), y no está relacionado con Goodweek ni con Composio.

Para resolver esto, un administrador global de Microsoft 365 debe conceder el consentimiento del administrador a nivel de todo el tenant para la aplicación de Calendly en Microsoft Entra:

  1. Ve al centro de administración de Microsoft Entra en entra.microsoft.com.

  2. Navega a Aplicaciones empresariales → busca "Calendly".

  3. Abre la aplicación de Calendly → Permisos → Conceder consentimiento del administrador para [tu organización].

  4. Asegúrate de que esté seleccionado "Consentimiento en nombre de tu organización" antes de confirmar.

Conexión del usuario

  1. En Goodweek, ve a Integraciones.

  2. Busca Calendly y haz clic en Conectar.

  3. Serás redirigido a Calendly, donde se te pedirá que inicies sesión y autorices el acceso.

  4. Haz clic en Permitir para conceder el acceso y volver a Goodweek.

Notas importantes

  • Cada usuario debe conectar su propia cuenta individualmente.

  • Goodweek solo puede acceder a los tipos de evento, eventos programados y disponibilidad de Calendly que tu cuenta de usuario individual tenga permiso para ver.

  • Si tu organización utiliza Calendly Teams, los datos a nivel de equipo solo son accesibles si tu rol de Calendly incluye los permisos adecuados.

  • Puedes revocar el acceso de Goodweek en cualquier momento desde Calendly → Integraciones → Aplicaciones conectadas → Composio → Eliminar.


Herramientas disponibles

Herramienta

Descripción

Tipo

List Event Types

Enumera todos los tipos de eventos asociados a un usuario u organización específicos en Calendly.

Lectura

Get Event Type

Recupera los detalles de un tipo de evento específico de Calendly por su UUID.

Lectura

Get Event Type Availability

Recupera los horarios de disponibilidad configurados para un tipo de evento específico.

Lectura

List Event Type Available Times

Obtiene los horarios disponibles para un tipo de evento dentro de un rango de tiempo especificado.

Lectura

Create Event Type

Crea un nuevo tipo de evento individual en Calendly.

Escritura

Update Event Type

Actualiza la configuración de un tipo de evento individual existente.

Escritura

List Scheduled Events

Recupera una lista de eventos programados de Calendly para un usuario u organización con filtros opcionales.

Lectura

Get Event

Recupera un evento programado específico de Calendly por su UUID.

Lectura

List Event Invitees

Recupera una lista de invitados para un evento específico con filtros opcionales de estado y correo electrónico.

Lectura

Get Event Invitee

Recupera información detallada sobre un invitado específico de un evento.

Lectura

Create Scheduling Link

Crea un enlace de programación que se puede utilizar para reservar un evento.

Escritura

Create Single Use Scheduling Link

Crea un enlace de programación de un solo uso para un tipo de evento, que caduca después de una reserva.

Escritura

Create Share

Crea un enlace para compartir personalizable y de un solo uso para un tipo de evento de Calendly, con anulaciones de configuración opcionales.

Escritura

Get User

Recupera información detallada de un usuario existente de Calendly.

Lectura

Get User Availability Schedule

Recupera el horario de disponibilidad de un usuario por su UUID.

Lectura

List User Availability Schedules

Recupera todos los horarios de disponibilidad de un usuario específico de Calendly.

Lectura

List User Busy Times

Obtiene los intervalos de tiempo ocupados de un usuario desde calendarios internos y externos durante un máximo de 7 días.

Lectura

Get Organization

Recupera información sobre una organización específica de Calendly.

Lectura

List Organization Memberships

Recupera una lista de membresías de la organización.

Lectura

List Routing Forms

Recupera los formularios de enrutamiento de una organización especificada.

Lectura

List Routing Form Submissions

Enumera todos los envíos asociados a un formulario de enrutamiento específico.

Lectura

Mark Invitee as No-Show

Marca a un invitado como ausente en un evento programado.

Lectura

Cancel Scheduled Event

Cancela un evento programado de Calendly creando un registro de cancelación.

⚠️ Destructivo

Delete Invitee Data

Elimina permanentemente todos los datos de invitados asociados a los correos electrónicos especificados de eventos anteriores de la organización, con fines de privacidad de datos.

⚠️ Destructivo

Casos de uso

  • Consulta tu agenda y tus próximas reuniones. Recupera una lista de tus eventos programados en Calendly y sus invitados directamente desde Goodweek para revisar tu calendario sin cambiar de aplicación.

  • Encuentra horarios disponibles antes de proponer una reunión. Consulta los horarios disponibles para un tipo de evento específico para identificar espacios libres antes de contactar a un cliente o colega para programar una reunión.

  • Genera enlaces de programación bajo demanda. Crea enlaces de programación de un solo uso o estándar para un tipo de evento específico directamente desde una conversación de Goodweek, listos para compartir con un contacto.

  • Revisa los envíos de formularios de enrutamiento. Accede a las respuestas de los formularios de enrutamiento de Calendly para entender cómo se están dirigiendo las solicitudes de reuniones entrantes en tu equipo.


Solución de problemas

"Aprobación requerida" o "Se requiere el consentimiento del administrador" al conectar

Esto se debe a que Microsoft Entra requiere el consentimiento del administrador para los permisos de Microsoft 365 que solicita Calendly. Un administrador global de Microsoft 365 debe conceder el consentimiento como se describe en la sección de configuración del administrador anterior.

La conexión funcionaba antes pero ahora muestra "Aprobación requerida"

Calendly agregó recientemente el permiso de Microsoft Graph Calendars.ReadWrite.shared. Es posible que el administrador deba volver a conceder el consentimiento para incluir este nuevo permiso. Sigue los pasos de la sección de advertencia anterior.

La integración no es visible en Goodweek

Asegúrate de que el administrador de tu organización haya habilitado la integración de Calendly desde el Panel de administración de Goodweek, en la pestaña Integraciones.

Referencias

¿Ha quedado contestada tu pregunta?