# 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](/pt/comecar/onboarding/professional-services.md)
* **Suporte do Sesami**: <help@sesami.co>

## Relacionado

* [Incorporar em Páginas Personalizadas](/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](/pt/apps-integrations/shopify/online-store/cart-verification-script.md) — validar reservas no checkout


---

# 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/pt/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.
