# Avvio rapido
## Cosa configurerai
* **Servizi** - Prodotti Shopify che rappresentano servizi prenotabili
* **Risorse** - Membri del team, stanze, attrezzature o altri asset necessari per erogare i servizi
* **Disponibilità** - Orari di lavoro e regole di pianificazione per le risorse
* **Integrazione con il negozio online** - Pulsanti di prenotazione e calendario nel tuo negozio online
{% hint style="info" %}
**Stima del tempo**: 15-30 minuti per una configurazione base con un servizio e un membro del team.
{% endhint %}
## Prima di iniziare
Assicurati di avere:
* **Accesso amministratore** nel tuo negozio Shopify
* **Un elenco di servizi** che vuoi offrire con:
* Nome del servizio (es. "Massaggio di 60 minuti", "Toelettatura cani")
* Durata (es. 30 minuti, 1 ora, 2 ore)
* Prezzo
* Capacità (numero di prenotazioni simultanee, se applicabile)
* **Informazioni sulle risorse**:
* Nomi dei membri del team e relativi orari di lavoro
* Requisiti per stanza o attrezzatura (se applicabile)
***
{% stepper %}
{% step %}
**Crea prodotti di servizio in Shopify**
Crea un prodotto Shopify per ogni servizio prenotabile:
1. In Shopify Admin, vai su **Prodotti > Aggiungi prodotto**
2. Inserisci un **titolo del prodotto** chiaro, senza durata (es. "Taglio di capelli", "Massaggio", "Consulenza")
* Mantieni il titolo semplice: questo appare nelle conferme di prenotazione e nei calendari
3. Aggiungi **varianti per diverse durate**:
* Fai clic su **Aggiungi variante**
* Crea varianti come "30 minuti", "1 ora", "90 minuti"
* Imposta il prezzo per ciascuna variante di durata
4. Aggiungi una descrizione, immagini e altri dettagli del prodotto secondo necessità
5. **Salva** il prodotto
Ripeti per ogni tipo di servizio che vuoi offrire.
{% hint style="success" %}
**Buona pratica**: Usa le varianti per durate diverse 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 le 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 di Shopify Admin, le risorse sono etichettate come "Membri del team". Questo sarà aggiornato in "Risorse" in una prossima release.
{% endhint %}
1. Apri **Sesami** in Shopify Admin
2. Vai a **Membri del team** (Risorse)
3. Fai clic su **Aggiungi membro del team** e crea le tue risorse:
* Per il personale: aggiungi ogni membro del team per nome (es. "Sarah", "Alex", "Jamie")
* Per stanze/attrezzature: aggiungili per ora come membri del team (es. "Stanza 1", "Kit fotocamera A")
4. Per ogni risorsa, imposta la relativa **disponibilità**:
* Fai clic sul nome della risorsa
* Vai alla **Disponibilità** scheda
* Aggiungi regole di disponibilità (es. lunedì-venerdì, 9:00 - 17:00)
* **Salva** l'orario
**Configurazione di esempio:**
* Membro del team "Sarah" → Disponibile dal lunedì al venerdì, 9:00 - 17:00
* Stanza "Sala trattamenti 1" → Disponibile dal lunedì al sabato, 8:00 - 20:00
Vedi: [Guida alle risorse](/it/amministratore/resources.md) | [Configurazione della disponibilità](/it/prenotazione/availability/resource-availability.md)
{% endstep %}
{% step %}
**Collega i servizi alle risorse**
Indica a Sesami quali risorse sono necessarie per ciascun servizio:
1. Apri **Sesami** in Shopify Admin
2. Vai a **Servizi**
3. Seleziona un prodotto di servizio
4. Vai alla **Risorse** sezione
5. Scegli quali tipi di risorse sono richiesti:
* Seleziona **Membro del team** se il servizio richiede un membro del personale
* Seleziona **Stanza** se il servizio richiede uno spazio fisico
* Seleziona **Attrezzatura** se sono necessari strumenti specifici
6. Facoltativamente, assegna risorse specifiche:
* Seleziona **Solo risorse specifiche** per limitare il servizio a determinati membri del team o stanze
* Lascia deselezionato per consentire qualsiasi risorsa disponibile di quel tipo
7. **Salva**
**Configurazioni di esempio:**
* **Taglio di capelli**: Richiede "Stylist" (può farlo qualsiasi stylist)
* **Trattamento viso**: Richiede "Estetista" + "Sala trattamenti" (entrambi necessari)
* **Allenamento privato**: Richiede solo la risorsa specifica "Personal Trainer - Sarah"
{% hint style="warning" %}
**Errore comune**: Se non colleghi alcuna risorsa, non apparirà alcuna fascia oraria disponibile! Ogni servizio deve avere assegnato almeno un tipo di risorsa.
{% endhint %}
{% endstep %}
{% step %}
**Aggiungi la prenotazione al tuo negozio online**
Rendi il calendario di prenotazione accessibile ai clienti nel tuo negozio online:
**Opzione 1: integrazione dell'app nel tema (consigliata - temi moderni)**
La maggior parte dei temi Shopify 2.0 supporta le integrazioni dell'app:
1. In Shopify Admin, vai su **Negozio online > Temi**
2. Fai clic su **Personalizza** nel tuo tema attivo
3. Fai clic su **Integrazioni dell'app** (di solito nella barra laterale sinistra o nelle impostazioni del tema)
4. Abilita l' **Sesami** integrazione dell'app
5. **Salva**
Il calendario di prenotazione apparirà ora automaticamente nelle pagine prodotto dei tuoi servizi.
{% hint style="warning" %}
**Nota importante:** Il pulsante Acquista non può essere nascosto o rimosso dal modello del prodotto. \
Il pulsante Acquista è necessario per visualizzare la disponibilità di prenotazione nel calendario. \
Se preferisci non mostrare il pulsante Acquista ai clienti, puoi abilitare l'opzione “Aggiungi automaticamente al carrello / Salta il carrello”. Questa rimuove il pulsante dal flusso di prenotazione.
{% endhint %}
**Opzione 2: integrazione manuale (temi più vecchi)**
Per i temi più vecchi senza supporto per l'integrazione dell'app:
1. Nell'editor del tema, aggiungi un pulsante o un link alle pagine prodotto
2. Collega alla pagina prodotto con il calendario Sesami attivo
3. Oppure contatta l'assistenza per aiuto con l'integrazione specifica del tema
Vedi: [Configurazione del negozio online Shopify](/it/apps-integrations/shopify/online-store.md)
{% hint style="success" %}
**Consiglio utile**: Aggiungi nel menu principale un link di navigazione "Prenota ora" che punti a una collezione di tutti i servizi prenotabili.
{% endhint %}
{% endstep %}
{% step %}
**Test end-to-end**
Prima di andare online, testa un flusso completo di prenotazione:
1. **Apri il tuo negozio** in una finestra del browser in incognito/privata (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 al checkout
6. **Completa l'acquisto** (usa la modalità di prova di Shopify o effettua una prenotazione reale)
7. **Verifica che la prenotazione appaia** in Sesami Admin sotto Prenotazioni
8. **Controlla su mobile** - Prova lo stesso flusso su un dispositivo mobile
**Cosa verificare:**
* Le fasce orarie disponibili corrispondono alla disponibilità delle tue risorse
* Viene mostrato 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 compaiono fasce orarie**, consulta la sezione di risoluzione dei problemi qui sotto.
{% endhint %}
{% endstep %}
{% endstepper %}
***
## Risoluzione dei problemi
Il calendario non appare nella pagina prodotto
Controlla:
1. **L'integrazione dell'app Sesami è abilitata** nelle impostazioni del tema (passo 5)
2. **Il prodotto ha il tag sesami-service** in Shopify
3. **Sesami è abilitato** nelle impostazioni di Sesami
4. Stai visualizzando il **tema pubblicato** (non una versione bozza/non pubblicata)
5. **Il servizio è configurato** in Sesami con il prodotto collegato
Il servizio non funziona o mostra errori
Controlla:
1. **Il prodotto è aggiunto come servizio** in Sesami
2. **Le risorse sono assegnate** al servizio (passo 3)
3. **Le risorse richieste sono abilitate** (non disabilitate)
4. **Il formato della variante di durata** è corretto (es. "30 minuti", "1 ora" - nessuno spazio extra, in inglese)
Non vengono mostrate fasce orarie disponibili
Il problema più comune! Controlla:
1. **Le risorse sono assegnate** al servizio (passo 3)
2. **La disponibilità è impostata** per le risorse assegnate (passo 2)
3. **Il fuso orario è corretto** nelle impostazioni di Sesami
4. **La finestra di prenotazione** consente prenotazioni future (controlla le impostazioni avanzate)
5. **Nessun blocco** copre tutte le date disponibili
Vedi: [Nessuna disponibilità](/it/inizia/onboarding/troubleshooting/no-availability.md)
Il fuso orario sembra errato
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. Svuota la cache del browser e prova in modalità incognito
Vedi: [Disallineamento del fuso orario](/it/inizia/onboarding/troubleshooting/timezone-mismatch.md)
Il comportamento del checkout è inatteso
Se il checkout viene saltato quando non te lo aspettavi (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 **prezzo del prodotto** (i prodotti gratuiti possono saltare il checkout)
Vedi: [Prenotazione istantanea](/it/prenotazione/booking-features/instant-booking.md) | [Depositi](/it/pagamenti/deposits.md)
La prenotazione mostra "Assegnato a: Nessuno"
Questo accade quando le fasce orarie diventano non disponibili durante il checkout:
1. Abilita **Periodo di prenotazione** nelle impostazioni di Sesami
2. Abilita **Convalida del carrello** per verificare la disponibilità prima del checkout
Vedi: [Risoluzione problemi Assegnato a Nessuno](/it/inizia/onboarding/troubleshooting/troubleshooting-assigned-to-no-one-caused-by-invalid-order.md)
I clienti vedono errori "Sessione scaduta" o "Link non valido"
Cause comuni:
1. **Link scaduti** - Il cliente ha provato a riprogrammare/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](/it/inizia/onboarding/troubleshooting/session-expired.md) | [Cookie di Safari](/it/inizia/onboarding/troubleshooting/safari-cookies.md) | [Errore link non valido](/it/inizia/onboarding/troubleshooting/as-a-customer-why-am-i-seeing-an-invalid-link-error-page.md)
***
## Passi successivi
Una volta che hai fatto funzionare le prenotazioni di base, prendi in considerazione:
* [**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 annullare
* [**Appuntamenti di gruppo**](/it/prenotazione/booking-features/group-appointments.md) - Abilita più prenotazioni per fascia oraria
* [**Depositi**](/it/pagamenti/deposits.md) - Raccogli il 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) - Ricevi assistenza professionale per l'integrazione e la configurazione del tema
* [**Servizi professionali**](/it/inizia/onboarding/professional-services.md) - Sviluppo personalizzato per requisiti unici
* [**Assistenza**](mailto:help@sesami.co) - Invia un'email a per assistenza
## Correlati
* [Guida alle risorse](/it/amministratore/resources.md) - Configurazione dettagliata delle risorse
* [Configurazione della disponibilità](/it/prenotazione/availability/resource-availability.md) - Opzioni avanzate di disponibilità
* [Portale Admin di Sesami](/it/amministratore/sesami-admin-portal.md) - Panoramica dell'interfaccia amministratore
* [Configurazione dei servizi](/it/amministratore/services.md) - Impostazioni avanzate dei servizi
---
# Agent Instructions: 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:
```
GET https://help.sesami.co/it/inizia/quickstart.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.