Módulo 7: Calendly y Agendamiento

Conectar Calendly a n8n

Descripción de la cápsula

Conectar Calendly sigue un patrón que ya conoces bien tras los módulos anteriores: obtienes un token del lado de Calendly y lo pegas en n8n. No hay "Sign in with Google" — Calendly usa un token de acceso personal, como hacían Airtable y HubSpot.

Pero esta cápsula tiene un matiz que conviene resolver desde el inicio: en Calendly, hay dos cosas distintas que se pueden "conectar", y se confunden. Está el nodo de Calendly (para consultar datos: tus tipos de evento, tus reservas) y está el trigger de Calendly (para recibir webhooks cuando alguien reserva). Ambos usan la misma credencial, pero hacen cosas opuestas — y como este módulo gira alrededor de los webhooks, conviene tener clara la distinción antes de seguir.

El objetivo: terminar con una credencial de Calendly funcionando y una lectura de prueba de tus tipos de evento.


Lo que vas a aprender

Al terminar esta cápsula serás capaz de:

  • Obtener un token de acceso personal de Calendly
  • Crear la credencial de Calendly en n8n
  • Distinguir el nodo de Calendly del trigger de Calendly
  • Hacer una lectura de prueba de tus tipos de evento
  • Entender qué tipo de cuenta de Calendly necesitas
  • Reconocer las limitaciones del plan gratuito respecto a webhooks

Qué cuenta de Calendly necesitas

Antes del setup, un punto práctico: los webhooks de Calendly — el corazón de este módulo — pueden requerir un plan de pago. El plan gratuito de Calendly te deja usar la herramienta para agendar, pero la capacidad de integraciones por webhook suele estar en los planes de pago.

Recomendación: verifica qué incluye tu plan actual. Si el plan gratuito no permite webhooks, casi todos los planes de pago de Calendly ofrecen un trial — suficiente para hacer todo este módulo. Lo que aprendas funciona igual cuando el negocio pase a un plan de pago real. No te frustres si el gratuito te limita; es una limitación de Calendly, no de tu aprendizaje.

El nodo de Calendly (consultar datos) funciona más ampliamente; es el trigger (webhooks) el que puede pedir plan de pago.


El nodo vs el trigger: la distinción clave

Como pasó con Gmail (Módulo 2) y Slack (Módulo 4), Calendly tiene dos componentes en n8n:

ComponenteQué haceVa...
Calendly (nodo)Consulta datos: lista tus tipos de evento, tus reservas, datos de un invitadoEn medio o al final del workflow
Calendly TriggerDispara un workflow cuando alguien reserva o cancela (webhook)Al inicio del workflow

Ambos usan la misma credencial. La que creas en esta cápsula sirve para los dos.

Para este módulo, el protagonista es el Trigger — porque el módulo trata de reaccionar a reservas. El nodo lo usamos de apoyo (consultar un tipo de evento, traer detalles). Tenlo claro: cuando en la cápsula 04 hablemos de "recibir reservas", es el Trigger; cuando hablemos de "consultar datos", es el nodo.


Paso a paso: obtener el token

Paso A: ir a la configuración de desarrollador

  1. Entra a tu cuenta de Calendly
  2. Ve a la sección de integraciones / API y webhooks / developer (la ubicación exacta puede variar; busca "API" en la configuración)
  3. Genera un Personal Access Token

Paso B: copiar el token

Calendly te muestra el token una vez — cópialo y guárdalo. Como en todas las herramientas del módulo anterior, es una llave: quien lo tenga puede acceder a tus datos de Calendly.

Si el token se filtra, Calendly te permite revocarlo y generar uno nuevo desde la misma sección. Trátalo como contraseña.


Paso a paso: la credencial en n8n

  1. En n8n → CredentialsAdd credential
  2. Busca Calendly
  3. Selecciona la opción de token de acceso (Access Token / API Key)
  4. Pega el Personal Access Token
  5. Nombra la credencial: Calendly - cuenta negocio

Lectura de prueba: tus tipos de evento

Confirmamos que la credencial funciona consultando algo simple.

