# Início Rápido

## O que vai configurar

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

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

## Antes de começar

Certifique-se de que tem:

* **Acesso de administrador** na sua loja Shopify
* **Uma lista de serviços** que pretende oferecer com:
  * Nome do serviço (ex.: "Massagem de 60 Minutos", "Tosquia de Cães")
  * Duração (ex.: 30 minutos, 1 hora, 2 horas)
  * Preço
  * Capacidade (número de reservas simultâneas, se aplicável)
* **Informações sobre recursos**:
  * Nomes dos membros da equipa e respetivos horários de trabalho
  * Requisitos de sala ou equipamento (se aplicável)

***

{% stepper %}
{% step %}
**Criar produtos de serviço na Shopify**

Crie um produto Shopify para cada serviço reservável:

1. No Admin da Shopify, vá a **Produtos > Adicionar produto**
2. Introduza um **título de produto** claro, sem duração (ex.: "Corte de Cabelo", "Massagem", "Consulta")
   * Mantenha o título simples - isto aparece nas confirmações de reserva e nos calendários
3. Adicione **variações para diferentes durações**:
   * Clique em **Adicionar variação**
   * Crie variações como "30 Minutos", "1 Hora", "90 Minutos"
   * Defina o preço para cada variação de duração
4. Adicione uma descrição, imagens e outros detalhes do produto conforme necessário
5. **Guarde** o produto

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

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

{% step %}
**Criar recursos e definir disponibilidade**

Os recursos são o que o seu serviço precisa para acontecer - membros da equipa, salas, equipamentos, etc. Vai criá-los e definir a respetiva disponibilidade.

{% hint style="info" %}
**Nota**: Na interface atual do Admin da Shopify, os recursos são rotulados como "Membros da Equipa". Isto será atualizado para "Recursos" numa próxima versão.
{% endhint %}

1. Abra **Sesami** no Admin da Shopify
2. Navegue até **Membros da Equipa** (Recursos)
3. Clique em **Adicionar Membro da Equipa** e crie os seus recursos:
   * Para staff: Adicione cada membro da equipa pelo nome (ex.: "Sarah", "Alex", "Jamie")
   * Para salas/equipamento: Adicione-os temporariamente como membros da equipa (ex.: "Sala 1", "Kit de Câmara A")
4. Para cada recurso, defina a sua **disponibilidade**:
   * Clique no nome do recurso
   * Vá para o separador **Disponibilidade** separador
   * Adicione regras de disponibilidade (ex.: segunda a sexta-feira, 9:00 - 17:00)
   * **Guarde** o horário

**Exemplo de configuração:**

* Membro da equipa "Sarah" → Disponível de segunda a sexta-feira, 9h - 17h
* Sala "Sala de Tratamento 1" → Disponível de segunda a sábado, 8h - 20h

Ver: [Guia de Recursos](/pt/administracao/resources.md) | [Configuração da Disponibilidade](/pt/reserva/availability/resource-availability.md)
{% endstep %}

{% step %}
**Ligar serviços a recursos**

Diga ao Sesami quais recursos são necessários para cada serviço:

1. Abra **Sesami** no Admin da Shopify
2. Navegue até **Serviços**
3. Selecione um produto de serviço
4. Vá para o separador **Recursos** seção
5. Escolha que tipos de recurso são necessários:
   * Selecione **Membro da equipa** se o serviço requerer um membro do staff
   * Selecione **Sala** se o serviço requerer um espaço físico
   * Selecione **Equipamento** se forem necessárias ferramentas específicas
6. Opcionalmente, atribua recursos específicos:
   * Marque **Apenas recursos específicos** para limitar o serviço a certos membros da equipa ou salas
   * Deixe desmarcado para permitir qualquer recurso disponível desse tipo
7. **Guarde**

**Exemplos de configuração:**

* **Corte de Cabelo**: Requer "Cabeleireiro" (qualquer cabeleireiro pode fazê-lo)
* **Tratamento Facial**: Requer "Esteticista" + "Sala de Tratamento" (ambos necessários)
* **Treino Privado**: Requer apenas o recurso específico "Personal Trainer - Sarah"

{% hint style="warning" %}
**Erro comum**: Se não ligar quaisquer recursos, não aparecerão faixas de disponibilidade! Cada serviço tem de ter pelo menos um tipo de recurso atribuído.
{% endhint %}
{% endstep %}

{% step %}
**Adicionar reserva à sua loja online**

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

**Opção 1: Incorporação da App no Tema (Recomendado - Temas Modernos)**

A maioria dos temas Shopify 2.0 suporta incorporações de apps:

1. No Admin da Shopify, vá a **Loja Online > Temas**
2. Clique em **Personalizar** no seu tema ativo
3. Clique em **Incorporações da app** (normalmente na barra lateral esquerda ou nas definições do tema)
4. Ative a **Sesami** incorporação da app
5. **Guarde**

O calendário de reservas passará agora a aparecer automaticamente nas páginas dos produtos de serviço.

{% hint style="warning" %}
**Nota Importante:** O botão Comprar não pode ser ocultado ou removido do modelo do produto. \
O botão Comprar é necessário para apresentar a disponibilidade de reservas no calendário. \
Se preferir não mostrar o botão Comprar aos clientes, pode ativar a opção “Adicionar automaticamente ao carrinho / Ignorar carrinho”. Isto remove o botão do fluxo de reserva.
{% endhint %}

