Webhooks: envía eventos a tus otros sistemas

Qué es un webhook

Un webhook es un mensaje automático que elastudio envía a una dirección tuya en el momento en que pasa algo: un nuevo alumno, una reserva, un pago, un check-in. Tu desarrollador, o una herramienta como Make, n8n o el paso de webhook de Zapier, lo recibe y hace el resto, por ejemplo agregar al alumno a tu CRM o una fila a una hoja de cálculo.

Quién puede usarlo

• Los webhooks vienen con el plan Pro.
• En Growth puedes agregarlos como complemento por US$21.90 al mes, o US$219 al año con un plan anual, cobrado junto con el plan. El propietario lo agrega en Configuración, Plan y uso, pestaña Complementos. Consulta Complementos de tu plan de elastudio.
• El propietario y los administradores abren la página. Solo el propietario agrega o quita el complemento.

Nota: Si tu estudio ya usaba elastudio antes del 27 de octubre de 2026, los webhooks empiezan apagados. El propietario o un administrador los activa en Configuración, Herramientas, Funciones: activa Webhooks salientes.

Agregar un endpoint

Un endpoint es la dirección que recibe los eventos.

1. Abre Configuración y elige Webhooks, en Desarrolladores. Elige Agregar endpoint.
2. En Dirección del endpoint, pega la dirección que recibe los eventos. Tiene que empezar con https:// y ser pública en internet: se rechazan las direcciones de una red privada, una dirección IP, un nombre local u otro puerto.
3. En Eventos que se envían, marca los eventos que quieras, o Todos los eventos. Una Nota (opcional) te ayuda a recordar quién lo recibe.
4. Elige Agregar endpoint. Aparece tu Clave de firma: cópiala ahora en el sistema que recibe y elige Ya la copié. Solo se muestra esta vez.
5. Elige Enviar prueba. Tu sistema debería recibir un evento webhook.test y responder con un estado 2xx.

Puedes tener hasta 10 endpoints. Cada uno tiene Editar, Desactivar o Activar, Eliminar y Registro de entregas.

Los eventos

Evento	Nombre en la administración	Se envía cuando
member.created	Nuevo alumno	se crea un perfil de alumno (por el alumno, en recepción o con una importación)
member.updated	Alumno actualizado	cambia el perfil de un alumno
booking.created	Reserva hecha	un alumno tiene un lugar confirmado en una clase (después del pago, o desde la lista de espera)
booking.cancelled	Reserva cancelada	el alumno o el estudio cancela una reserva de clase
checkin.created	Check-in	un alumno queda marcado como presente en una clase, o hace check-in en un evento
order.paid	Venta pagada	una venta se paga por completo, en línea o en recepción
order.refunded	Reembolso	se devuelve dinero de un pedido, todo o una parte
membership.started	Membresía iniciada	empieza una membresía
membership.renewed	Membresía renovada	una membresía se paga por otro período
membership.paused	Membresía en pausa	se programa una pausa de la membresía
membership.ended	Membresía terminada	una membresía se cancela o vence
event_ticket.sold	Entrada vendida	se pagan entradas de un evento
appointment.confirmed	Sesión privada confirmada	se confirma una clase privada

Cada evento lleva los ids y solo los pocos campos que necesita. Los eventos de alumno llevan el nombre, el correo y el idioma; los demás llevan ids (alumno, clase, pedido, membresía). elastudio nunca envía datos de tarjeta, teléfonos, direcciones, fechas de nacimiento, números de identificación fiscal, información de salud ni notas.

La firma, en palabras simples

Cualquiera que conozca la dirección de tu endpoint podría enviarle un mensaje falso. La clave de firma lo impide. elastudio firma cada entrega con ella, como un sello de cera en una carta, y tu sistema revisa el sello antes de confiar en el mensaje. Solo elastudio y tu sistema conocen la clave.

Si la clave pudo filtrarse, elige Cambiar la clave. Recibes una nueva al instante; durante 24 horas cada entrega se firma con las dos, para que tengas tiempo de actualizar tu sistema.

Si tu sistema no responde

Tu sistema tiene 10 segundos para responder con un estado 2xx. Si no, elastudio vuelve a intentarlo después de 1 minuto, 5 minutos, 30 minutos, 2 horas, 6 horas, 12 horas y 24 horas: 8 intentos en unos 2 días.

Si nada llega durante 3 días, elastudio desactiva el endpoint y le escribe al propietario del estudio. Antes de eso, el endpoint aparece Con fallas. Corrige el sistema, elige Activar y envía una prueba. Las pruebas no cuentan para la desactivación.

El registro de entregas

Elige Registro de entregas en un endpoint para ver los últimos 30 días, primero los más recientes: cada evento, si quedó Entregada, En espera o Fallida, cuántos intentos, la respuesta que dio tu sistema (el estado y el comienzo del mensaje) y cuándo es el próximo intento. Reenviar lo envía de nuevo con el mismo id. elastudio guarda la respuesta, nunca lo que envió.

Si cambias de plan

En un plan sin webhooks, o cuando termina el complemento, no se envía nada más, y no se guarda nada para enviar después. Tus endpoints y su registro se quedan, y puedes desactivarlos o eliminarlos. Antes de que termine el complemento o un plan con webhooks, la página Webhooks muestra Los webhooks se detienen el con la fecha, y el propietario recibe un correo.

Para desarrolladores

Cada entrega es un POST con un cuerpo JSON:

{
  "id": "8b0c6c1e-...",
  "type": "order.paid",
  "createdAt": "2026-10-27T12:00:00.000Z",
  "studioId": "e1a00000-...",
  "apiVersion": "2026-10-27",
  "data": { "object": { "object": "order", "id": "...", "memberId": "...", "total": { "amount": 7000, "currency": "USD" }, "method": "card", "complimentary": false } }
}

• Los montos están en centavos (7000 es 70.00). Las horas están en ISO 8601 en UTC; las fechas son las fechas locales del estudio.
• Encabezados: webhook-id (el mismo en todos los intentos de una entrega), webhook-timestamp (en segundos) y webhook-signature.
• La firma es v1, seguida del HMAC-SHA256 en base64 de webhook-id.webhook-timestamp.cuerpo, usando como clave la parte de tu clave que va después de whsec_, decodificada de base64. Durante un cambio de clave el encabezado trae dos firmas separadas por un espacio; acepta cualquiera.
• Es el formato Standard Webhooks, así que sus bibliotecas gratuitas lo revisan por ti.
• Rechaza un timestamp con más de 5 minutos y omite un webhook-id que ya procesaste.
• Las redirecciones nunca se siguen.