> 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/it/inizia/quickstart.md).

# Avvio rapido

Questa guida ti porta da "installato" alla "prima prenotazione" con il minor numero di passaggi.

## Cosa configurerai

* **Servizi** - Prodotti Shopify che rappresentano servizi prenotabili
* **Risorse** - Membri del team, stanze, attrezzature o altre risorse necessarie per erogare i servizi
* **Disponibilità** - Orari di lavoro e regole di pianificazione delle risorse
* **Integrazione con il negozio online** - Pulsanti di prenotazione e calendario nel tuo negozio online

{% hint style="info" %}
**Tempo stimato**: 15-30 minuti per una configurazione di base con un servizio e un membro del team.
{% endhint %}

### Prima di iniziare <a href="#before-you-start" id="before-you-start"></a>

Assicurati di avere:

* **Accesso amministratore** al tuo negozio Shopify
* **Un elenco dei servizi** che vuoi offrire:
  * Nome del servizio (ad es. «Massaggio di 60 minuti», «Toelettatura per cani»)
  * Durata (ad es. 30 minuti, 1 ora, 2 ore)
  * Prezzo
* **Informazioni sulle risorse**:
  * Nomi dei membri del team e relativi orari di lavoro
  * Requisiti relativi a stanze o attrezzature (se applicabile)

<figure><img src="https://792414832-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 %}

### **Aggiungi un servizio a Sesami**

**Puoi creare un servizio direttamente in Sesami oppure aggiungere un prodotto esistente da Shopify.**

#### **- in Sesami**&#x20;

1. Inserisci un **titolo** chiaro (ad es. «Taglio di capelli», «Massaggio», «Consulenza»)

   Mantieni il titolo semplice: apparirà nelle conferme di prenotazione e nei calendari
2. Aggiungi la **descrizione**
3. Aggiungi **la variante «durata», l'unità,** e il **prezzo**\
   Crea varianti come «30 minuti», «1 ora», «90 minuti»
4. Fai clic per **creare il servizio**

<figure><img src="https://792414832-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>

#### **- in Shopify**

1. Nell'area di amministrazione Shopify, vai a **Prodotti > Aggiungi prodotto**
2. Inserisci un titolo chiaro per il prodotto che descriva il servizio, ad esempio *Taglio di capelli*, *Massaggio*, oppure *Consulenza*
3. Fai clic su **Aggiungi variante** e crea la «**variante "Durata"** e le sue opzioni, come *30 minuti*, *1 ora*, o *90 minuti*
4. Imposta un prezzo per ogni opzione di durata
5. Fai clic su **Salva** per creare il prodotto

<figure><img src="https://792414832-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>

Ripeti per ogni tipo di servizio che vuoi offrire.

{% hint style="success" %}
**Procedura consigliata**: usa le varianti per indicare durate diverse dello stesso servizio. Ad esempio, crea un unico prodotto "Massaggio" con le varianti "30 minuti", "1 ora" e "90 minuti" invece di tre prodotti separati.
{% endhint %}
{% endstep %}

{% step %}

### **Crea risorse e imposta la disponibilità**

Le risorse sono ciò che serve per offrire il servizio: membri del team, sale, attrezzature e così via. Puoi crearle e impostarne la disponibilità.

{% hint style="info" %}
**Nota**: nell'interfaccia attuale di Shopify Admin, le risorse sono indicate come "Membri del team". In un prossimo aggiornamento verranno indicate come "Risorse".
{% endhint %}

1. Aggiungi il **nome della risorsa** e il **tipo di risorsa**
   * Per il personale: aggiungi ogni membro del team per nome (ad es. "Sarah", "Alex", "Jamie")
   * Per sale e attrezzature: per ora aggiungile come membri del team (ad es. "Sala 1", "Kit videocamera A")
2. Imposta i **orari di lavoro** e aggiungi le regole di disponibilità (ad es. dal lunedì al venerdì, dalle 9:00 alle 17:00)
3. **Fai clic per creare la risorsa**&#x20;

