> For the complete documentation index, see [llms.txt](https://help.sesami.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.sesami.co/fr/commencer/quickstart.md).

# Démarrage rapide

Ce guide vous fait passer de « installé » à « première réservation » en un minimum d’étapes.

## Ce que vous allez configurer

* **Services** - Produits Shopify représentant des services réservables
* **Ressources** - Membres de l’équipe, salles, équipements ou autres ressources nécessaires à la prestation des services
* **Disponibilités** - Horaires de travail et règles de planification des ressources
* **Intégration à la vitrine** - Boutons de réservation et calendrier sur votre boutique en ligne

{% hint style="info" %}
**Durée estimée** : 15 à 30 minutes pour une configuration de base avec un service et un membre de l’équipe.
{% endhint %}

### Avant de commencer <a href="#before-you-start" id="before-you-start"></a>

Assurez-vous d’avoir :

* **Un accès administrateur** à votre boutique Shopify
* **Une liste des services** que vous souhaitez proposer :
  * Nom du service (par exemple, « Massage de 60 minutes », « Toilettage pour chien »)
  * Durée (par exemple, 30 minutes, 1 heure, 2 heures)
  * Prix
* **Informations sur les ressources**:
  * Noms des membres de l’équipe et leurs horaires de travail
  * Besoins en matière de salle ou d’équipement (le cas échéant)

<figure><img src="https://401080738-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FPOzJuZclHQ9ht21ebfhi%2FScreenshot%202026-05-19%20at%2012.32.43.png?alt=media&amp;token=0af2ba25-c752-4d94-9321-5c521e556175" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### **Ajouter un service à Sesami**

**Vous pouvez créer un service directement dans Sesami ou ajouter un produit existant depuis Shopify.**

#### **- dans Sesami**&#x20;

1. Saisissez un **titre** clair (par exemple, « Coupe de cheveux », « Massage », « Consultation »)

   Optez pour un titre simple : il apparaîtra dans les confirmations de réservation et les calendriers.
2. Ajoutez la **description**
3. Ajoutez **la variante « durée », l’unité,** et le **prix**\
   Créez des variantes comme « 30 minutes », « 1 heure », « 90 minutes »
4. Cliquez pour **créer le service**

<figure><img src="https://401080738-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2Fi8WFIIRFXECjiCk8G2oT%2FScreenshot%202026-05-19%20at%2013.37.41.png?alt=media&amp;token=51871ee8-eaea-4c5d-a8ae-0420dc556a38" alt=""><figcaption></figcaption></figure>

#### **- dans Shopify**

1. Dans l’interface d’administration Shopify, accédez à **Produits > Ajouter un produit**
2. Saisissez un titre de produit clair qui décrit le service, par exemple *Coupe de cheveux*, *Massage*, ou *Consultation*
3. Cliquez sur **Ajouter une variante** et créez la «**variante « Durée »** et ses options, telles que *30 minutes*, *1 heure*, ou *90 minutes*
4. Définissez un prix pour chaque option de durée
5. Cliquez sur **Enregistrer** pour créer le produit

<figure><img src="https://401080738-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FKoVL1Uvm6QHvzAJEzmoD%2FScreenshot%202026-05-19%20at%2013.35.29.png?alt=media&amp;token=25c95196-9a90-4b96-83a1-e8a21369ed4c" alt=""><figcaption></figcaption></figure>

Répétez l’opération pour chaque type de service que vous souhaitez proposer.

{% hint style="success" %}
**Bonne pratique**: utilisez des variantes pour les différentes durées d’un même service. Par exemple, un produit « Massage » avec les variantes « 30 minutes », « 1 heure » et « 90 minutes », plutôt que trois produits distincts.
{% endhint %}
{% endstep %}

{% step %}

### **Créer des ressources et définir leur disponibilité**

Les ressources sont les éléments nécessaires à la prestation de votre service : membres de l’équipe, salles, équipement, etc. Vous allez les créer et définir leur disponibilité.

{% hint style="info" %}
**Remarque**: dans l’interface actuelle de l’interface administrateur Shopify, les ressources sont désignées par « Membres de l’équipe ». Cette appellation deviendra « Ressources » dans une prochaine version.
{% endhint %}

1. Ajoutez le **nom de la ressource** et le **type de ressource**
   * Pour le personnel : ajoutez chaque membre de l’équipe par son nom (par exemple, « Sarah », « Alex », « Jamie »).
   * Pour les salles et l’équipement : ajoutez-les pour l’instant comme des membres de l’équipe (par exemple, « Salle 1 », « Kit caméra A »).
2. Définissez ses **heures de travail** et ajoutez les règles de disponibilité (par exemple, du lundi au vendredi, de 9 h à 17 h).
3. **Cliquez pour créer la ressource**&#x20;

**Exemple de configuration :**

* Membre de l’équipe « Sarah » → Disponible du lundi au vendredi, de 9 h à 17 h
* Salle « Salle de soins 1 » → Disponible du lundi au samedi, de 8 h à 20 h

{% hint style="info" %}
**Bon à savoir :** Ne vous inquiétez pas si vous n’avez pas encore configuré toutes vos ressources. Vous pouvez définir dès maintenant la disponibilité d’une seule ressource, puis créer d’autres ressources ou mettre à jour la disponibilité des ressources existantes ultérieurement dans [**Portail d’administration : Ressources**](https://help.sesami.co/fr/administration/resources.md).
{% endhint %}

<figure><img src="https://401080738-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FrRx0NMMOiOSmrfHMOggl%2FScreenshot%202026-05-19%20at%2017.08.58.png?alt=media&amp;token=53d42e8e-0196-4123-9c44-f93882601844" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Ajouter une réservation à votre boutique en ligne**

Rendez le calendrier de réservation accessible aux clients sur votre boutique en ligne

<figure><img src="https://401080738-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2F3izuy705a4B12sMY4pp8%2FScreenshot%202026-05-22%20at%2011.34.45.png?alt=media&amp;token=1bfc3440-9cf9-4385-b396-c45110428933" alt=""><figcaption></figcaption></figure>

**Intégration d’application au thème (recommandée – thèmes modernes) – La plupart des thèmes Shopify 2.0 prennent en charge les intégrations d’applications.**

{% hint style="info" %}
**Facultatif :** Si vous utilisez un ancien thème Shopify, une boutique sans interface (comme Hydrogen) ou un site web personnalisé, vous pouvez ignorer cette étape et consulter notre documentation destinée aux développeurs [Documentation pour les développeurs](https://sesami.dev/docs/sesami-experience/shopify-integration/intro/) pour obtenir les instructions d’intégration.
{% endhint %}

#### **Étape 1 : activer l’intégration de l’application**

1. Dans le tableau de bord Sesami, cliquez sur **Personnaliser le thème** dans la section **Intégrer l’expérience de réservation** .
2. Cela ouvrira l’éditeur de thème avec le panneau **Intégrations d’applications** (généralement dans la barre latérale gauche ou les paramètres du thème).
3. Repérez le **Application de réservation Sesami** et activez le bouton pour permettre l’intégration de l’application à votre thème.
4. **Enregistrer**

<div><figure><img src="https://401080738-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2F5IZDWEsFIoEA1zsWNOIA%2FScreenshot%202026-05-22%20at%2011.34.56.png?alt=media&amp;token=9e65bd06-2cc0-4e10-8d22-8068100088ce" alt=""><figcaption></figcaption></figure> <figure><img src="https://401080738-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FJaRozYLGOsgaXbP4n4Wv%2FScreenshot%202026-05-22%20at%2012.30.06.png?alt=media&amp;token=40d823c3-e4a9-45e5-b40b-8ebbe9bddb91" alt=""><figcaption></figcaption></figure></div>

#### **Étape 2 : Ajouter au produit**

1. Ensuite, ajoutez le bloc de réservation Sesami à votre modèle de produit en ouvrant un modèle de produit
2. Dans la section **Informations sur le produit** , cliquez sur **Ajouter un bloc** et sélectionnez **Bouton de réservation Sesami**
3. Placez le bloc au-dessus des boutons d’achat
4. **Enregistrer** les modifications apportées à votre thème.

Le widget de réservation s’affichera désormais sur les pages produit de votre boutique, permettant aux clients de sélectionner les horaires disponibles.

<div><figure><img src="https://401080738-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2F9vxmbQjJF6Do7CZirEZn%2FScreenshot%202026-05-22%20at%2011.36.23.png?alt=media&amp;token=fe4f7d85-dc75-4ee1-a6cf-f1ed32b66261" alt=""><figcaption></figcaption></figure> <figure><img src="https://401080738-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FqkGvhl600ImCpipWkDfQ%2FScreenshot%202026-05-22%20at%2012.30.33.png?alt=media&amp;token=48acdafc-5195-4376-b7f5-6c8e41046668" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
**Intégration manuelle (anciens thèmes)**

Pour les anciens thèmes qui ne prennent pas en charge l’intégration d’applications :

1. Dans l’éditeur de thème, ajoutez un bouton ou un lien aux pages produit
2. Créez un lien vers la page du produit où le calendrier Sesami est actif
3. Ou contactez l’assistance pour obtenir de l’aide sur l’intégration à votre thème

Voir : [Configuration de la boutique en ligne Shopify](https://help.sesami.co/fr/apps-integrations/shopify/online-store.md)
{% endhint %}

{% hint style="success" %}
**Conseil**: Ajoutez un lien « Réserver maintenant » dans le menu principal, pointant vers une collection regroupant tous les services réservables.
{% endhint %}
{% endstep %}

{% step %}
**Tester le processus de réservation de bout en bout**

Avant la mise en ligne, testez un processus de réservation complet :

1. **Ouvrez votre boutique** dans une fenêtre de navigation privée (pour voir l’expérience client)
2. **Accédez à la page produit d’un service**
3. **Vérifiez que le calendrier de réservation s’affiche** avec les créneaux horaires disponibles
4. **Sélectionnez une date et une heure**
5. **Ajoutez au panier** et passez à la caisse
6. **Finalisez l’achat** (utilisez le mode test de Shopify ou effectuez une réservation réelle)
7. **Vérifiez que la réservation apparaît** dans Sesami Admin, sous Réservations
8. **Vérifiez sur mobile** - Testez le même processus sur un appareil mobile

**Points à vérifier :**

* Les créneaux horaires disponibles correspondent aux disponibilités de votre ressource
* Le bon fuseau horaire est affiché
* La réservation est attribuée à la bonne ressource
* Les horaires ne se chevauchent pas si vous réservez plusieurs rendez-vous

{% hint style="warning" %}
**Si aucun créneau horaire ne s’affiche**, consultez la section de dépannage ci-dessous.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## Dépannage

<details>

<summary>Le calendrier ne s’affiche pas sur la page produit</summary>

Vérifiez :

1. **L’intégration de l’application Sesami est activée** dans les paramètres du thème
2. **Le produit comporte une balise sesami-service** dans Shopify
3. **Sesami est activé** dans les paramètres de Sesami
4. Vous consultez le **thème publié** (et non une version brouillon/non publiée)
5. **Le service est configuré** dans Sesami et associé au produit

</details>

<details>

<summary>Le service ne fonctionne pas ou affiche des erreurs</summary>

Vérifiez :

1. **Le produit est ajouté en tant que service** dans Sesami
2. **Des ressources sont attribuées** au service
3. **Les ressources requises sont activées** (et non désactivées)
4. **Le format de la variante de durée** est correct (par exemple, « 30 Minutes », « 1 Hour » — sans espaces supplémentaires, en anglais)
5. **« Le produit ne comporte pas d’option Duration » —** La variante de durée doit être rédigée en anglais, sans faute de frappe.

</details>

<details>

<summary>Aucun créneau horaire disponible ne s’affiche</summary>

Le problème le plus courant ! Vérifiez que :

1. **Des ressources sont attribuées** au service (étape 2)
2. **Les disponibilités sont définies** pour les ressources attribuées (étape 2)
3. **La période de réservation** permet les réservations à venir (vérifiez les paramètres avancés)
4. **Aucun blocage** ne couvre toutes les dates disponibles
5. **Les boutons d’achat sont masqués ou supprimés de la page produit**

Voir : [Aucune disponibilité](https://help.sesami.co/fr/commencer/onboarding/troubleshooting/no-availability.md)

</details>

<details>

<summary>Erreur : « Un problème est survenu. Veuillez recharger la page et réessayer »</summary>

Lors de l’utilisation de variantes de durée, le nom de l’option doit être exactement **`Duration`** en anglais, sans faute de frappe, mot supplémentaire, traduction ni espace avant ou après.

Sesami utilise ce mot-clé pour identifier la durée de réservation. S’il est mal configuré, le processus de réservation risque de ne pas fonctionner comme prévu.\
\
*\*La durée peut être traduite ultérieurement.*

<figure><img src="https://401080738-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2Fx6BZKDk5nIQ8cNHvE58z%2FScreenshot%202026-11-13%20at%2013.03.52.png?alt=media&amp;token=6ef86b60-4eed-4c8d-95d3-f0a7db0be081" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Le fuseau horaire semble incorrect</summary>

1. Accédez à **Sesami > Paramètres > Fuseau horaire**
2. Vérifiez que le fuseau horaire de votre boutique correspond à votre emplacement physique
3. Vérifiez que les disponibilités des ressources sont définies dans le bon fuseau horaire
4. Videz le cache du navigateur et faites un essai en mode navigation privée

Voir : [Décalage de fuseau horaire](https://help.sesami.co/fr/commencer/onboarding/troubleshooting/timezone-mismatch.md)

</details>

<details>

<summary>Le comportement au paiement est inattendu</summary>

Si le paiement est ignoré alors que vous vous y attendiez (ou inversement) :

1. Vérifiez si **la réservation instantanée** est activée (le paiement est alors ignoré)
2. Vérifiez les **paramètres des acomptes** (ils peuvent modifier le déroulement du paiement)
3. Vérifiez les **tarifs des produits** (le paiement peut être ignoré pour les produits gratuits)

Voir : [Réservation instantanée](https://help.sesami.co/fr/reservation/booking-features/instant-booking.md) | [Acomptes](https://help.sesami.co/fr/paiements/deposits.md)

</details>

<details>

<summary>La réservation affiche « Attribuée à : personne »</summary>

Cela se produit lorsque des créneaux horaires deviennent indisponibles pendant le paiement :

1. Activez la **période de réservation** dans les paramètres de Sesami
2. Activez la **validation du panier** pour vérifier les disponibilités avant le paiement

Voir : [Dépannage : « Attribuée à personne »](https://help.sesami.co/fr/commencer/onboarding/troubleshooting/troubleshooting-assigned-to-no-one-caused-by-invalid-order.md)

</details>

<details>

<summary>Les clients voient les erreurs « Session expirée » ou « Lien invalide »</summary>

Causes fréquentes :

1. **Liens expirés** - Le client a essayé de modifier ou d'annuler sa réservation après la date limite
2. **Cookies bloqués par le navigateur** - Vérifiez les paramètres du navigateur, en particulier dans Safari
3. **Problèmes de cache** - Videz le cache du navigateur et réessayez

Voir : [Session expirée](https://help.sesami.co/fr/commencer/onboarding/troubleshooting/session-expired.md) | [Cookies dans Safari](https://help.sesami.co/fr/commencer/onboarding/troubleshooting/safari-cookies.md) | [Erreur de lien invalide](https://help.sesami.co/fr/commencer/onboarding/troubleshooting/as-a-customer-why-am-i-seeing-an-invalid-link-error-page.md)

</details>

***

## Étapes suivantes

Une fois les réservations de base opérationnelles, vous pouvez envisager les options suivantes :

* [**Notifications par e-mail**](https://help.sesami.co/fr/notifications/notification-emails.md) - Configurez les e-mails de confirmation et de rappel
* [**Synchronisation avec Google Agenda**](https://help.sesami.co/fr/apps-integrations/google-calendar.md) - Synchronisation bidirectionnelle avec les agendas des membres de l'équipe
* [**Modification des réservations par les clients**](https://help.sesami.co/fr/reservation/booking-features/cancellations-rescheduling.md) - Autorisez les clients à modifier ou à annuler leurs réservations
* [**Rendez-vous de groupe**](https://help.sesami.co/fr/reservation/booking-features/group-appointments.md) - Autorisez plusieurs réservations par créneau horaire
* [**Acomptes**](https://help.sesami.co/fr/paiements/deposits.md) - Encaissez un paiement partiel au moment de la réservation
* [**Point de vente**](https://help.sesami.co/fr/apps-integrations/shopify/pos.md) - Prenez les réservations en personne

***

## Besoin d'aide ?

* [**Appel d’intégration gratuit**](https://help.sesami.co/fr/commencer/onboarding/onboarding-call.md) - Réservez une séance avec notre équipe de réussite client
* [**Service d’installation clé en main**](https://help.sesami.co/fr/commencer/onboarding/white-glove-setup.md) - Bénéficiez de l’aide de professionnels pour l’intégration et la configuration du thème
* [**Services professionnels**](https://help.sesami.co/fr/commencer/onboarding/professional-services.md) - Développement personnalisé pour répondre à des besoins spécifiques
* [**Assistance**](mailto:help@sesami.co) - Écrivez à <help@sesami.co> pour obtenir de l’aide

## Articles connexes

* [Guide des ressources](https://help.sesami.co/fr/administration/resources.md) - Configuration détaillée des ressources
* [Configuration des disponibilités](https://help.sesami.co/fr/reservation/availability/resource-availability.md) - Options avancées de disponibilité
* [Portail d’administration Sesami](https://help.sesami.co/fr/administration/sesami-admin-portal.md) - Présentation de l’interface d’administration
* [Configuration des services](https://help.sesami.co/fr/administration/services.md) - Paramètres avancés des services


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.sesami.co/fr/commencer/quickstart.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
