API de reservas de citas y webhooks de calendario
Meetz no te obliga a mirar el panel para enterarte de nada. Registra una URL y recibirás cada reserva, reprogramación y cancelación en el momento; con la clave de organización, además, puedes consultar Meetz desde tu propio código.
Tres eventos
booking.created, booking.rescheduled y booking.cancelled. Eliges cuáles quiere cada webhook y puedes tener varios apuntando a sistemas distintos.
Firmados y con reintentos
Cada aviso llega firmado con HMAC-SHA256 y el secreto de tu webhook. Si tu servidor no responde, Meetz reintenta con esperas crecientes y deja constancia de cada intento.
Logs y prueba desde el panel
Desde Integraciones ves las entregas de cada webhook con su estado y código HTTP, y lanzas un evento de prueba antes de conectar nada real.
Qué lleva cada aviso
El cuerpo incluye el identificador de la reserva, nombre, email, teléfono y zona horaria del lead, el tipo de evento, el calendario, el closer con su email, inicio y fin, los parámetros de seguimiento del enlace y las respuestas del formulario con la pregunta como clave. En reprogramaciones van la hora anterior, la nueva y el enlace de la videollamada; en cancelaciones, el motivo. Todos indican el origen del cambio: enlace del lead, panel o Google Calendar.
Verificar la firma
Cada petición trae las cabeceras X-Meetz-Event, X-Meetz-Timestamp y X-Meetz-Signature. La firma es el HMAC-SHA256 del cuerpo, tal cual llega, con el secreto que te dio Meetz al crear el webhook. Compárala con la tuya antes de procesar nada y descarta lo que no cuadre. La URL debe ser pública: Meetz no acepta direcciones internas ni sigue redirecciones.
La API con tu clave
Con la cabecera X-API-Key puedes comprobar la conexión, listar tus calendarios activos con su enlace de reserva ya montado, buscar las citas confirmadas de un teléfono y registrar o borrar webhooks sin pasar por el panel. La disponibilidad y la creación de reservas salen por los mismos endpoints que usa la página pública de Meetz. El límite es de 600 peticiones por minuto y clave.
Preguntas frecuentes
Ambos en Integraciones. La clave de organización se puede regenerar, y cada webhook muestra su secreto para copiarlo.
Sí. En Integraciones tienes un panel con los endpoints, ejemplos con curl y el código para verificar la firma.
Hasta tres intentos: el segundo a los cinco segundos y el tercero medio minuto después. Cada uno queda en el registro de entregas.
Deja de repartir leads a mano
Conecta tu Google Calendar, añade a tus closers y empieza a recibir reservas el mismo día. Gratis para empezar.
sin tarjeta · Google Calendar en 1 clic