> 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 per le risorse
* **Integrazione con lo storefront** - 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** nel tuo negozio Shopify
* **Un elenco di servizi** che vuoi offrire:
  * Nome del servizio (ad es., "Massaggio di 60 minuti", "Toelettatura cani")
  * Durata (ad es., 30 minuti, 1 ora, 2 ore)
  * Prezzo
* **Informazioni sulla risorsa**:
  * Nomi dei membri del team e loro orari di lavoro
  * Requisiti per 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 il servizio a Sesami**

**Puoi creare un servizio direttamente in Sesami o 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: questo appare 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. Nel tuo pannello di controllo Shopify, vai a **Prodotti > Aggiungi prodotto**
2. Inserisci un titolo di prodotto chiaro che descriva il servizio, come *Taglio di capelli*, *Massaggio*, o *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" %}
**Buona pratica**: Usa le varianti per diverse durate dello stesso servizio. Ad esempio, un prodotto "Massaggio" con 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ò di cui il tuo servizio ha bisogno per essere erogato: membri del team, stanze, attrezzature, ecc. Le creerai e ne imposterai la disponibilità.

{% hint style="info" %}
**Nota**: Nell'interfaccia attuale del pannello di controllo Shopify, le risorse sono etichettate come "Membri del team". Questo sarà aggiornato in "Risorse" in una prossima release.
{% endhint %}

1. Aggiungi la **Risorsa** nome e **Tipo di risorsa**
   * Per il personale: aggiungi ogni membro del team per nome (ad es., "Sarah", "Alex", "Jamie")
   * Per stanze/attrezzature: aggiungile per ora come membri del team (ad es., "Stanza 1", "Kit videocamera A")
2. Imposta i suoi **Orari di lavoro** e aggiungi le regole di disponibilità (ad es., lunedì-venerdì, 9:00 - 17:00)
3. **Fai clic per creare la risorsa**&#x20;

**Esempio di configurazione:**

* Membro del team "Sarah" → Disponibile lunedì-venerdì, 9-17
* Stanza "Stanza trattamenti 1" → Disponibile lunedì-sabato, 8-20

{% hint style="info" %}
**Buono a sapersi:** Non preoccuparti se non hai ancora configurato tutte le risorse. Puoi impostare ora la disponibilità di una singola risorsa, quindi creare risorse aggiuntive o aggiornare in seguito la disponibilità delle risorse esistenti nel [**Portale admin: Risorse**](/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 storefront**

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>

**Theme App Embed (Consigliato - temi moderni) - La maggior parte dei temi Shopify 2.0 supporta gli app embed**

{% hint style="info" %}
**Facoltativo:** Se stai usando un tema Shopify più vecchio, uno storefront 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: abilita l'app embed**

1. Dal dashboard di Sesami, fai clic su **Personalizza tema** nella **Incorpora l'esperienza di prenotazione** sezione.
2. Si aprirà l'Editor tema con il pannello **App embeds** (di solito nella barra laterale sinistra o nelle impostazioni del tema)
3. Individua la **Sesami Booking App** e attiva l'interruttore per abilitare l'incorporamento dell'app nel tuo 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. Successivamente, aggiungi il blocco di prenotazione Sesami al template del tuo prodotto aprendo un template prodotto
2. Nella **Informazioni sul prodotto** sezione, fai clic su **Aggiungi blocco** e seleziona il **pulsante di prenotazione Sesami**
3. Posiziona il blocco sopra i pulsanti Acquista
4. **Salva** le modifiche del tema.

Il widget di prenotazione apparirà ora nelle pagine prodotto del tuo storefront, consentendo ai clienti di selezionare gli orari 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 più vecchi)**

Per temi più vecchi senza supporto per app embed:

1. Nel tuo editor del tema, aggiungi un pulsante o un link alle pagine prodotto
2. Collega la pagina prodotto con il calendario Sesami attivo
3. Oppure contatta l'assistenza per supporto all'integrazione specifico per il tema

Vedi: [Configurazione Shopify Online Store](/it/apps-integrations/shopify/online-store.md)
{% endhint %}

{% hint style="success" %}
**Consiglio da esperto**: Aggiungi un link di navigazione "Prenota ora" nel menu principale che punti a una raccolta di tutti i servizi prenotabili.
{% endhint %}
{% endstep %}

{% step %}
**Test end-to-end**

Prima di andare live, testa un flusso di prenotazione completo:

