Guide d'intégration

Intégrez la réservation en ligne sur votre site

Choisissez la méthode qui correspond à vos besoins et compétences techniques.

Quelle option choisir ?

  • Page hébergée — Vous n'avez pas de site web ou souhaitez une solution immédiate
  • Plugin WordPress — Vous avez un site WordPress et souhaitez une intégration native
  • Widget iframe — Vous avez un site et voulez y intégrer le formulaire
  • Bouton flottant — Vous voulez un bouton "Réserver" sur toutes vos pages
  • API publique — Vous êtes développeur et voulez des intégrations personnalisées
  • Téléphonie 3CX — Vous avez un standard 3CX et voulez identifier vos clients au téléphone
Facile · Tout le monde

Page de réservation hébergée

Votre page de réservation est déjà prête. Partagez simplement le lien.

Déjà prêt, rien à faire

Votre page de réservation existe déjà avec une adresse personnalisée (ex: votre-restaurant.couverty.ch/reservation). Vous pouvez la partager immédiatement.

Pourquoi utiliser cette option ?

Aucune configuration

Pas de code à copier, pas de technique

Design automatique

Adapté aux couleurs de votre restaurant

Toujours à jour

Horaires, capacités, fermetures synchronisés

Mobile-friendly

Optimisé pour smartphones et tablettes

Astuce : créer un QR Code

Imprimez un QR Code pour vos supports physiques

Vos clients peuvent scanner le code avec leur smartphone pour accéder directement au formulaire de réservation. Idéal pour : cartes de visite, menus, flyers, affiches en vitrine...

Intermédiaire · Web designers, développeurs

Widget intégré (iframe)

Intégrez le formulaire de réservation directement dans une page de votre site web.

Le widget s'adapte automatiquement à la largeur de votre page et redimensionne sa hauteur selon le contenu. Vous pouvez le placer dans n'importe quelle page de votre site.

Code d'intégration

Copiez ce code et collez-le à l'endroit souhaité :

html
<!-- Widget de Réservation Couverty -->
<div id="couverty-reservation-widget"></div>
<script>
(function() {
  var iframe = document.createElement('iframe');
  iframe.src = 'https://votre-domaine.ch/embed/votre-slug';
  iframe.style.width = '100%';
  iframe.style.minHeight = '200px';
  iframe.style.border = 'none';
  iframe.style.overflow = 'hidden';
  iframe.setAttribute('scrolling', 'no');
  iframe.setAttribute('frameborder', '0');
  iframe.setAttribute('title', 'Formulaire de réservation');

  window.addEventListener('message', function(event) {
    if (event.data && event.data.type === 'widget:resize') {
      iframe.style.height = event.data.height + 'px';
    }
  });

  var container = document.getElementById('couverty-reservation-widget');
  if (container) container.appendChild(iframe);
})();
</script>

Où trouver mon code personnalisé ?

Le code ci-dessus est un exemple. Votre code personnalisé avec votre URL de restaurant est disponible dans les réglages d'intégration.

Installation sur WordPress

  1. 1

    Connectez-vous à WordPress

    Accédez à votre tableau de bord WordPress
  2. 2

    Éditez votre page de réservation

    Créez une nouvelle page ou éditez une page existante
  3. 3

    Ajoutez un bloc HTML personnalisé

    Gutenberg : Cherchez "HTML personnalisé" dans les blocs
    Éditeur classique : Passez en mode "Texte"
  4. 4

    Collez le code et publiez

    Collez le code copié depuis les réglages, puis publiez la page

Autres plateformes

Wix

Ajoutez un élément "Embed HTML" et collez le code

Squarespace

Ajoutez un bloc "Code" et collez le code d'intégration

Webflow

Utilisez l'élément "Embed" pour ajouter du code HTML

HTML simple

Collez le code directement dans votre fichier HTML

Facile · Utilisateurs WordPress

Plugin WordPress

Intégrez menu, boissons, menu du jour et réservation en quelques clics avec notre plugin officiel.

Pourquoi utiliser le plugin ?

Le plugin ajoute des blocs Gutenberg et shortcodes natifs WordPress. Vos données sont récupérées automatiquement via l'API Couverty, avec un cache intégré pour des performances optimales.

Installation

Télécharger le plugin Couverty

Fichier .zip — Compatible WordPress 6.0+ / PHP 7.4+

  1. 1

    Installez le plugin

    Dans WordPress : Extensions → Ajouter → Téléverser une extension → Sélectionnez le .zip
  2. 2

    Activez et configurez

    Activez le plugin puis allez dans le menu Couverty dans la barre latérale
  3. 3

    Connectez votre compte

    Collez votre clé API et cliquez sur "Connecter" — l'identifiant du restaurant et vos données se remplissent automatiquement
  4. 4

    Créez vos pages

    Un bouton crée les pages Carte, Menu du jour, Boissons et Réservation, déjà remplies

Vos pages sont déjà écrites

Pas de page blanche à remplir. Depuis les réglages du plugin, un clic crée les quatre pages de votre site — la carte, le menu du jour, les boissons et la réservation — avec vos vrais plats et vos vrais prix déjà en place, mis en page comme une carte de restaurant.

