> 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
## 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 serviços
* **Disponibilidade** - Horário de trabalho e regras de agendamento para recursos
* **Integração da 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:
* Nome do serviço (por ex., "Massagem de 60 Minutos", "Tosquia de Cães")
* Duração (por ex., 30 minutos, 1 hora, 2 horas)
* Preço
* **Informações do recurso**:
* Nomes dos membros da equipa e respetivo horário de trabalho
* Requisitos de sala ou equipamento (se aplicável)
{% stepper %}
{% step %}
### **Adicionar serviço ao Sesami**
**Pode criar um serviço diretamente no Sesami ou adicionar um produto existente da Shopify.**
#### **- no Sesami**
1. Introduza um **título** claro (por ex., "Corte de cabelo", "Massagem", "Consulta")
Mantenha o título simples - isto aparece nas confirmações de reserva e nos calendários
2. Adicione a **descrição**
3. Adicione **variante "duração", unidade,** e **preço**\
Crie variantes como "30 Minutos", "1 Hora", "90 Minutos"
4. Clique para **criar o serviço**
#### **- na Shopify**
1. No seu Admin da Shopify, vá 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 suas 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
Repita para cada tipo de serviço que pretende oferecer.
{% hint style="success" %}
**Melhor prática**: Use 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 o que o seu serviço precisa para acontecer - membros da equipa, salas, equipamento, etc. Vai criá-los e definir a respetiva disponibilidade.
{% hint style="info" %}
**Nota**: Na interface atual do Admin da Shopify, os recursos estão identificados como "Membros da Equipa". Isto será atualizado para "Recursos" numa próxima versão.
{% endhint %}
1. Adicione a **Recurso** nome e o **Tipo de recurso**
* Para a equipa: Adicione cada membro da equipa pelo nome (por ex., "Sarah", "Alex", "Jamie")
* Para salas/equipamento: Adicione-os por agora como membros da equipa (por ex., "Sala 1", "Kit de Câmara A")
2. Defina o seu **Horário de trabalho** e adicione as regras de disponibilidade (por ex., segunda a sexta, 9:00 - 17:00)
3. **Clique para criar o recurso**
**Exemplo de configuração:**
* Membro da equipa "Sarah" → Disponível de segunda a sexta, 9:00 - 17:00
* Sala "Sala de Tratamento 1" → Disponível de segunda a sábado, 8:00 - 20:00
{% hint style="info" %}
**É bom saber:** Não se preocupe se ainda não tiver configurado todos os recursos. Pode definir agora a disponibilidade de um único recurso e, depois, criar recursos adicionais ou atualizar a disponibilidade de recursos existentes mais tarde no [**Portal de Administração: Recursos**](/pt/administracao/resources.md).
{% endhint %}
{% endstep %}
{% step %}
### **Adicione uma reserva à sua loja online**
Torne o calendário de reservas acessível aos clientes na sua loja online
**Incorporação da app no tema (Recomendado - Temas modernos) - A maioria dos temas Shopify 2.0 suporta incorporações de apps**
{% hint style="info" %}
**Opcional:** Se estiver a usar um tema Shopify mais antigo, uma storefront headless (como o Hydrogen) ou um site personalizado, pode ignorar este passo e consultar os nossos [Documentos de Programação](https://sesami.dev/docs/sesami-experience/shopify-integration/intro/) para instruções de integração.
{% endhint %}
#### **Passo 1: Ativar a incorporação da app**
1. No painel do Sesami, clique em **Personalizar tema** na **Incorporar experiência de reserva** secção.
2. Irá abrir o Editor de Temas com o painel **Incorporações de apps** (normalmente na barra lateral esquerda ou nas definições do tema)
3. Localize a **App de Reserva Sesami** e ative o interruptor para permitir que a app seja incorporada no seu tema.
4. **Guardar**
#### **Passo 2: Adicionar ao produto**
1. De seguida, adicione o bloco de reserva do Sesami ao modelo do seu produto, abrindo um modelo de produto
2. Na **Informações do produto** secção, clique em **Adicionar bloco** e selecione o **botão de reserva Sesami**
3. Coloque o bloco acima dos botões de compra
4. **Guardar** as alterações do seu tema.
O widget de reserva passará agora a aparecer nas páginas de produtos da sua loja online, permitindo aos clientes selecionar horários de reserva disponíveis.
{% hint style="info" %}
**Integração manual (Temas mais antigos)**
Para temas mais antigos sem suporte para incorporação de apps:
1. No editor do tema, adicione um botão ou link à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 de integração específica para o tema
Ver: [Configuração da Loja Online da Shopify](/pt/apps-integrations/shopify/online-store.md)
{% endhint %}
{% hint style="success" %}
**Dica de especialista**: Adicione um link de navegação "Reservar agora" no seu menu principal apontando para uma coleção de todos os serviços reserváveis.
{% endhint %}
{% endstep %}
{% step %}
**Teste de ponta a ponta**
Antes de colocar 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 produto de um serviço**
3. **Verifique se o calendário de reservas aparece** com horários disponíveis
4. **Selecione uma data e hora**
5. **Adicione ao carrinho** e avance no 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. **Verifique no telemóvel** - Teste o mesmo fluxo num dispositivo móvel
**O que verificar:**
* Os horários 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 reservar várias marcações
{% hint style="warning" %}
**Se não aparecerem horários disponíveis**, consulte a secção de resolução de problemas abaixo.
{% endhint %}
{% endstep %}
{% endstepper %}
***
## Resolução de problemas
O calendário não aparece na página do produto
Verifique:
1. **A incorporação da app Sesami está ativada** nas Definições do tema
2. **O produto tem uma 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 ligado
O serviço não está a funcionar ou apresenta erros
Verifique:
1. **O produto foi adicionado como um 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. **O formato da variante de duração** está correto (por ex., "30 Minutos", "1 Hora" - sem espaços extra, em inglês)
5. **"O produto não tem uma opção Duração" -** A variante de duração tem de ser escrita em inglês, sem erros tipográficos.
Não são apresentados horários disponíveis
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. **A janela de reserva** permite reservas futuras (verifique as definições avançadas)
4. **Não existem bloqueios** a cobrir todas as datas disponíveis
5. **Os botões de compra estão ocultos ou removidos na página do produto**
Ver: [Sem disponibilidade](/pt/comecar/onboarding/troubleshooting/no-availability.md)
O fuso horário parece estar incorreto
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. Confirme se a disponibilidade do recurso está definida no fuso horário correto
4. Limpe a cache do navegador e teste no modo anónimo
Ver: [Incompatibilidade de fuso horário](/pt/comecar/onboarding/troubleshooting/timezone-mismatch.md)
O comportamento do checkout é inesperado
Se o checkout for ignorado quando esperava que não fosse (ou vice-versa):
1. Verifique se **Reserva instantânea** está ativada (salta o checkout)
2. Verifique **as definições de depósito** (pode alterar o fluxo de checkout)
3. Reveja o produto **preços** (produtos gratuitos podem saltar o checkout)
Ver: [Reserva instantânea](/pt/reserva/booking-features/instant-booking.md) | [Depósitos](/pt/pagamentos/deposits.md)
A reserva mostra "Atribuído a: Ninguém"
Isto acontece quando os horários deixam de estar disponíveis durante o checkout:
1. Ative **Período de reserva** nas Definições do Sesami
2. Ative **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)
Os clientes veem erros "Sessão expirada" ou "Ligação inválida"
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)
***
## Próximos passos
Assim que tiver as reservas básicas a funcionar, considere:
* [**Notificações por email**](/pt/notificacoes/notification-emails.md) - Configure emails 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 por clientes**](/pt/reserva/booking-features/cancellations-rescheduling.md) - Permita que os clientes reagendem ou cancelem
* [**Marcações de grupo**](/pt/reserva/booking-features/group-appointments.md) - Ative várias reservas por intervalo de tempo
* [**Depósitos**](/pt/pagamentos/deposits.md) - Cobrar pagamento parcial no momento da reserva
* [**Ponto de Venda**](/pt/apps-integrations/shopify/pos.md) - Faça 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 premium**](/pt/comecar/onboarding/white-glove-setup.md) - Obtenha ajuda profissional com a integração do tema e a configuração
* [**Serviços profissionais**](/pt/comecar/onboarding/professional-services.md) - Desenvolvimento personalizado para requisitos únicos
* [**Suporte**](mailto:help@sesami.co) - Envie um email para para obter 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 Administração 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
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, and the optional `goal` query parameter:
```
GET https://help.sesami.co/pt/comecar/quickstart.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.