Skip to Content
Webhooks (próximamente)Resumen

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

EventoCuándo
conversation.createdEntra una conversación nueva, por cualquier canal
message.receivedUn cliente te envía un mensaje
booking.pending_depositSe reserva una hora a la espera de que el cliente pague la seña (todavía no es una reserva)
booking.createdSe crea una reserva
booking.cancelledSe 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

  1. Entra en Configuración → Desarrolladores → Webhooks, en Añadir un endpoint.
  2. Escribe la URL de tu servidor (https, pública), un nombre opcional y elige los eventos, y pulsa Crear endpoint.
  3. Antes de guardarla, Nexunia envía un evento de prueba (webhook.ping) que tu servidor debe responder con un 2xx.
  4. 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 id del evento para ignorar duplicados.
  • Máximo 5 endpoints por negocio.
  • Sigue con Verificar la firma.
Last updated on