Pour les développeurs

Intégrer Let's Book, du formulaire à l'API de location de bateaux.

Avec une balise script et un lien, vous prenez des réservations tout de suite. Ensuite, vous décidez jusqu'où aller : vos propres pages, les analytics, le code, l'API, les règles.

Mettre le formulaire de réservation sur votre site

FacileCommencer ici

Ce que ça fait

Ajoutez une balise script dans le head de votre site. Ensuite, tout lien vers l'URL du formulaire ouvre le formulaire en superposition sur votre page. WordPress a une extension. Sur Wix ou Squarespace, vous collez la balise dans un champ de code personnalisé.

Quand vous en avez besoin

Toujours. C'est toute l'intégration. Arrêtez-vous ici, et vous prenez des réservations.

Ajouter le formulaire de réservation à votre site web

index.html
<head>
  <script src="https://cdn.letsbook.app/assets/lb-widgets.min.js" type="module" defer></script>
</head>
<body>
  <a href="https://votre-slug.letsbook.app/fr-fr/form">Réserver maintenant</a>
  <!-- c'est toute l'intégration -->
</body>

Définir une URL de retour personnalisée

Facile

Ce que ça fait

Après la réservation, le client arrive sur votre propre page de remerciement au lieu de notre écran de confirmation. Vous définissez son URL par langue. La chaîne de requête transporte la réservation : référence, bateau, quai, total, code de réduction, partenaire.

Définir une URL de retour personnalisée

Quand vous en avez besoin

Une page de remerciement à votre design, avec l'itinéraire jusqu'au quai. Une conversion dans un outil d'analyse autre que Google Analytics.

Passez cette étape si Google Analytics vous suffit. Avec une URL de retour, le formulaire n'envoie pas l'événement purchase automatique à Google Analytics.

Laisser Google Analytics voir le parcours de réservation

Facile

Ce que ça fait

Ajoutez une balise script de plus, avant le script du formulaire. Elle trouve le GA4 ou le Tag Manager déjà présent sur votre page. Elle envoie le parcours sous forme d'événements e-commerce standard, montants compris. Un indicateur de débogage journalise chaque événement dans la console.

Intégration Google Analytics

Quand vous en avez besoin

L'entonnoir : où les gens abandonnent le parcours de réservation. Une conversion Google Ads avec la vraie valeur de la réservation. Une agence qui gère Tag Manager et veut les données là-bas.

Laisser un partenaire vendre par le formulaire

Facile

Ce que ça fait

Un partenaire reçoit une URL avec son propre code, ou intègre le formulaire sur son site. Chaque réservation qui passe par là est marquée au nom du partenaire. Le tableau de bord filtre et exporte par partenaire. Une condition de prix lui donne son propre tarif.

Réservations via des partenaires

Quand vous en avez besoin

Un concierge d'hôtel, un site touristique ou un revendeur dans une autre ville avec un autre prix. Vous réglez la commission à la fin du mois, avec les chiffres par partenaire.

Piloter le formulaire depuis votre propre code

Intermédiaire

Ce que ça fait

Le script place une variable globale sur window quand il est prêt. Ouvrez, masquez et détruisez le formulaire depuis JavaScript, avec les mêmes paramètres que l'URL. Écoutez les événements pendant que le client avance dedans.

Quand vous en avez besoin

Une page de flotte avec un bouton par bateau. Une page de site qui montre un seul quai. Une application monopage. Un espace membres où les membres se connectent d'abord. Un outil d'analyse ou de chat qui suit le client dans le formulaire.

Intégration avancée du site web

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

window.addEventListener('lb-complete', () => {
  // réservé. les confettis, c'est vous qui voyez.
});

Parler à l'API de location de bateaux, écouter les webhooks

Avancé

Ce que ça fait

Une API REST avec une clé API que vous créez dans le tableau de bord. Elle lit les réservations, les clients, les codes de réduction, les disponibilités, les quais et les bateaux, et elle écrit les réservations, les clients et les codes de réduction. Les webhooks envoient des événements signés à votre URL au moment où ils se produisent. Une clé API peut atteindre plusieurs comptes Let's Book. Standard et Pro incluent tous deux l'API, sans supplément. Il n'y a pas d'environnement de test séparé pour l'API.

Référence de l'APIGuide des webhooksJournal des modificationsStatut

Quand vous en avez besoin

Les réservations dans un CRM ou votre logiciel de comptabilité. Un message Slack pour une grosse réservation. Un écran au quai qui suit les sorties. Une synchronisation nocturne de ce qui a changé. Une intégration pour plusieurs entreprises.

Écrire les règles selon lesquelles un client réserve

Avancé

Ce que ça fait

Une condition de réservation est une expression par type de client. Elle voit la réservation, combien de temps à l'avance elle est faite, et ce que le client a déjà à venir. Vous l'ajoutez à un type de client dans le tableau de bord.

Quand vous en avez besoin

Un membre du club a une réservation de week-end et une réservation de semaine à la fois. Une réservation pour le lendemain reste possible jusqu'à 15 h. Un compte entreprise réserve en semaine seulement.

Conditions de réservation personnalisées

type de client : membre — condition de réservation
/* une réservation de week-end et une de semaine ouvertes à la fois,
   sauf si c'est pour demain et réservé avant 15 h */
(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'))

Une panne ? Regardez d'abord la page de statut.

status.letsbook.app surveille quatre choses et montre leur disponibilité par jour, pour le dernier jour, la dernière semaine, le dernier mois et le dernier trimestre. Quand quelque chose ne va pas, nous publions ce que nous savons sur cette page.

Ouvrir la page de statut

  • APIapi.letsbook.app, les endpoints que votre intégration appelle
  • Core applicationle tableau de bord et le formulaire de réservation
  • Marketing websitece site
  • Support centerles guides et la référence de l'API

Bloqué quelque part ?

tech@lets-book.com arrive chez nos développeurs. Dites-nous ce que vous construisez, et nous vous dirons volontiers quelle étape il vous faut.