Para desarrolladores

Integrar Let's Book, de tu web a la API para alquiler de barcos.

Con una etiqueta script y un enlace ya aceptas reservas. Después decides hasta dónde llegar: tus propias páginas, analítica, código, la API, las reglas.

Pon el formulario de reserva en tu web

FácilEmpieza aquí

Qué hace

Añade una etiqueta script al head de tu web. Después, cualquier enlace a la URL del formulario lo abre en una capa sobre tu página. WordPress tiene un plugin. En Wix o Squarespace, pegas la etiqueta en un campo de código propio.

Cuándo lo necesitas

Siempre. Esto es toda la integración. Párate aquí y ya aceptas reservas.

Añadir el formulario de reserva a tu web

index.html
<head>
  <script src="https://cdn.letsbook.app/assets/lb-widgets.min.js" type="module" defer></script>
</head>
<body>
  <a href="https://tu-slug.letsbook.app/es-es/form">Reservar ahora</a>
  <!-- esto es toda la integración -->
</body>

Configura una URL de retorno propia

Fácil

Qué hace

Después de la reserva, el cliente aterriza en tu propia página de agradecimiento en lugar de en nuestra pantalla de confirmación. Su URL la fijas por idioma. Los parámetros de la URL llevan la reserva: referencia, barco, muelle, total, cupón, socio.

Configurar una URL de retorno propia

Cuándo lo necesitas

Una página de agradecimiento con tu propio diseño, con el camino hasta el muelle. Una conversión en una herramienta de analítica que no sea Google Analytics.

Sáltatelo si con Google Analytics te basta. Con una URL de retorno, el formulario no envía el evento purchase automático a Google Analytics.

Deja que Google Analytics vea el proceso de reserva

Fácil

Qué hace

Añade otra etiqueta script antes del script del formulario. Encuentra el GA4 o el Tag Manager que ya está en tu página. Envía el proceso como los eventos estándar de ecommerce, importes incluidos. Una opción de depuración registra cada evento en la consola.

Integración con Google Analytics

Cuándo lo necesitas

El embudo: dónde abandona la gente el pago. Una conversión de Google Ads con el valor real de la reserva. Una agencia que lleva Tag Manager y quiere los datos ahí.

Deja que un socio venda a través del formulario

Fácil

Qué hace

Un socio recibe una URL con su propio código, o incrusta el formulario en su web. Cada reserva que entra por ahí queda marcada con el socio. El panel de control filtra y exporta por socio. Una condición de precio le da su propia tarifa.

Reservas a través de socios

Cuándo lo necesitas

El conserje de un hotel, una web de turismo o un revendedor en otra ciudad con otro precio. Liquidas la comisión a final de mes, con las cifras por socio.

Controla el formulario desde tu propio código

Intermedio

Qué hace

El script deja una variable global en window cuando está listo. Abre, oculta y destruye el formulario desde JavaScript, con las mismas opciones que admite la URL. Escucha los eventos mientras el cliente avanza por él.

Cuándo lo necesitas

Una página de flota con un botón por barco. Una página de ubicación que muestra un solo muelle. Una single-page app. Un área de miembros donde los miembros inician sesión primero. Una herramienta de analítica o de chat que sigue al cliente por el formulario.

Integración web avanzada

flota.js
window.addEventListener('lb-ready', () => {
  for (const button of document.querySelectorAll('[data-boat]')) {
    button.onclick = () => LetsBook.show({
      boatModelId: button.dataset.boat,
      dockId: PUERTO,
    });
  }
});

window.addEventListener('lb-complete', () => {
  // reservado. el confeti lo pones tú.
});

Usa la API para alquiler de barcos, escucha los webhooks

Avanzado

Qué hace

Una API REST con una clave API que creas en el panel de control. Lee reservas, clientes, cupones, disponibilidad, muelles y barcos, y escribe reservas, clientes y cupones. Los webhooks envían eventos firmados a tu URL en el momento en que ocurren. Una clave API puede llegar a varias cuentas de Let's Book. Standard y Pro incluyen la API, sin coste adicional. No hay un entorno de pruebas aparte para la API.

Referencia de la APIGuía de webhooksChangelogEstado

Cuándo lo necesitas

Reservas en un CRM o en tu programa de contabilidad. Un mensaje en Slack con una reserva grande. Una pantalla en el muelle que sigue los viajes. Una sincronización nocturna de lo que cambió. Una integración para varias empresas.

Escribe las reglas con las que reserva un cliente

Avanzado

Qué hace

Una condición de reserva es una expresión por tipo de cliente. Ve la reserva, con cuánta antelación se reserva y lo que el cliente ya tiene por delante. La añades a un tipo de cliente en el panel de control.

Cuándo lo necesitas

Un miembro del club tiene una reserva de fin de semana y una entre semana a la vez. Una reserva para mañana vale hasta las 15:00. Una cuenta de empresa reserva solo entre semana.

Condiciones de reserva personalizadas

tipo de cliente: miembro — condición de reserva
/* una reserva de fin de semana y una entre semana abiertas a la vez,
   salvo que sea para mañana y se reserve antes de las tres */
(future_bookings.count_per_day.weekend <= 1
  and future_bookings.count_per_day.weekday <= 1)
or (booked_ahead.day_count == 1
  and is_before(booking.booked_at, '15:00'))

¿Se ha caído? Mira primero la página de estado.

status.letsbook.app vigila cuatro cosas y muestra su disponibilidad por día, para el último día, la última semana, el último mes y el último trimestre. Cuando algo falla, publicamos ahí lo que sabemos.

Abrir la página de estado

  • APIapi.letsbook.app, los endpoints a los que llama tu integración
  • Core applicationel panel de control y el formulario de reserva
  • Marketing websiteesta web
  • Support centerlas guías y la referencia de la API

¿Atascado en algún paso?

tech@lets-book.com llega a nuestros desarrolladores. Cuéntanos qué estás construyendo, y te decimos con gusto qué paso necesita.