1. **Apri il tuo negozio** in una finestra di navigazione in incognito/private (per vedere la vista del cliente)
2. **Vai a una pagina prodotto del servizio**
3. **Controlla che il calendario di prenotazione appaia** con le fasce orarie disponibili
4. **Seleziona una data e un'ora**
5. **Aggiungi al carrello** e procedi con il checkout
6. **Completa l'acquisto** (usa la modalità di test di Shopify o effettua una prenotazione reale)
7. **Verifica che la prenotazione appaia** in Sesami Admin sotto Prenotazioni
8. **Controlla su mobile** - Testa lo stesso flusso su un dispositivo mobile

**Cosa verificare:**

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

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

***

## Risoluzione dei problemi

<details>

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

Controlla:

1. **L'app embed di Sesami è abilitata** nelle Impostazioni tema
2. **Il prodotto ha un tag sesami-service** in Shopify
3. **Sesami è abilitato** nelle Impostazioni Sesami
4. Stai visualizzando il **tema pubblicato** (non una versione bozza/non pubblicata)
5. **Il servizio è configurato** in Sesami con il prodotto collegato

</details>

<details>

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

Controlla:

1. **Il prodotto è aggiunto come servizio** in Sesami
2. **Le risorse sono assegnate** al servizio
3. **Le risorse richieste sono abilitate** (non disabilitate)
4. **Il formato della variante** di durata è corretto (ad es., "30 minuti", "1 ora" - senza spazi extra, in inglese)
5. **"Il prodotto non ha un'opzione Durata" -** La variante di durata deve essere scritta in inglese, senza errori di battitura.

</details>

<details>

<summary>Nessuna fascia oraria disponibile visualizzata</summary>

Il problema più comune! Controlla:

1. **Le risorse sono assegnate** al servizio (Passaggio 2)
2. **La disponibilità è impostata** per le risorse assegnate (Passaggio 2)
3. **La finestra di prenotazione** consente prenotazioni future (controlla le impostazioni avanzate)
4. **Nessun blocco** copre tutte le date disponibili
5. **I pulsanti Acquista sono nascosti o rimossi nella pagina prodotto**

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

</details>

<details>

<summary>Il fuso orario sembra errato</summary>

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

Vedi: [Disallineamento del fuso orario](/it/inizia/onboarding/troubleshooting/timezone-mismatch.md)

</details>

<details>

<summary>Il comportamento del checkout è inatteso</summary>

Se il checkout viene saltato quando ti aspettavi che non lo fosse (o viceversa):

1. Controlla se **Prenotazione istantanea** è abilitata (salta il checkout)
2. Verifica **le impostazioni del deposito** (può modificare il flusso di checkout)
3. Rivedi il prodotto **prezzo** (i prodotti gratuiti possono saltare il checkout)

Vedi: [Prenotazione istantanea](/it/prenotazione/booking-features/instant-booking.md) | [Depositi](/it/pagamenti/deposits.md)

</details>

<details>

<summary>La prenotazione mostra "Assegnato a: Nessuno"</summary>

Questo accade quando le fasce orarie diventano non disponibili durante il checkout:

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

Vedi: [Risoluzione dei problemi di Assegnato a Nessuno](/it/inizia/onboarding/troubleshooting/troubleshooting-assigned-to-no-one-caused-by-invalid-order.md)

</details>

<details>

<summary>I clienti vedono errori "Sessione scaduta" o "Link non valido"</summary>

Cause comuni:

1. **Link scaduti** - Il cliente ha provato a riprogrammare/cancellare dopo la scadenza
2. **Cookie del browser bloccati** - Controlla le impostazioni del browser, soprattutto Safari
3. **Problemi di cache** - Cancella la cache del browser e riprova

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

</details>

***

## Passaggi successivi

Una volta che le prenotazioni di base funzionano, considera:

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

***

## Hai bisogno di aiuto?

* [**Chiamata di onboarding gratuita**](/it/inizia/onboarding/onboarding-call.md) - Prenota una sessione con il nostro team Customer Success
* [**Servizio di configurazione White-Glove**](/it/inizia/onboarding/white-glove-setup.md) - Ottieni aiuto professionale per l'integrazione del tema e la configurazione
* [**Servizi professionali**](/it/inizia/onboarding/professional-services.md) - Sviluppo personalizzato per esigenze uniche
* [**Supporto**](mailto:help@sesami.co) - Invia un'email a <help@sesami.co> per assistenza

## Correlati

* [Guida alle risorse](/it/amministrazione/resources.md) - Configurazione dettagliata delle risorse
* [Configurazione della disponibilità](/it/prenotazione/availability/resource-availability.md) - Opzioni avanzate di disponibilità
* [Portale admin di Sesami](/it/amministrazione/sesami-admin-portal.md) - Panoramica dell'interfaccia admin
* [Configurazione dei servizi](/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 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/it/inizia/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.