**Opção 2: Integração Manual (Temas Antigos)**

Para temas antigos sem suporte para incorporação de apps:

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

Ver: [Configuração da Loja Online da Shopify](/pt/apps-integrations/shopify/online-store.md)

{% hint style="success" %}
**Dica profissional**: Adicione uma ligação de navegação "Reservar Agora" no seu menu principal, apontando para uma coleção de todos os serviços reserváveis.
{% endhint %}
{% endstep %}

{% step %}
**Testar de ponta a ponta**

Antes de entrar em produção, teste um fluxo completo de reserva:

1. **Abra a sua loja** numa janela de navegação anónima/privada (para ver a vista do cliente)
2. **Navegue até à página de um produto de serviço**
3. **Verifique se o calendário de reservas aparece** com faixas horárias disponíveis
4. **Selecione uma data e hora**
5. **Adicionar ao carrinho** e avance para o checkout
6. **Conclua a compra** (use o modo de teste da Shopify ou faça uma reserva real)
7. **Verifique se a reserva aparece** no Admin do Sesami em Reservas
8. **Verificar no telemóvel** - Teste o mesmo fluxo num dispositivo móvel

**O que verificar:**

* As faixas horárias disponíveis correspondem à disponibilidade do seu recurso
* O fuso horário correto é apresentado
* A reserva aparece atribuída ao recurso correto
* Os horários não se sobrepõem se fizer várias marcações

{% hint style="warning" %}
**Se não aparecerem faixas horárias**, 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 app Sesami está ativada** nas Definições do Tema (Passo 5)
2. **O produto tem a etiqueta sesami-service** na Shopify
3. **O Sesami está ativado** nas Definições do Sesami
4. Está a visualizar o **tema publicado** (não uma versão em rascunho/não publicada)
5. **O serviço está configurado** no Sesami com o produto ligado

</details>

<details>

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

Verifique:

1. **O produto foi adicionado como um serviço** no Sesami
2. **Os recursos estão atribuídos** ao serviço (Passo 3)
3. **Os recursos necessários estão ativados** (não desativados)
4. **O formato da variação de duração** está correto (ex.: "30 Minutos", "1 Hora" - sem espaços extra, em inglês)

</details>

<details>

<summary>Não estão a ser mostradas faixas horárias disponíveis</summary>

O problema mais comum! Verifique:

1. **Os recursos estão atribuídos** ao serviço (Passo 3)
2. **A disponibilidade está definida** para os recursos atribuídos (Passo 2)
3. **O fuso horário está correto** nas Definições do Sesami
4. **A janela de reserva** permite reservas futuras (verifique as definições avançadas)
5. **Não há bloqueios** a cobrir todas as datas disponíveis

Ver: [Sem Disponibilidade](/pt/comecar/onboarding/troubleshooting/no-availability.md)

</details>

<details>

<summary>O fuso horário parece estar errado</summary>

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

Ver: [Incompatibilidade de Fuso Horário](/pt/comecar/onboarding/troubleshooting/timezone-mismatch.md)

</details>

<details>

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

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

1. Verifique se **Reserva Instantânea** está ativada (ignora o checkout)
2. Verifique as **definições de depósito** (podem alterar o fluxo de checkout)
3. Reveja o **preço do produto** (produtos gratuitos podem ignorar o checkout)

Ver: [Reserva Instantânea](/pt/reserva/booking-features/instant-booking.md) | [Depósitos](/pt/pagamentos/deposits.md)

</details>

<details>

<summary>A reserva mostra "Atribuído a: Ninguém"</summary>

Isto acontece quando as faixas horárias ficam indisponíveis durante o checkout:

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

Ver: [Resolução de problemas de Atribuído a Ninguém](/pt/comecar/onboarding/troubleshooting/troubleshooting-assigned-to-no-one-caused-by-invalid-order.md)

</details>

<details>

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

Causas comuns:

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

Ver: [Sessão Expirada](/pt/comecar/onboarding/troubleshooting/session-expired.md) | [Cookies do Safari](/pt/comecar/onboarding/troubleshooting/safari-cookies.md) | [Erro de Ligação Inválida](/pt/comecar/onboarding/troubleshooting/as-a-customer-why-am-i-seeing-an-invalid-link-error-page.md)

</details>

***

## Próximos Passos

Assim que tiver as reservas básicas a funcionar, considere:

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

***

## Precisa de ajuda?

* [**Chamada de Onboarding Gratuita**](/pt/comecar/onboarding/onboarding-call.md) - Marque uma sessão com a nossa equipa de Sucesso do Cliente
* [**Serviço de Configuração White-Glove**](/pt/comecar/onboarding/white-glove-setup.md) - Obtenha ajuda profissional com a integração e configuração do tema
* [**Serviços Profissionais**](/pt/comecar/onboarding/professional-services.md) - Desenvolvimento personalizado para requisitos exclusivos
* [**Suporte**](mailto:help@sesami.co) - Envie um e-mail para <help@sesami.co> para assistência

## Relacionado

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


---

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