> 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/comecar/quickstart.md).

# Início rápido

Este guia leva-te de "instalado" à "primeira reserva" com o mínimo de passos.

## O que vai configurar

* **Serviços** - Produtos Shopify que representam serviços reserváveis
* **Recursos** - Membros da equipa, salas, equipamento ou outros ativos necessários para prestar os serviços
* **Disponibilidade** - Horário de trabalho e regras de agendamento dos recursos
* **Integração com a loja online** - Botões de reserva e calendário na sua loja online

{% hint style="info" %}
**Tempo estimado**: 15–30 minutos para uma configuração básica com um serviço e um membro da equipa.
{% endhint %}

### Antes de começar <a href="#before-you-start" id="before-you-start"></a>

Certifique-se de que tem:

* **Acesso de administrador** à sua loja Shopify
* **Uma lista dos serviços** que pretende oferecer:
  * Nome do serviço (por exemplo, «Massagem de 60 minutos», «Tosquia de cães»)
  * Duração (por exemplo, 30 minutos, 1 hora, 2 horas)
  * Preço
* **Informações sobre os recursos**:
  * Nomes dos membros da equipa e respetivos horários de trabalho
  * Requisitos de sala ou equipamento (se aplicável)

<figure><img src="https://2464016170-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 %}

### **Adicionar um serviço ao Sesami**

**Pode criar um serviço diretamente no Sesami ou adicionar um produto existente do Shopify.**

#### **- no Sesami**&#x20;

1. Introduza um **título** claro (por exemplo, «Corte de cabelo», «Massagem», «Consulta»)

   Mantenha o título simples: aparece nas confirmações de reserva e nos calendários
2. Adicione a **descrição**
3. Adicione a **variante «duração», unidade,** e **preço**\
   Crie variantes como «30 minutos», «1 hora», «90 minutos»
4. Clique para **criar o serviço**

<figure><img src="https://2464016170-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>

#### **- no Shopify**

1. No seu painel de administração do Shopify, aceda a **Produtos > Adicionar produto**
2. Introduza um título de produto claro que descreva o serviço, como *Corte de cabelo*, *Massagem*, ou *Consulta*
3. Clique em **Adicionar variante** e crie a «**variante «Duração»** e as respetivas opções, como *30 minutos*, *1 hora*, ou *90 minutos*
4. Defina um preço para cada opção de duração
5. Clique em **Guardar** para criar o produto

<figure><img src="https://2464016170-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>

Repita o processo para cada tipo de serviço que pretende oferecer.

{% hint style="success" %}
**Boa prática**: Utilize variantes para diferentes durações do mesmo serviço. Por exemplo, um produto «Massagem» com as variantes «30 minutos», «1 hora» e «90 minutos», em vez de três produtos separados.
{% endhint %}
{% endstep %}

{% step %}

### **Crie recursos e defina a disponibilidade**

Os recursos são aquilo de que o seu serviço precisa para ser realizado — membros da equipa, salas, equipamento, etc. Crie-os e defina a respetiva disponibilidade.

{% hint style="info" %}
**Nota**: Na interface atual do Shopify Admin, os recursos são identificados como «Membros da equipa». Esta designação será alterada para «Recursos» numa versão futura.
{% endhint %}

1. Adicione o **nome do recurso** e o **tipo de recurso**
   * Para funcionários: adicione cada membro da equipa pelo nome (por exemplo, «Sarah», «Alex», «Jamie»)
   * Para salas/equipamento: por enquanto, adicione-os como membros da equipa (por exemplo, «Sala 1», «Kit de câmara A»)
2. Defina o seu **horário de trabalho** e adicione as regras de disponibilidade (por exemplo, de segunda a sexta-feira, das 9:00 às 17:00)
3. **Clique para criar o recurso**&#x20;

**Exemplo de configuração:**

* Membro da equipa «Sarah» → Disponível de segunda a sexta-feira, das 9:00 às 17:00
* Sala «Sala de tratamentos 1» → Disponível de segunda-feira a sábado, das 8:00 às 20:00

