Configuración de webhooks Growth+This feature requires the Growth+ plan or higher
Los webhooks permiten que aplicaciones externas reciban notificaciones en tiempo real cuando algo sucede en su cuenta de EquipDash. En lugar de consultar la API repetidamente, su aplicación recibe una solicitud HTTP POST instantánea cada vez que ocurre un evento seleccionado.
Crear un endpoint de webhook
- Haga clic en Configuración en la barra lateral.
- Seleccione API e integraciones en el menú de configuración.
- Haga clic en la pestaña Webhooks.
- Haga clic en + Crear webhook.
- Complete lo siguiente:
- Nombre -- una etiqueta descriptiva (por ejemplo, "Sincronización contable", "Notificaciones de Slack").
- URL -- la URL del endpoint al que EquipDash debe enviar los datos del webhook (debe ser HTTPS).
- Eventos -- seleccione qué eventos deben activar este webhook (consulte la tabla de eventos a continuación).
- Activo -- active esta opción para empezar a recibir eventos de inmediato.
- Haga clic en Crear.

Secreto del webhook
Después de crear un webhook, EquipDash genera un secreto del webhook. Este secreto se usa para verificar que las solicitudes entrantes realmente provienen de EquipDash.
- Copie el secreto de inmediato y guárdelo de forma segura.
- Use el secreto para validar el encabezado
X-Webhook-Signatureen las solicitudes entrantes.
El secreto del webhook se muestra solo una vez, al crear el webhook. Si lo pierde, puede regenerarlo desde la página de detalles del webhook, pero deberá actualizar su aplicación con el nuevo secreto.
Eventos de webhook disponibles
Reservas
| Evento | Se activa cuando |
|---|---|
booking.created | Se crea una nueva reserva |
booking.updated | Se modifica una reserva |
booking.cancelled | Se cancela una reserva |
booking.completed | Una reserva se marca como completada |
Pagos
| Evento | Se activa cuando |
|---|---|
payment.received | Se registra un pago |
payment.refunded | Se procesa un reembolso |
Clientes
| Evento | Se activa cuando |
|---|---|
customer.created | Se agrega un nuevo cliente |
customer.updated | Se modifica el registro de un cliente |
customer.deleted | Se elimina un cliente |
Productos
| Evento | Se activa cuando |
|---|---|
product.created | Se agrega un nuevo producto |
product.updated | Se modifica un producto |
product.archived | Se archiva un producto |
Experiencias
| Evento | Se activa cuando |
|---|---|
experience.created | Se agrega una nueva experiencia |
experience.updated | Se modifica una experiencia |
experience.archived | Se archiva una experiencia |
Formularios
| Evento | Se activa cuando |
|---|---|
form_response.submitted | Un cliente envía un formulario o exención de responsabilidad |
Vales
| Evento | Se activa cuando |
|---|---|
voucher.sold | Se compra un vale o tarjeta de regalo |
voucher.redeemed | Se usa un vale en una reserva |
Administrar webhooks
Desde la pestaña Webhooks, puede:
- Editar un webhook para cambiar su nombre, URL o los eventos seleccionados.
- Pausar un webhook desactivándolo. Mientras esté pausado, no se enviarán eventos.
- Regenerar secreto si el secreto de su webhook ha sido comprometido.
- Eliminar un webhook para quitarlo permanentemente.
Verificar las firmas de los webhooks
Cada solicitud de webhook incluye un encabezado X-Webhook-Signature. Para verificar que la solicitud es auténtica:
- Calcule un hash HMAC-SHA256 del cuerpo de la solicitud usando su secreto de webhook.
- Compare el hash calculado con el valor del encabezado
X-Webhook-Signature. - Si coinciden, la solicitud es auténtica.
Esto evita que atacantes envíen eventos de webhook falsos a su endpoint.