Calendly admite webhooks a través de nuestra API abierta, lo que te permite recibir actualizaciones en tiempo real cuando se producen eventos clave en tu cuenta. Utiliza la API v2 para enviar datos de eventos a una URL específica cuando alguien programa o cancela una reunión o envía un formulario de enrutamiento.
Por ejemplo, puedes:
- Desencadena acciones cuando se reserve una nueva reunión
- Actualiza los sistemas cuando se cancele un evento
- Captura datos cuando alguien envíe un formulario de enrutamiento (incluso si no hay evento reservado)
Antes de empezar
- Necesitarás un token de acceso personal o a una aplicación OAuth para la autenticación.
- Asegúrate de que tu endpoint esté listo para recibir y procesar datos de webhook.
- Consulta los casos de uso de la API de Calendly para más ideas y ejemplos.
Tipos de evento Webhook
Calendly admite las siguientes suscripciones a webhook:
- Eventos creados por el invitado: cuando se programa un nuevo evento
- Eventos cancelados por el invitado: cuando se cancela un evento existente
- Envíos de formularios de enrutamiento: cuando alguien envía un formulario de enrutamiento (con o sin reserva)
Crear un webhook
Sigue los pasos que se muestran en nuestro Portal para desarrolladores.
Una vez creada la suscripción de webhook, Calendly envía los datos del evento al endpoint que especifiques. Consulta los datos de muestra en nuestra documentación de carga de Webhook.
Eliminar un webhook
Para eliminar un webhook, visita nuestra guía Eliminar suscripción de webhook.
Prácticas recomendadas
Para desarrolladores:
- Utiliza URL seguras y HTTPS para tus puntos finales de webhook.
- Valida las firmas entrantes de webhook para mayor seguridad.
- Gestiona los reintentos y evita el procesamiento duplicado comprobando los ID de evento.
Para administradores:
- Supervisa quién ha creado suscripciones de webhook.
- Si se elimina de tu organización un usuario que creó webhooks, sus webhooks permanecerán activos hasta que se eliminen manualmente.