Calendly
En lugar de seguir estos pasos manualmente, puedes usar el Asistente de Credenciales con IA — describe lo que quieres conectar y la IA te guiara paso a paso, adaptado a tu cuenta.
Descripción General
Conecta tu cuenta de Calendly a Nirvai para gestionar agendamiento, eventos y reservas programáticamente.
Métodos de Autenticación Soportados
- Personal Access Token - Recomendado para integraciones personales/de un solo usuario
Requisitos Previos
- Una cuenta de Calendly (gratis o de pago)
- Permisos de propietario o admin de cuenta (para acceso a toda la organización)
Instrucciones de Configuración
Generar un Personal Access Token
- Inicia sesión en tu cuenta de Calendly
- Ve a Integrations & apps en la barra lateral
- Desplázate hasta la sección API & Connectors
- Haz clic en API & Webhooks
- Bajo "Personal Access Tokens", haz clic en Create new token
- Ingresa un nombre para tu token (ej., "Integración Nirvai")
- Selecciona la organización a la que este token debe acceder
- Haz clic en Create token
- Importante: Copia el token inmediatamente - no se mostrará de nuevo
- En Nirvai, crea una nueva credencial de Calendly y pega el token
Ruta Alternativa
También puedes acceder a los tokens directamente en:
https://calendly.com/integrations/api_webhooks
Permisos del Token
Los Personal Access Tokens tienen estas características:
- El acceso está limitado a tu usuario y organización seleccionada
- Acceso de lectura y escritura a datos de agendamiento
- Pueden crear webhooks para notificaciones de eventos
- Los tokens no expiran pero pueden ser revocados
Operaciones de API Disponibles
Con tu token, puedes:
- Gestionar tipos de eventos y disponibilidad
- Listar y ver eventos agendados
- Acceder a datos de usuario y organización
- Crear webhooks para notificaciones en tiempo real
- Gestionar formularios de routing (en planes soportados)
Solución de Problemas
Problemas Comunes
- 401 Unauthorized: El token es inválido o fue revocado. Genera un nuevo token.
- 403 Forbidden: Acción no permitida para tu tipo de cuenta o plan.
- 404 Not Found: El recurso no existe o no tienes acceso.
- Limitaciones de scope: Algunos endpoints requieren planes específicos de Calendly.
Gestionar Tokens
Para ver o revocar tokens existentes:
- Ve a Integrations & apps > API & Webhooks
- Ve todos los tokens activos bajo "Personal Access Tokens"
- Haz clic en el icono de eliminar para revocar un token
Limitaciones por Plan
Algunas características de API requieren planes específicos de Calendly:
| Característica | Plan Requerido |
|---|---|
| Agendamiento básico | Todos los planes |
| Eventos de equipo | Teams o superior |
| Formularios de routing | Professional o superior |
| Round robin | Teams o superior |
Mejores Prácticas de Seguridad
- Usa nombres descriptivos para los tokens para rastrear su propósito
- Revoca tokens que ya no necesites
- Nunca compartas tokens ni los commits a control de versiones
- Considera tokens separados para diferentes integraciones
Recursos Relacionados
Adaptado para la plataforma Nirvai
Siguientes Pasos
Usa el Creador de Herramientas con IA para convertir esta credencial en herramientas usables por el agente. Describe lo que tu agente deberia poder hacer y la IA investiga la API, configura los endpoints y te entrega un toolkit revisable antes de guardar nada.