# Démarrage rapide

## Ce que vous allez configurer

* **Services** - Produits Shopify représentant les services réservables
* **Ressources** - Membres de l’équipe, salles, équipements ou autres actifs nécessaires pour fournir les services
* **Disponibilité** - Horaires de travail et règles de planification pour les 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

Assurez-vous d’avoir :

* **Accès administrateur** dans votre boutique Shopify
* **Une liste de services** que vous souhaitez proposer avec :
  * Nom du service (par ex., « Massage de 60 minutes », « Toilettage pour chien »)
  * Durée (par ex., 30 minutes, 1 heure, 2 heures)
  * Prix
  * Capacité (nombre de réservations simultanées, le cas échéant)
* **Informations sur les ressources**:
  * Noms des membres de l’équipe et leurs horaires de travail
  * Exigences en matière de salle ou d’équipement (le cas échéant)

***

{% embed url="<https://www.youtube.com/watch?v=U5GpIwIovyg>" %}

***

{% stepper %}
{% step %}
**Créer des produits de service dans Shopify**

Créez un produit Shopify pour chaque service réservable :

1. Dans l’interface d’administration Shopify, allez à **Produits > Ajouter un produit**
2. Saisissez un **titre de produit** clair, sans durée (par ex., « Coupe de cheveux », « Massage », « Consultation »)
   * Gardez le titre simple — il apparaît dans les confirmations de réservation et les calendriers
3. Ajoutez **des variantes pour différentes durées**:
   * Cliquez sur **Ajouter une variante**
   * Créez des variantes comme « 30 minutes », « 1 heure », « 90 minutes »
   * Définissez le prix pour chaque variante de durée
4. Ajoutez une description, des images et d’autres détails du produit selon les besoins
5. **Enregistrez** le produit

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

{% hint style="success" %}
**Bonne pratique**: Utilisez des variantes pour 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 » au lieu de trois produits distincts.
{% 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 actuelle de l’administration Shopify, les ressources sont intitulées « Membres de l’équipe ». Cela sera remplacé par « Ressources » dans une prochaine version.
{% endhint %}

1. Ouvrez **Sesami** dans votre interface d’administration Shopify
2. Accédez à **Membres de l’équipe** (Ressources)
3. Cliquez sur **Ajouter un membre de l’équipe** et créez vos ressources :
   * Pour le personnel : ajoutez chaque membre de l’équipe par son nom (par ex., « Sarah », « Alex », « Jamie »)
   * Pour les salles/équipements : ajoutez-les pour l’instant en tant que membres de l’équipe (par ex., « Salle 1 », « Kit caméra A »)
4. Pour chaque ressource, définissez sa **disponibilité**:
   * Cliquez sur le nom de la ressource
   * Accédez à l’ **Disponibilité** onglet
   * Ajoutez des règles de disponibilité (par ex., du lundi au vendredi, de 9 h à 17 h)
   * **Enregistrez** l’horaire

**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

Voir : [Guide des ressources](https://help.sesami.co/fr/administration/resources) | [Configuration de la disponibilité](https://help.sesami.co/fr/reservation/availability/resource-availability)
{% endstep %}

{% step %}
**Associer les services aux ressources**

Indiquez à Sesami quelles ressources sont nécessaires pour chaque service :

1. Ouvrez **Sesami** dans votre interface d’administration Shopify
2. Accédez à **Services**
3. Sélectionnez un produit de service
4. Accédez à l’ **Ressources** section
5. Choisissez quels types de ressources sont requis :
   * Sélectionnez **Membre de l’équipe** si le service nécessite un membre du personnel
   * Sélectionnez **Salle** si le service nécessite un espace physique
   * Sélectionnez **Équipement** si des outils spécifiques sont nécessaires
6. Facultativement, attribuez des ressources spécifiques :
   * Cochez **Ressources spécifiques uniquement** pour limiter le service à certains membres de l’équipe ou à certaines salles
   * Laissez décoché pour autoriser toute ressource disponible de ce type
7. **Enregistrez**

**Exemples de configurations :**

* **Coupe de cheveux**: Nécessite « Styliste » (n’importe quel styliste peut le faire)
* **Soin du visage**: Nécessite « Esthéticien(ne) » + « Salle de soins » (les deux sont requis)
* **Entraînement privé**: Nécessite uniquement la ressource spécifique « Coach personnel - Sarah »

{% hint style="warning" %}
**Erreur courante**: Si vous ne liez aucune ressource, aucun créneau de disponibilité n’apparaîtra ! Chaque service doit avoir au moins un type de ressource attribué.
{% endhint %}
{% endstep %}

{% step %}
**Ajouter la réservation à votre vitrine**

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

**Option 1 : intégration via l’extension d’application du thème (recommandé - thèmes modernes)**

La plupart des thèmes Shopify 2.0 prennent en charge les extensions d’application :

1. Dans l’interface d’administration Shopify, allez à **Boutique en ligne > Thèmes**
2. Cliquez sur **Personnaliser** sur votre thème actif
3. Cliquez sur **Extensions d’application** (généralement dans la barre latérale gauche ou les paramètres du thème)
4. Activez l’ **Sesami** extension d’application
5. **Enregistrez**

Le calendrier de réservation apparaîtra désormais automatiquement sur les pages produit de vos services.

**Option 2 : intégration manuelle (anciens thèmes)**

Pour les anciens thèmes sans prise en charge des extensions d’application :

1. Dans l’é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 l’assistance pour obtenir de l’aide à l’intégration spécifique au thème

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

{% 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 navigateur 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. **Ajoutez au panier** et poursuivez jusqu’au paiement
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 Sesami Admin, sous Réservations
8. **Vérifier 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 est affiché
* La réservation apparaît 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 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’extension d’application Sesami est activée** dans les paramètres du thème (étape 5)
2. **Le produit possède la 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 avec le produit associé

</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 (étape 3)
3. **Les ressources requises sont activées** (non désactivées)
4. **Le format de la variante de durée** est correct (par ex., « 30 minutes », « 1 heure » - sans espace supplémentaire, en anglais)

</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 3)
2. **La disponibilité est définie** pour les ressources attribuées (étape 2)
3. **Le fuseau horaire est correct** dans les paramètres de Sesami
4. **La fenêtre de réservation** autorise les réservations futures (vérifiez les paramètres avancés)
5. **Aucun blocage de disponibilité** ne couvre toutes les dates disponibles

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

</details>

<details>

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

1. Allez à **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 : [Incohérence de fuseau horaire](https://help.sesami.co/fr/commencer/onboarding/troubleshooting/timezone-mismatch)

</details>

<details>

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

Si le paiement est ignoré alors que vous vous attendiez à l’inverse (ou vice versa) :

1. Vérifiez si **la réservation instantanée** est activée (ignore le paiement)
2. Vérifiez les **paramètres d’acompte** (peut modifier le parcours de paiement)
3. Consultez le **tarif** du produit (les produits gratuits peuvent ignorer le paiement)

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

</details>

<details>

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

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

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

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

</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](https://help.sesami.co/fr/commencer/onboarding/troubleshooting/session-expired) | [Cookies Safari](https://help.sesami.co/fr/commencer/onboarding/troubleshooting/safari-cookies) | [Erreur de lien invalide](https://help.sesami.co/fr/commencer/onboarding/troubleshooting/as-a-customer-why-am-i-seeing-an-invalid-link-error-page)

</details>

***

## Étapes suivantes

Une fois les réservations de base opérationnelles, envisagez :

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

***

## Besoin d’aide ?

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

## Associés

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