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

# Instalação manual

Se o botão de reserva não estiver a aparecer na sua página de produto e o Sesami estiver configurado corretamente, poderá precisar de uma instalação manual — especialmente com temas de terceiros ou personalizados.

## Quando é Necessária a Instalação Manual

* O seu tema é um tema de terceiros não disponível na Shopify Theme Store
* O seu tema está altamente personalizado
* O seu tema é um tema legado da Shopify (pré-2.0)
* O app embed do Sesami não é compatível com a estrutura do seu tema

{% hint style="info" %}
**Antes da instalação manual**, certifique-se de que concluiu primeiro a configuração padrão. A maioria dos temas Shopify 2.0 funciona com o app embed sem quaisquer alterações de código.
{% endhint %}

## Passo 1: Gere o seu snippet

Comece com o **Configurador de Experiência do Sesami** para gerar o seu snippet de reserva:

1. Aceda a [sesami.dev/docs/sesami-experience/configurator](https://sesami.dev/docs/sesami-experience/configurator/)
2. Configure o seu ID da Loja, ID do Serviço, versão da experiência e estilo
3. Copie o `<sesami-experience>` snippet

## Passo 2: Adicione ao seu tema

Coloque o snippet no modelo da página de produto onde pretende que o botão de reserva apareça.

### Com o Sesami Instant Booking

Se o serviço usar o Sesami Instant Booking, o snippet é autónomo — cole-o e está feito. Todo o fluxo de reserva acontece dentro do widget.

### Com o checkout da Shopify

Se o serviço usar o checkout da Shopify (adicionar ao carrinho), terá de integrar o snippet com a funcionalidade de carrinho e checkout do seu tema. Isto inclui ligar a ação de adicionar ao carrinho e garantir que os dados da reserva são transmitidos para a encomenda.

Para instruções detalhadas de integração, consulte a [Documentos de Programação do Sesami](https://sesami.dev). Os docs para developers cobrem:

* Integração do botão de adicionar ao carrinho
* Exibir a data e a hora na página do carrinho
* Desativar o botão de adicionar ao carrinho antes de uma hora ser selecionada
* Personalizar o estilo do botão Sesami
* Ocultar o campo de duração da página de produto
* Integração de loja multilingue

## Temas Recomendados

Recomendamos usar um tema Shopify da [Shopify Theme Store](https://themes.shopify.com/themes). Estes temas seguem a estrutura padronizada da Shopify e são totalmente compatíveis com o app embed do Sesami.

## Precisa de ajuda?

* **Contacte o desenvolvedor do seu tema** para suporte específico do tema
* **Contrate um Especialista Shopify**: [experts.shopify.com](https://experts.shopify.com/)
* **Serviços Profissionais Sesami**: [Serviços profissionais](https://help.sesami.co/pt/comecar/onboarding/professional-services.md)
* **Suporte do Sesami**: <help@sesami.co>

## Relacionado

* [Incorporar em Páginas Personalizadas](https://help.sesami.co/pt/apps-integrations/shopify/online-store/embed-on-custom-pages.md) — adicionar botões de reserva à página inicial ou a outras páginas
* [Script de verificação do carrinho](https://help.sesami.co/pt/apps-integrations/shopify/online-store/cart-verification-script.md) — validar reservas no 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 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/pt/apps-integrations/shopify/online-store/manual-install.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.
