Saltearse al contenido

Cómo configurar webhooks

Los webhooks envían eventos seleccionados de TicketingHub a otro sistema en cuanto se producen.

Antes de empezar

  • Los webhooks deben estar habilitados para su cuenta de TicketingHub. Póngase en contacto con TicketingHub si no aparece la sección Webhooks.
  • Necesita acceso de administrador o de gerente.
  • El sistema receptor debe proporcionar una URL pública HTTPS.

Añadir un webhook

  1. Vaya a Configuración → Avanzado.
  2. Busque Webhooks y seleccione Editar.
  3. Seleccione Nuevo webhook.
  4. Introduzca la URL HTTPS que recibirá los eventos.
  5. Seleccione los tipos de eventos que desea enviar, como una reserva confirmada o cancelada.
  6. Opcional: introduzca un secreto seguro para que el sistema receptor pueda verificar cada solicitud.
  7. Cree el webhook y, a continuación, realice una de las acciones seleccionadas para probarlo.

Si añade un secreto, TicketingHub firma cada solicitud y envía la firma en el encabezado X-TicketingHub-Signature-256. Su desarrollador debe verificar esta firma antes de aceptar los datos.

Mantener activo el webhook

El sistema receptor debe responder rápidamente con un estado 2xx correcto. TicketingHub reintenta las entregas que agotan el tiempo de espera o devuelven una respuesta incorrecta. Un punto de conexión que continúa fallando se deshabilita automáticamente; corrija el sistema receptor y, a continuación, vuelva a la página Webhooks y habilítelo de nuevo.

TicketingHub solo envía eventos a direcciones públicas. Si la URL apunta a una dirección de red privada, como un servidor dentro de su propia red, TicketingHub no envía el evento y deshabilita el webhook de inmediato. En la página Webhooks aparece «La URL apunta a una dirección de red privada» y los administradores de su cuenta reciben un correo electrónico. Cambie la URL por una dirección HTTPS pública y, a continuación, vuelva a habilitar el webhook.

Elija únicamente los eventos que necesite y evite utilizar una URL de prueba en una cuenta activa. Para enviar eventos a Zapier sin crear su propio receptor, consulte Cómo conectar TicketingHub a Zapier. Para crear una integración que también solicite datos a TicketingHub, consulte Cómo crear y utilizar un token de API.