> 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/apps-integrations/shopify/online-store/manual-install.md).

# Installazione manuale

Se il pulsante di prenotazione non appare nella pagina prodotto e Sesami è configurato correttamente, potrebbe essere necessaria un'installazione manuale — soprattutto con temi di terze parti o personalizzati.

## Quando è necessaria l'installazione manuale

* Il tuo tema è un tema di terze parti non disponibile nel Shopify Theme Store
* Il tuo tema è fortemente personalizzato
* Il tuo tema è un tema Shopify legacy (pre-2.0)
* L'embed dell'app Sesami non è compatibile con la struttura del tuo tema

{% hint style="info" %}
**Prima dell'installazione manuale**, assicurati di aver completato prima la configurazione standard. La maggior parte dei temi Shopify 2.0 funziona con l'embed dell'app senza alcuna modifica al codice.
{% endhint %}

## Passaggio 1: genera il tuo snippet

Inizia con il **Configuratore dell’Esperienza Sesami** per generare il tuo snippet di prenotazione:

1. Vai su [sesami.dev/docs/sesami-experience/configurator](https://sesami.dev/docs/sesami-experience/configurator/)
2. Configura il tuo Shop ID, Service ID, la versione dell'esperienza e lo stile
3. Copia lo `<sesami-experience>` snippet

## Passaggio 2: aggiungi al tuo tema

Inserisci lo snippet nel template della pagina prodotto nel punto in cui desideri che compaia il pulsante di prenotazione.

### Con Sesami Instant Booking

Se il servizio usa Sesami Instant Booking, lo snippet è autonomo — incollalo e hai finito. L'intero flusso di prenotazione avviene all'interno del widget.

### Con Shopify Checkout

Se il servizio usa il checkout Shopify (aggiungi al carrello), dovrai integrare lo snippet con le funzionalità di carrello e checkout del tuo tema. Questo include il collegamento dell'azione aggiungi al carrello e l'assicurarti che i dati di prenotazione fluiscano fino all'ordine.

Per istruzioni dettagliate sull'integrazione, fai riferimento alla [Documenti per sviluppatori di Sesami](https://sesami.dev). La documentazione per sviluppatori copre:

* Integrazione del pulsante aggiungi al carrello
* Mostrare data e ora nella pagina del carrello
* Disattivare il pulsante aggiungi al carrello prima che venga selezionato un orario
* Personalizzare lo stile del pulsante Sesami
* Nascondere il campo della durata dalla pagina prodotto
* Integrazione di storefront multilingue

## Temi consigliati

Ti consigliamo di utilizzare un tema Shopify dall'ufficiale [Shopify Theme Store](https://themes.shopify.com/themes). Questi temi seguono la struttura standardizzata di Shopify e sono completamente compatibili con l'embed dell'app di Sesami.

## Hai bisogno di aiuto?

* **Contatta lo sviluppatore del tuo tema** per supporto specifico del tema
* **Assumi un esperto Shopify**: [experts.shopify.com](https://experts.shopify.com/)
* **Servizi professionali Sesami**: [Servizi professionali](/it/inizia/onboarding/professional-services.md)
* **Supporto Sesami**: <help@sesami.co>

## Correlati

* [Incorpora in pagine personalizzate](/it/apps-integrations/shopify/online-store/embed-on-custom-pages.md) — aggiungi pulsanti di prenotazione alla home page o ad altre pagine
* [Script di verifica del carrello](/it/apps-integrations/shopify/online-store/cart-verification-script.md) — convalida le prenotazioni al checkout


---

# 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:

```
GET https://help.sesami.co/it/apps-integrations/shopify/online-store/manual-install.md?ask=<question>
```

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.