El workflow

  1. Workflow nuevo → Manual Trigger
  2. Agrega un nodo Calendly
  3. Credential: la que acabas de crear
  4. Elige una operación de consulta — por ejemplo, listar tus Event Types (tipos de evento) o traer los datos de tu usuario

Ejecutar

Click en Test step. Si recibes tus datos (tu usuario, tus tipos de evento) sin error: la conexión funciona.

Si da error de autenticación → revisa que copiaste el token completo y elegiste la credencial correcta. Si una operación específica no está disponible → puede ser una limitación de tu plan; recuerda el punto sobre planes de arriba.


Trampas comunes

Trampa 1: Esperar usar webhooks con el plan gratuito

Qué pasa: Configuras todo, pero el Calendly Trigger no funciona porque tu plan no incluye webhooks.

Cómo evitar: Verifica tu plan antes de empezar el módulo. Si el gratuito no incluye webhooks, usa el trial de un plan de pago. Es una limitación de Calendly conocida.


Trampa 2: Confundir el nodo con el trigger

Qué pasa: Quieres recibir reservas y agregas el nodo de Calendly — pero el nodo solo consulta, no dispara.

Cómo evitar: Para recibir reservas (el caso central del módulo), es el Calendly Trigger. El nodo es para consultar datos.


Trampa 3: No saber dónde está la sección de API

Qué pasa: Buscas el token y no encuentras dónde generarlo.

Cómo evitar: Está en la configuración de la cuenta, bajo "integraciones", "API y webhooks" o "developer" según la versión de la interfaz. Si no lo ves, revisa que tu plan permita acceso a la API.


Trampa 4: Exponer el token

Qué pasa: Pegas el token en un mensaje, repo o screenshot.

Cómo evitar: Trátalo como contraseña. Revócalo y regenéralo si se filtra.


Ejercicio: conecta y consulta

Objetivo: terminar con una credencial de Calendly y una consulta de prueba.

Tu tarea

  1. Verifica qué permite tu plan de Calendly respecto a webhooks (anótalo — lo necesitarás en la cápsula 04)
  2. Genera un Personal Access Token de Calendly
  3. Crea la credencial de Calendly en n8n
  4. Asegúrate de tener al menos un tipo de evento configurado en Calendly (ej. "Llamada de 30 min")
  5. Construye Manual Trigger → Calendly (consulta tus tipos de evento o tu usuario) y verifica que recibes datos

Checklist de éxito:

  • La credencial de Calendly funciona — la consulta de prueba devuelve datos
  • Sabes si tu plan permite webhooks (clave para la cápsula 04)
  • Tienes clara la diferencia entre el nodo Calendly y el Calendly Trigger
  • Tienes al menos un tipo de evento configurado

Resumen y siguiente paso

  • Calendly se conecta con un Personal Access Token que pegas en n8n — el patrón de Airtable y HubSpot
  • Los webhooks de Calendly pueden requerir un plan de pago — verifica tu plan; el trial de un plan de pago sirve para el módulo
  • Calendly tiene dos componentes en n8n: el nodo (consulta datos) y el Calendly Trigger (recibe reservas vía webhook) — misma credencial, usos opuestos
  • Para este módulo, el protagonista es el Trigger — el módulo trata de reaccionar a reservas
  • Una consulta de prueba (tipos de evento) confirma la conexión
  • 4 trampas: esperar webhooks en el plan gratuito, confundir nodo con trigger, no encontrar la sección de API, exponer el token

Antes de avanzar deberías poder:

  • Crear la credencial de Calendly
  • Explicar la diferencia entre el nodo y el trigger
  • Saber si tu plan permite webhooks

Lo que sigue (cápsula 03):

Antes de recibir reservas, hay que entender qué estás recibiendo. La cápsula 03 cubre el modelo de Calendly: la diferencia entre un tipo de evento ("Llamada de 30 min" — la plantilla) y un evento agendado (la reserva concreta de Ana para el martes). Esa distinción es la base de todo el módulo.


Recursos adicionales

  1. Calendly: tokens de acceso personal - Cómo generar el token.
  2. Calendly: planes - Qué incluye cada plan respecto a integraciones y webhooks.
  3. n8n Calendly Trigger Docs - El trigger que usarás en la cápsula 04.

Creado: Mayo 14, 2026 Versión: 1.0