{% hint style="info" %}
**É bom saber:** Não se preocupe se ainda não configurou todos os seus recursos. Pode definir a disponibilidade de um único recurso agora e, mais tarde, criar recursos adicionais ou atualizar a disponibilidade dos existentes em [**Portal de administração: Recursos**](https://help.sesami.co/pt/admin/resources.md).
{% endhint %}

<figure><img src="https://2464016170-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 %}

### **Adicione uma reserva à sua loja online**

Torne o calendário de reservas acessível aos clientes na sua loja online

<figure><img src="https://2464016170-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>

**Incorporação de aplicação no tema (recomendado — temas modernos) — a maioria dos temas Shopify 2.0 suporta incorporações de aplicações**

{% hint style="info" %}
**Opcional:** Se estiver a utilizar um tema Shopify mais antigo, uma loja sem interface (como o Hydrogen) ou um site personalizado, pode ignorar este passo e consultar a nossa [documentação para programadores](https://sesami.dev/docs/sesami-experience/shopify-integration/intro/) para obter instruções de integração.
{% endhint %}

#### **Passo 1: Ative a incorporação da aplicação**

1. No painel do Sesami, clique em **Personalizar tema** na secção **Incorporar a experiência de reserva** .
2. Será aberto o Editor de temas com o painel **Incorporações de aplicações** (geralmente na barra lateral esquerda ou nas definições do tema)
3. Localize o **Aplicação de reservas Sesami** e ative o botão para permitir a incorporação da aplicação no seu tema.
4. **Guardar**

<div><figure><img src="https://2464016170-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://2464016170-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>

#### **Passo 2: Adicionar ao produto**

1. Em seguida, adicione o bloco de reservas Sesami ao modelo do produto, abrindo um modelo de produto
2. Na secção **Informações do produto** , clique em **Adicionar bloco** e selecione **Botão de reserva Sesami**
3. Coloque o bloco acima dos botões de compra
4. **Guarde** as alterações ao tema.

O widget de reservas será agora apresentado nas páginas de produto da sua loja, permitindo que os clientes selecionem horários disponíveis.

<div><figure><img src="https://2464016170-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://2464016170-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" %}
**Integração manual (temas antigos)**

Para temas antigos sem suporte para incorporação de aplicações:

1. No editor de temas, adicione um botão ou uma ligação às páginas de produto
2. Crie uma ligação para a página do produto com o calendário Sesami ativo
3. Ou contacte o suporte para obter ajuda com a integração específica do tema

Consulte: [Configuração da loja online Shopify](https://help.sesami.co/pt/apps-integrations/shopify/online-store.md)
{% endhint %}

{% hint style="success" %}
**Dica profissional**: Adicione uma ligação de navegação «Reservar agora» ao menu principal, apontando para uma coleção de todos os serviços disponíveis para reserva.
{% endhint %}
{% endstep %}

{% step %}
**Teste o processo de ponta a ponta**

Antes de publicar, teste um processo de reserva completo:

1. **Abra a sua loja** numa janela de navegação anónima/privada (para ver a perspetiva do cliente)
2. **Aceda à página de um produto de serviço**
3. **Verifique se o calendário de reservas é apresentado** com os horários disponíveis
4. **Selecione uma data e uma hora**
5. **Adicione ao carrinho** e avance para o checkout
6. **Conclua a compra** (utilize o modo de teste da Shopify ou efetue uma reserva real)
7. **Verifique se a reserva aparece** em Reservas, no Sesami Admin
8. **Verifique em dispositivos móveis** - Teste o mesmo processo num dispositivo móvel

**O que verificar:**

* Os horários disponíveis correspondem à disponibilidade dos seus recursos
* O fuso horário correto é apresentado
* A reserva aparece atribuída ao recurso correto
* Os horários não se sobrepõem se reservar vários compromissos

{% hint style="warning" %}
**Se não forem apresentados horários disponíveis**, consulte a secção de resolução de problemas abaixo.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## Resolução de problemas

<details>

<summary>O calendário não aparece na página do produto</summary>

Verifique:

1. **A incorporação da aplicação Sesami está ativada** nas definições do tema
2. **O produto tem a etiqueta sesami-service** na Shopify
3. **O Sesami está ativado** nas definições do Sesami
4. Está a ver o **tema publicado** (não uma versão de rascunho/não publicada)
5. **O serviço está configurado** no Sesami com o produto associado

</details>

<details>

<summary>O serviço não está a funcionar ou apresenta erros</summary>

Verifique:

1. **O produto foi adicionado como serviço** no Sesami
2. **Os recursos estão atribuídos** ao serviço
3. **Os recursos necessários estão ativados** (não desativados)
4. **Formato da variante de duração** está correto (por exemplo, "30 Minutes", "1 Hour" — sem espaços extra, em inglês)
5. **"Product does not have a Duration option" -** A variante de duração tem de estar escrita em inglês, sem erros ortográficos.

</details>

<details>

<summary>Não são apresentados horários disponíveis</summary>

O problema mais comum! Verifique:

1. **Os recursos estão atribuídos** ao serviço (Passo 2)
2. **A disponibilidade está definida** para os recursos atribuídos (Passo 2)
3. **O período de reserva** permite reservas futuras (verifique as definições avançadas)
4. **Não existem bloqueios de horários** que cubram todas as datas disponíveis
5. **Os botões de compra estão ocultos ou foram removidos da página do produto**

Consulte: [Sem disponibilidade](https://help.sesami.co/pt/comecar/onboarding/troubleshooting/no-availability.md)

</details>

<details>

<summary>Erro: "Ocorreu um erro. Volte a carregar a página e tente novamente"</summary>

Ao usar variantes de duração, o nome da opção tem de ser exatamente **`Duration`** em inglês, sem erros ortográficos, palavras extra, traduções ou espaços antes ou depois.

O Sesami utiliza esta palavra-chave para identificar a duração da reserva. Se estiver configurada incorretamente, o processo de reserva poderá não funcionar como esperado.\
\
*\*A duração pode ser traduzida mais tarde.*

<figure><img src="https://2464016170-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2Fx6BZKDk5nIQ8cNHvE58z%2FScreenshot%202026-11-13%20at%2013.03.52.png?alt=media&amp;token=6ef86b60-4eed-4c8d-95d3-f0a7db0be081" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>O fuso horário parece incorreto</summary>

1. Aceda a **Sesami > Definições > Fuso horário**
2. Verifique se o fuso horário da loja corresponde à sua localização física
3. Verifique se a disponibilidade dos recursos está definida no fuso horário correto
4. Limpe a cache do navegador e teste no modo de navegação anónima

Consulte: [Fuso horário incompatível](https://help.sesami.co/pt/comecar/onboarding/troubleshooting/timezone-mismatch.md)

</details>

<details>

<summary>O comportamento no checkout é inesperado</summary>

Se o checkout for ignorado quando esperava que fosse apresentado (ou vice-versa):

1. Verifique se a **Reserva instantânea** está ativada (ignora o checkout)
2. Verifique as **definições dos depósitos** (podem alterar o fluxo de checkout)
3. Reveja os **preços dos produtos** (os produtos gratuitos podem ignorar o checkout)

Consulte: [Reserva instantânea](https://help.sesami.co/pt/reserva/booking-features/instant-booking.md) | [Depósitos](https://help.sesami.co/pt/pagamentos/deposits.md)

</details>

<details>

<summary>A reserva apresenta «Atribuída a: ninguém»</summary>

Isto acontece quando os horários ficam indisponíveis durante o checkout:

1. Ative o **Período de reserva** nas definições do Sesami
2. Ative a **Validação do carrinho** para verificar a disponibilidade antes do checkout

Consulte: [Resolução de problemas: «Atribuída a ninguém»](https://help.sesami.co/pt/comecar/onboarding/troubleshooting/troubleshooting-assigned-to-no-one-caused-by-invalid-order.md)

</details>

<details>

<summary>Os clientes veem erros como «Sessão expirada» ou «Ligação inválida»</summary>

Causas comuns:

1. **Ligações expiradas** - O cliente tentou reagendar ou cancelar após o prazo
2. **Cookies do navegador bloqueados** - Verifique as definições do navegador, sobretudo no Safari
3. **Problemas de cache** - Limpe a cache do navegador e tente novamente

Consulte: [Sessão expirada](https://help.sesami.co/pt/comecar/onboarding/troubleshooting/session-expired.md) | [Cookies do Safari](https://help.sesami.co/pt/comecar/onboarding/troubleshooting/safari-cookies.md) | [Erro de ligação inválida](https://help.sesami.co/pt/comecar/onboarding/troubleshooting/as-a-customer-why-am-i-seeing-an-invalid-link-error-page.md)

</details>

***

## Passos seguintes

Depois de ter as reservas básicas a funcionar, considere:

* [**Notificações por e-mail**](https://help.sesami.co/pt/notificacoes/notification-emails.md) - Configure e-mails de confirmação e lembrete
* [**Sincronização com o Google Calendar**](https://help.sesami.co/pt/apps-integrations/google-calendar.md) - Sincronização bidirecional com os calendários dos membros da equipa
* [**Reagendamento pelo cliente**](https://help.sesami.co/pt/reserva/booking-features/cancellations-rescheduling.md) - Permita que os clientes reagendem ou cancelem
* [**Marcações em grupo**](https://help.sesami.co/pt/reserva/booking-features/group-appointments.md) - Ative várias reservas por horário
* [**Depósitos**](https://help.sesami.co/pt/pagamentos/deposits.md) - Cobre um pagamento parcial no momento da reserva
* [**Ponto de venda**](https://help.sesami.co/pt/apps-integrations/shopify/pos.md) - Aceite reservas presencialmente

***

## Precisa de ajuda?

* [**Chamada de integração gratuita**](https://help.sesami.co/pt/comecar/onboarding/onboarding-call.md) - Marque uma sessão com a nossa equipa de Sucesso do Cliente
* [**Serviço de configuração personalizada**](https://help.sesami.co/pt/comecar/onboarding/white-glove-setup.md) - Obtenha ajuda profissional na integração e configuração do tema
* [**Serviços profissionais**](https://help.sesami.co/pt/comecar/onboarding/professional-services.md) - Desenvolvimento personalizado para requisitos específicos
* [**Suporte**](mailto:help@sesami.co) - Envie um e-mail para <help@sesami.co> para obter ajuda

## Relacionados

* [Guia de recursos](https://help.sesami.co/pt/admin/resources.md) - Configuração detalhada de recursos
* [Configuração da disponibilidade](https://help.sesami.co/pt/reserva/availability/resource-availability.md) - Opções avançadas de disponibilidade
* [Portal de administração da Sesami](https://help.sesami.co/pt/admin/sesami-admin-portal.md) - Visão geral da interface de administração
* [Configuração de serviços](https://help.sesami.co/pt/admin/services.md) - Definições avançadas de serviços


---

# 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/comecar/quickstart.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.