Page « Notre carte » d'un site WordPress : les plats sont groupés par catégorie, chaque nom est relié à son prix par une ligne pointillée, avec les allergènes et les mentions végétarien ou sans gluten.
La carte, par catégorie
Page « Menu du jour » : chaque jour de la semaine dans son encadré avec entrée, plat, dessert et prix ; le jour en cours est mis en évidence.
Le menu du jour, jour par jour

Exemple de rendu avec le thème par défaut de WordPress. Sur votre site, les pages reprennent vos polices et vos couleurs.

Les pages sont créées en brouillon : vous les relisez avant qu'elles n'apparaissent en ligne. Tout y est modifiable dans l'éditeur WordPress — textes, ordre des sections, mise en page. Ajoutez une image mise en avant pour donner une ouverture à la page.

Blocs et shortcodes disponibles

Menu (carte des plats)

[couverty_menu]

Boissons

[couverty_boissons]

Menu du jour

[couverty_menu_du_jour]

Réservation (widget)

[couverty_reservation]

Chaque bloc est aussi disponible dans l'éditeur Gutenberg avec des options visuelles. Le bouton de réservation flottant se configure directement dans les réglages du plugin.

Intermédiaire · Web designers, développeurs

Bouton flottant

Un bouton 'Réserver' apparaît en bas à droite de toutes les pages de votre site.

Comment ça fonctionne ?

Un bouton discret apparaît en bas à droite de l'écran. Quand un visiteur clique dessus, une fenêtre s'ouvre avec le formulaire de réservation. Le visiteur peut réserver sans quitter votre page.

Code d'intégration

Une seule ligne de code à ajouter sur votre site :

html
<script src="https://votre-domaine.ch/widget-floating.js?slug=votre-slug" async></script>

Installation

Où placer ce code ?

  1. 1

    Copiez le code personnalisé

    Depuis la page des réglages d'intégration

  2. 2

    Collez avant la balise </body>

    Cette balise se trouve à la fin de chaque page HTML

  3. Terminé !

    Le bouton apparaîtra automatiquement sur toutes les pages

Où trouver </body> selon votre plateforme

  • WordPress : Dans le fichier footer.php de votre thème, ou utilisez un plugin comme "Insert Headers and Footers"
  • Wix : Paramètres → Avancé → Code personnalisé → Body - End
  • Squarespace : Paramètres → Avancé → Injection de code → Footer
  • Webflow : Project Settings → Custom Code → Footer Code
Avancé · Restaurants équipés d'un standard 3CX

Téléphonie 3CX

Le nom de votre client s'affiche dans le softphone dès qu'il appelle, et chaque appel manqué crée une notification dans Couverty.

Comment ça fonctionne ?

3CX interroge Couverty à chaque appel avec le numéro de l'appelant. Si ce numéro correspond à un client connu — une réservation passée ou une fiche client — 3CX affiche son nom, et Couverty crée une notification enrichie (visites, couverts, no-shows) consultable dans le tableau de bord et sur mobile. À la fin de l'appel, 3CX renvoie le statut : un appel manqué déclenche une notification dédiée pour que personne ne passe à côté d'un rappel.

Prérequis

  • Une licence 3CX Standard ou supérieure (les intégrations CRM ne sont pas incluses dans l'offre gratuite)
  • Un accès administrateur à la console 3CX
  • Un plan Premium côté Couverty — c'est lui qui débloque les clés API utilisées par l'intégration

Installation

  1. 1

    Générez une clé API

    Depuis les réglages d'intégration, section « API publique ». Copiez la clé immédiatement : elle commence par qr_ et n'est plus affichée ensuite.

  2. 2

    Téléchargez le modèle CRM

    Le fichier XML décrit à 3CX comment interroger Couverty.

    couverty-crm-template.xml
  3. 3

    Importez-le dans 3CX

    Dans la console d'administration : Intégrations → CRM, puis + Ajouter un modèle et sélectionnez le fichier téléchargé.

  4. 4

    Renseignez vos paramètres

    Dans les réglages du modèle importé :

    ApiUrlhttps://app.couverty.ch
    ApiKeyqr_votre_cle_api
    ReportCallEnabledTrue

    ReportCallEnabled pilote les notifications d'appels manqués : passez-le à False pour ne garder que l'identification à l'appel.

Ce que 3CX appelle

Le modèle interroge deux endpoints de l'API publique : un lookup à chaque appel pour identifier le contact, et un rapport en fin d'appel pour le journal et les appels manqués. Vous n'avez rien à coder — leur contrat est détaillé dans la documentation API si vous avez besoin de diagnostiquer un échange.

Le nom du client ne s'affiche pas

Trois causes possibles, dans l'ordre de fréquence : le numéro appelant est masqué ; le client n'a jamais réservé chez vous et n'a pas de fiche client ; il appelle depuis un autre numéro que celui utilisé lors de sa réservation. Les formats suisses courants (+41 79…, 0041…, 079…) sont tous reconnus : un écart de mise en forme n'est jamais la cause.

Erreur d'authentification côté 3CX

Un code 401 signifie que la clé API est absente, mal recopiée ou révoquée ; un 403, que le plan de l'établissement ne donne plus accès à l'API. Regénérez une clé depuis les réglages d'intégration et recollez-la dans le paramètre ApiKey du modèle 3CX.

Besoin de plus de contrôle ?

Consultez notre documentation API complète pour créer des intégrations personnalisées.

Voir la documentation API

Besoin d'aide pour l'intégration ? Contactez notre support