> 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é** - 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" %}
**Estimation du temps**: 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 :

* **Accès administrateur** dans votre boutique Shopify
* **Une liste de services** que vous souhaitez proposer :
  * Nom du service (p. ex. « Massage de 60 minutes », « Toilettage pour chien »)
  * Durée (p. ex. 30 minutes, 1 heure, 2 heures)
  * Prix
* **Informations sur les ressources**:
  * Noms des membres de l'équipe et leurs horaires de travail
  * Exigences relatives aux salles ou équipements (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 le 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** (p. ex. « Coupe de cheveux », « Massage », « Consultation »)

   Gardez le titre simple — il apparaît 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 votre interface administrateur Shopify, allez dans **Produits > Ajouter un produit**
2. Saisissez un titre de produit clair décrivant le service, tel que *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 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 seul produit « Massage » avec les variantes « 30 minutes », « 1 heure » et « 90 minutes » plutôt que trois produits séparés.
{% endhint %}
{% endstep %}

{% step %}

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

Les ressources sont ce dont votre service a besoin pour avoir lieu — membres de l'équipe, salles, équipements, etc. Vous allez les créer et définir leur disponibilité.

{% hint style="info" %}
**Remarque**: Dans l'interface administrateur Shopify actuelle, les ressources sont nommées « Membres de l'équipe ». Cela sera mis à jour en « Ressources » dans une prochaine version.
{% endhint %}

1. Ajoutez la **Ressource** nom et le **type de ressource**
   * Pour le personnel : ajoutez chaque membre de l'équipe par son nom (p. ex. « Sarah », « Alex », « Jamie »)
   * Pour les salles/équipements : ajoutez-les pour l'instant comme membres de l'équipe (p. ex. « Salle 1 », « Kit caméra A »)
2. Définissez ses **horaires de travail** et ajoutez les règles de disponibilité (p. ex. 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 la disponibilité d'une seule ressource maintenant, puis créer d'autres ressources ou mettre à jour la disponibilité des ressources existantes plus tard dans [**Portail d'administration : Ressources**](/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 vitrine**

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 de l'application au thème (recommandé - thèmes modernes) - La plupart des thèmes Shopify 2.0 prennent en charge les intégrations d'application**

{% hint style="info" %}
**Facultatif :** Si vous utilisez un thème Shopify plus ancien, une vitrine headless (comme Hydrogen) ou un site web personnalisé, vous pouvez ignorer cette étape et consulter nos [docs de développement](https://sesami.dev/docs/sesami-experience/shopify-integration/intro/) pour les instructions d'intégration.
{% endhint %}

#### **Étape 1 : Activer l'intégration de l'application**

1. Depuis le tableau de bord Sesami, cliquez sur **Personnaliser le thème** dans la **Intégrer l'expérience de réservation** section.
2. Cela ouvrira l'éditeur de thème avec le **Intégrations d'application** panneau (généralement dans la barre latérale gauche ou les paramètres du thème)
3. Repérez **l'application de réservation Sesami** et activez le bouton bascule pour permettre l'intégration de l'application dans 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 **Informations sur le produit** section, cliquez sur **Ajouter un bloc** et sélectionnez le **bouton de réservation Sesami**
3. Placez le bloc au-dessus des boutons d'achat
4. **Enregistrer** les modifications de votre thème.

Le widget de réservation apparaîtra désormais sur les pages produit de votre vitrine, permettant aux clients de sélectionner les créneaux de réservation 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 ne prenant pas en charge les intégrations d'application :

1. Dans votre éditeur de thème, ajoutez un bouton ou un lien aux pages produit
2. Liez la page produit avec le calendrier Sesami actif
3. Ou contactez le support pour obtenir de l'aide spécifique à votre thème

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

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

{% step %}
**Tester de bout en bout**

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

1. **Ouvrez votre boutique** dans une fenêtre de navigation privée/incognito (pour voir la vue client)
2. **Accédez à une page produit de service**
3. **Vérifiez que le calendrier de réservation apparaît** avec des créneaux horaires disponibles
4. **Sélectionnez une date et une heure**
5. **Ajouter au panier** et poursuivez jusqu'au passage en caisse
6. **Finalisez l'achat** (utilisez le mode test de Shopify ou effectuez une vraie réservation)
7. **Vérifiez que la réservation apparaît** dans l'admin Sesami sous Réservations
8. **Vérifiez sur mobile** - Testez le même parcours sur un appareil mobile

**À vérifier :**

* Les créneaux horaires disponibles correspondent à la disponibilité de vos ressources
* Le bon fuseau horaire s'affiche
* La réservation apparaît affectée à la ressource correcte
* Les horaires ne se chevauchent pas si vous réservez plusieurs rendez-vous

{% hint style="warning" %}
**Si aucun créneau horaire n'apparaît**, consultez la section de dépannage ci-dessous.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## Dépannage

<details>

<summary>Le calendrier n'apparaît 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 possède une étiquette 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 avec le produit lié

</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. **Les ressources sont attribuées** au service
3. **Les ressources requises sont activées** (non désactivées)
4. **Format de la variante de durée** est correct (p. ex. « 30 minutes », « 1 heure » - sans espaces supplémentaires, en anglais)
5. **« Le produit n'a pas d'option de durée » -** La variante de durée doit être écrite en anglais, sans fautes de frappe.

</details>

<details>

<summary>Aucun créneau horaire disponible n'apparaît</summary>

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

1. **Les ressources sont attribuées** au service (étape 2)
2. **La disponibilité est définie** pour les ressources attribuées (étape 2)
3. **La fenêtre de réservation** autorise les réservations futures (vérifiez les paramètres avancés)
4. **Aucune indisponibilité** ne couvre toutes les dates disponibles
5. **Les boutons d'achat sont masqués ou supprimés sur la page produit**

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

</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 la disponibilité des ressources est définie dans le bon fuseau horaire
4. Videz le cache du navigateur et testez en mode incognito

Voir : [Incompatibilité de fuseau horaire](/fr/commencer/onboarding/troubleshooting/timezone-mismatch.md)

</details>

<details>

<summary>Le comportement au passage en caisse est inattendu</summary>

Si le passage en caisse est ignoré alors que vous l'attendiez (ou vice versa) :

1. Vérifiez si **Réservation instantanée** est activée (ignore le passage en caisse)
2. Vérifiez **les paramètres d'acompte** (peut modifier le parcours de paiement)
3. Vérifiez le produit **tarification** (les produits gratuits peuvent ignorer le passage en caisse)

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

</details>

<details>

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

Cela se produit lorsque des créneaux deviennent indisponibles pendant le passage en caisse :

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

Voir : [Dépannage : Affecté à personne](/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 courantes :

1. **Liens expirés** - Le client a tenté de reprogrammer/annuler après la date limite
2. **Cookies du navigateur bloqués** - Vérifiez les paramètres du navigateur, en particulier Safari
3. **Problèmes de cache** - Videz le cache du navigateur et réessayez

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

</details>

***

## Étapes suivantes

Une fois que les réservations de base fonctionnent, envisagez :

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

***

## Besoin d'aide ?

* [**Appel d'intégration gratuit**](/fr/commencer/onboarding/onboarding-call.md) - Réservez une session avec notre équipe Customer Success
* [**Service de configuration premium**](/fr/commencer/onboarding/white-glove-setup.md) - Obtenez une assistance professionnelle pour l'intégration et la configuration du thème
* [**Services professionnels**](/fr/commencer/onboarding/professional-services.md) - Développement personnalisé pour des besoins spécifiques
* [**Assistance**](mailto:help@sesami.co) - Envoyez un e-mail à <help@sesami.co> pour obtenir de l'aide

## Ressources associées

* [Guide des ressources](/fr/administration/resources.md) - Configuration détaillée des ressources
* [Configuration de la disponibilité](/fr/reservation/availability/resource-availability.md) - Options avancées de disponibilité
* [Portail d'administration Sesami](/fr/administration/sesami-admin-portal.md) - Aperçu de l'interface d'administration
* [Configuration des services](/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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.