Webhooks Próximamente
Los webhooks todavía no están disponibles para contratar. El código está construido, pero hoy no se anuncian ni se venden; los negocios que ya los usan los conservan. Cuando se abran, irán incluidos en Enterprise.
Un webhook es un aviso que Nexunia envía a tu servidor cuando ocurre algo en tu negocio, para que no tengas que consultar la API cada poco.
Se gestionan en Configuración → Desarrolladores → Webhooks (solo el propietario).
Disponibilidad y precio
- Próximamente. Cuando se abran, irán incluidos en el plan Enterprise.
- Hoy no se venden como extra en ningún plan. Si tu plan no los incluye, la pantalla de Webhooks te lo indica.
Eventos
| Evento | Cuándo |
|---|---|
conversation.created | Entra una conversación nueva, por cualquier canal |
message.received | Un cliente te envía un mensaje |
booking.pending_deposit | Se reserva una hora a la espera de que el cliente pague la seña (todavía no es una reserva) |
booking.created | Se crea una reserva |
booking.cancelled | Se cancela una reserva |
Reservas con seña: mientras el cliente no paga, la hora está retenida pero la
reserva no existe, y recibes booking.pending_deposit con la hora de caducidad
(expires_at). Si paga, llega booking.created con el mismo deposit_id y esa reserva
sustituye al pendiente. Si no paga, el pendiente caduca en expires_at sin más aviso.
Un aviso booking.pending_deposit se ve así:
{
"id": "evt_3c2b9a0e-1d6f-4a77-8e2e-7a4f1d0c9b55",
"type": "booking.pending_deposit",
"api_version": "2026-10-14",
"created_at": "2026-10-14T10:00:00.000Z",
"data": {
"object": "booking_deposit",
"id": "a41f0c52-7b0e-4f43-9a0b-2f4d7c9e1b10",
"status": "PENDING",
"amount_cents": 1500,
"starts_at": "2026-11-02T10:00:00.000Z",
"expires_at": "2026-11-02T09:30:00.000Z"
}
}El id de data es el identificador de la seña. Es el mismo valor que llega como
deposit_id en el booking.created posterior. Este evento solo se envía para citas
de servicio, no para mesas de restaurante. Mira Señas y depósitos.
Los avisos son finos: llevan solo identificadores y estado, nunca datos personales ni el texto de los mensajes. Para ver el detalle, consulta el recurso con la API (cada aviso trae la ruta).
{
"id": "evt_8a1f6b0e-5f0c-4c43-9d0e-1d6f3f2f9b11",
"type": "booking.created",
"api_version": "2026-10-14",
"created_at": "2026-10-14T10:00:00.000Z",
"data": {
"object": "booking",
"id": "5d7c1c0e-9c1e-4f55-8f55-0c1f6a4b2c33",
"status": "CONFIRMED",
"url": "/v1/bookings/5d7c1c0e-9c1e-4f55-8f55-0c1f6a4b2c33"
}
}Añadir un endpoint
- Entra en Configuración → Desarrolladores → Webhooks, en Añadir un endpoint.
- Escribe la URL de tu servidor (https, pública), un nombre opcional y elige los eventos, y pulsa Crear endpoint.
- Antes de guardarla, Nexunia envía un evento de prueba (
webhook.ping) que tu servidor debe responder con un 2xx. - Copia el secreto
whsec_…en ese momento: no se vuelve a mostrar.
Qué tener en cuenta
- Un endpoint solo recibe lo que ocurre después de crearlo.
- Cada endpoint tiene sus botones: Enviar prueba, Pausar y Reactivar, Rotar secreto y Eliminar. Un endpoint pausado no recibe nada y lo ocurrido mientras tanto no se reenvía.
- Los avisos pueden llegar con unos segundos de retraso, repetidos o en
otro orden: usa el
iddel evento para ignorar duplicados. - Máximo 5 endpoints por negocio.
- Sigue con Verificar la firma.