**Esempio di configurazione:**

* Membro del team "Sarah" → disponibile dal lunedì al venerdì, dalle 9:00 alle 17:00
* Sala "Sala trattamenti 1" → disponibile dal lunedì al sabato, dalle 8:00 alle 20:00

{% hint style="info" %}
**Informazioni utili:** Non preoccuparti se non hai ancora configurato tutte le risorse. Puoi impostare la disponibilità di una singola risorsa ora, poi creare altre risorse o aggiornare la disponibilità di quelle esistenti in [**Portale di amministrazione: Risorse**](https://help.sesami.co/it/amministrazione/resources.md).
{% endhint %}

<figure><img src="https://792414832-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 %}

### **Aggiungi una prenotazione al tuo negozio online**

Rendi il calendario delle prenotazioni accessibile ai clienti nel tuo negozio online

<figure><img src="https://792414832-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>

**Incorporamento dell'app nel tema (consigliato per i temi moderni): la maggior parte dei temi Shopify 2.0 supporta gli incorporamenti delle app**

{% hint style="info" %}
**Facoltativo:** Se usi un tema Shopify meno recente, un negozio headless (come Hydrogen) o un sito web personalizzato, puoi saltare questo passaggio e consultare la nostra [documentazione per sviluppatori](https://sesami.dev/docs/sesami-experience/shopify-integration/intro/) per le istruzioni di integrazione.
{% endhint %}

#### **Passaggio 1: attiva l'incorporamento dell'app**

1. Nella dashboard di Sesami, fai clic su **Personalizza tema** nella sezione **Incorpora l'esperienza di prenotazione** .
2. Si aprirà l'editor del tema con il pannello **Incorporamenti dell'app** (in genere nella barra laterale a sinistra o nelle impostazioni del tema)
3. Individua il **App di prenotazione Sesami** e attiva l’interruttore per consentire l’incorporamento dell’app nel tema.
4. **Salva**

<div><figure><img src="https://792414832-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://792414832-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>

#### **Passaggio 2: aggiungi al prodotto**

1. Poi aggiungi il blocco di prenotazione Sesami al modello del prodotto aprendo un modello di prodotto
2. Nella sezione **Informazioni sul prodotto** , fai clic su **Aggiungi blocco** e seleziona **Pulsante di prenotazione Sesami**
3. Posiziona il blocco sopra i pulsanti di acquisto
4. **Salva** le modifiche al tema.

Il widget di prenotazione apparirà ora nelle pagine dei prodotti del tuo negozio online, consentendo ai clienti di selezionare gli orari di prenotazione disponibili.

<div><figure><img src="https://792414832-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://792414832-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" %}
**Integrazione manuale (temi meno recenti)**

Per i temi meno recenti che non supportano l’incorporamento delle app:

1. Nell’editor del tema, aggiungi un pulsante o un link alle pagine dei prodotti
2. Inserisci un link alla pagina del prodotto con il calendario Sesami attivo
3. Oppure contatta l’assistenza per ricevere aiuto con l’integrazione specifica per il tema

Vedi: [Configurazione del negozio online Shopify](https://help.sesami.co/it/apps-integrations/shopify/online-store.md)
{% endhint %}

{% hint style="success" %}
**Suggerimento**: aggiungi al menu principale un link di navigazione "Prenota ora" che rimandi a una collezione di tutti i servizi prenotabili.
{% endhint %}
{% endstep %}

{% step %}
**Esegui un test completo**

Prima di pubblicare il negozio, prova un flusso di prenotazione completo:

1. **Apri il tuo negozio** in una finestra di navigazione in incognito/privata (per visualizzare la prospettiva del cliente)
2. **Vai alla pagina di un prodotto relativo a un servizio**
3. **Verifica che il calendario di prenotazione sia visibile** con le fasce orarie disponibili
4. **Seleziona una data e un orario**
5. **Aggiungi al carrello** e procedi al checkout
6. **Completa l’acquisto** (usa la modalità di test di Shopify oppure effettua una prenotazione reale)
7. **Verifica che la prenotazione sia visibile** in Sesami Admin, nella sezione Bookings
8. **Verifica su dispositivo mobile** - Prova lo stesso flusso su un dispositivo mobile

**Cosa verificare:**

* Le fasce orarie disponibili corrispondono alla disponibilità delle tue risorse
* Viene visualizzato il fuso orario corretto
* La prenotazione risulta assegnata alla risorsa corretta
* Gli orari non si sovrappongono se prenoti più appuntamenti

{% hint style="warning" %}
**Se non vengono visualizzate fasce orarie**, consulta la sezione sulla risoluzione dei problemi qui sotto.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## Risoluzione dei problemi

<details>

<summary>Il calendario non appare nella pagina del prodotto</summary>

Verifica:

1. **L’incorporamento dell’app Sesami è attivo** nelle impostazioni del tema
2. **Il prodotto ha il tag sesami-service** in Shopify
3. **Sesami è attivo** nelle impostazioni di Sesami
4. Stai visualizzando il **tema pubblicato** (non una versione bozza/non pubblicata)
5. **Il servizio è configurato** in Sesami e collegato al prodotto

</details>

<details>

<summary>Il servizio non funziona o mostra errori</summary>

Verifica:

1. **Il prodotto è aggiunto come servizio** in Sesami
2. **Le risorse sono assegnate** al servizio
3. **Le risorse richieste sono attive** (non disattivate)
4. **Il formato della variante di durata** è corretto (ad es. "30 Minutes", "1 Hour": senza spazi aggiuntivi e in inglese)
5. **"Il prodotto non ha un'opzione Duration" -** La variante di durata deve essere scritta in inglese, senza errori di battitura.

</details>

<details>

<summary>Non vengono visualizzate fasce orarie disponibili</summary>

Il problema più comune! Controlla che:

1. **Le risorse siano assegnate** al servizio (passaggio 2)
2. **La disponibilità sia impostata** per le risorse assegnate (passaggio 2)
3. **La finestra di prenotazione** consenta prenotazioni future (controlla le impostazioni avanzate)
4. **Non ci siano blocchi** che coprono tutte le date disponibili
5. **I pulsanti di acquisto sono nascosti o rimossi dalla pagina del prodotto**

Vedi: [Nessuna disponibilità](https://help.sesami.co/it/inizia/onboarding/troubleshooting/no-availability.md)

</details>

<details>

<summary>Errore: "Qualcosa è andato storto. Ricarica la pagina e riprova"</summary>

Quando si usano varianti di durata, il nome dell'opzione deve essere esattamente **`Duration`** in inglese, senza errori di battitura, parole aggiuntive, traduzioni o spazi prima o dopo.

Sesami usa questa parola chiave per identificare la durata della prenotazione. Se è configurata in modo errato, il flusso di prenotazione potrebbe non funzionare come previsto.\
\
*\*La durata può essere tradotta in seguito.*

<figure><img src="https://792414832-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>Il fuso orario non sembra corretto</summary>

1. Vai a **Sesami > Impostazioni > Fuso orario**
2. Verifica che il fuso orario del negozio corrisponda alla tua posizione fisica
3. Controlla che la disponibilità delle risorse sia impostata sul fuso orario corretto
4. Svuota la cache del browser e prova in modalità di navigazione in incognito

Vedi: [Fuso orario non corrispondente](https://help.sesami.co/it/inizia/onboarding/troubleshooting/timezone-mismatch.md)

</details>

<details>

<summary>Il comportamento durante il checkout è imprevisto</summary>

Se il checkout viene saltato quando non te lo aspetti (o viceversa):

1. Controlla se **Prenotazione immediata** è attiva (salta il checkout)
2. Verifica le **impostazioni dei depositi** (possono modificare il flusso di checkout)
3. Controlla i **prezzi dei prodotti** (i prodotti gratuiti possono saltare il checkout)

Vedi: [Prenotazione immediata](https://help.sesami.co/it/prenotazione/booking-features/instant-booking.md) | [Depositi](https://help.sesami.co/it/pagamenti/deposits.md)

</details>

<details>

<summary>La prenotazione mostra «Assegnata a: nessuno»</summary>

Questo accade quando le fasce orarie non sono più disponibili durante il checkout:

1. Attiva **Periodo di prenotazione** nelle impostazioni di Sesami
2. Attiva **Convalida del carrello** per verificare la disponibilità prima del checkout

Vedi: [Risoluzione dei problemi: assegnata a nessuno](https://help.sesami.co/it/inizia/onboarding/troubleshooting/troubleshooting-assigned-to-no-one-caused-by-invalid-order.md)

</details>

<details>

<summary>I clienti visualizzano gli errori «Sessione scaduta» o «Link non valido»</summary>

Cause comuni:

1. **Link scaduti** - Il cliente ha provato a riprogrammare o annullare dopo la scadenza
2. **Cookie del browser bloccati** - Controlla le impostazioni del browser, in particolare Safari
3. **Problemi di cache** - Svuota la cache del browser e riprova

Vedi: [Sessione scaduta](https://help.sesami.co/it/inizia/onboarding/troubleshooting/session-expired.md) | [Cookie di Safari](https://help.sesami.co/it/inizia/onboarding/troubleshooting/safari-cookies.md) | [Errore di link non valido](https://help.sesami.co/it/inizia/onboarding/troubleshooting/as-a-customer-why-am-i-seeing-an-invalid-link-error-page.md)

</details>

***

## Passaggi successivi

Dopo aver configurato le prenotazioni di base, valuta di attivare:

* [**Notifiche email**](https://help.sesami.co/it/notifiche/notification-emails.md) - Configura le email di conferma e promemoria
* [**Sincronizzazione con Google Calendar**](https://help.sesami.co/it/apps-integrations/google-calendar.md) - Sincronizzazione bidirezionale con i calendari dei membri del team
* [**Riprogrammazione da parte dei clienti**](https://help.sesami.co/it/prenotazione/booking-features/cancellations-rescheduling.md) - Consenti ai clienti di riprogrammare o annullare
* [**Appuntamenti di gruppo**](https://help.sesami.co/it/prenotazione/booking-features/group-appointments.md) - Consenti più prenotazioni per fascia oraria
* [**Depositi**](https://help.sesami.co/it/pagamenti/deposits.md) - Riscuoti un pagamento parziale al momento della prenotazione
* [**Punto vendita**](https://help.sesami.co/it/apps-integrations/shopify/pos.md) - Accetta prenotazioni di persona

***

## Hai bisogno di aiuto?

* [**Chiamata di onboarding gratuita**](https://help.sesami.co/it/inizia/onboarding/onboarding-call.md) - Prenota una sessione con il nostro team Customer Success
* [**Servizio di configurazione personalizzata**](https://help.sesami.co/it/inizia/onboarding/white-glove-setup.md) - Ricevi assistenza professionale per l’integrazione e la configurazione del tema
* [**Servizi professionali**](https://help.sesami.co/it/inizia/onboarding/professional-services.md) - Sviluppo personalizzato per esigenze specifiche
* [**Assistenza**](mailto:help@sesami.co) - Scrivi a <help@sesami.co> per ricevere assistenza

## Correlati

* [Guida alle risorse](https://help.sesami.co/it/amministrazione/resources.md) - Configurazione dettagliata delle risorse
* [Configurazione della disponibilità](https://help.sesami.co/it/prenotazione/availability/resource-availability.md) - Opzioni avanzate di disponibilità
* [Portale di amministrazione Sesami](https://help.sesami.co/it/amministrazione/sesami-admin-portal.md) - Panoramica dell’interfaccia di amministrazione
* [Configurazione dei servizi](https://help.sesami.co/it/amministrazione/services.md) - Impostazioni avanzate dei servizi


---

# 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/it/inizia/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.
