Descripción general de Webhooks
Calendly admite webhooks a través de nuestra API abierta, lo que le permite recibir actualizaciones en tiempo real cuando ocurren eventos clave en su Cuenta. Use la API v2 para enviar datos de Evento a una URL especificada cuando alguien programe o cancele una Reunión, o envíe un formulario de enrutamiento.
Por ejemplo, puede:
- Disparar acciones cuando se reserve una nueva Reunión
- Actualizar sistemas cuando se cancele un Evento
- Capturar datos cuando alguien envía un formulario de enrutamiento (incluso si no se reserva un Evento)
Antes de empezar
- Necesitará acceso a un token de acceso personal o a una aplicación OAuth para la autenticación.
- Asegúrese de que su endpoint esté listo para recibir y procesar los datos del webhook.
- Consulte los Casos de uso de la API de Calendly para obtener más ideas y ejemplos.
Tipos de eventos de webhook
Calendly admite las siguientes suscripciones de webhook:
- Eventos creados por Invitados — cuando se programa un nuevo Evento
- Eventos cancelados por Invitados — 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
Siga los pasos que se muestran en nuestro Portal para desarrolladores.
Una vez que crea una suscripción de webhook, Calendly envía los datos del Evento al endpoint que especifique cuando ocurre nueva actividad.
Para probar su webhook, active un nuevo Evento (como una reserva, cancelación o reprogramación). Los webhooks no se activan por eventos pasados.
Vea datos de ejemplo en nuestra Documentación del payload del webhook. Eliminar un webhook
Para eliminar un webhook, visite nuestra Guía para eliminar la suscripción de webhook.
Buenas prácticas
Para desarrolladores:
- Use URLs seguras HTTPS para sus endpoints de webhook.
- Valide las firmas entrantes de los webhooks para mayor seguridad.
- Gestione reintentos y evite el procesamiento duplicado comprobando los IDs de Evento.
Para administradores:
- Supervise quién ha creado suscripciones de webhook.
- Si se elimina de su organización un Usuario que creó webhooks, sus webhooks permanecen activos hasta que se eliminen manualmente.