> 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-br/primeiros-passos/quickstart.md).

# Início Rápido

Este guia leva você de "instalado" à "primeira reserva" com o mínimo de etapas.

## O que você vai configurar

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

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

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

Certifique-se de que você tem:

* **Acesso de administrador** na sua loja Shopify
* **Uma lista de serviços** que você quer oferecer:
  * Nome do serviço (por exemplo, "Massagem de 60 minutos", "Tosa para cães")
  * Duração (por exemplo, 30 minutos, 1 hora, 2 horas)
  * Preço
* **Informações do recurso**:
  * Nomes dos membros da equipe e seus horários de trabalho
  * Requisitos de sala ou equipamento (se aplicável)

<figure><img src="https://3937878330-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 serviço ao Sesami**

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

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

1. Insira um **título** claro (por exemplo, "Corte de cabelo", "Massagem", "Consulta")

   Mantenha o título simples — isso 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://3937878330-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 admin do Shopify, vá para **Produtos > Adicionar produto**
2. Insira 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 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 **Salvar** para criar o produto

<figure><img src="https://3937878330-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 para cada tipo de serviço que você quer oferecer.

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

{% step %}

### **Criar recursos e definir disponibilidade**

Recursos são o que seu serviço precisa para acontecer — membros da equipe, salas, equipamentos etc. Você vai criá-los e definir sua disponibilidade.

{% hint style="info" %}
**Observação**: Na interface atual do admin do Shopify, os recursos são rotulados como "Membros da equipe". Isso será atualizado para "Recursos" em um lançamento futuro.
{% endhint %}

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

**Exemplo de configuração:**

* Membro da equipe "Sarah" → Disponível de segunda a sexta, das 9h às 17h
* Sala "Sala de tratamento 1" → Disponível de segunda a sábado, das 8h às 20h

{% hint style="info" %}
**É bom saber:** Não se preocupe se ainda não tiver configurado todos os seus recursos. Você pode definir a disponibilidade de um único recurso agora e depois criar recursos adicionais ou atualizar a disponibilidade dos recursos existentes mais tarde em [**Portal de administração: Recursos**](/pt-br/administracao/resources.md).
{% endhint %}

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

### **Adicionar uma reserva à sua vitrine**

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

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

**Theme App Embed (Recomendado - temas modernos) - A maioria dos temas Shopify 2.0 oferece suporte a embeds de apps**

{% hint style="info" %}
**Opcional:** Se você estiver usando um tema mais antigo do Shopify, uma vitrine headless (como Hydrogen) ou um site personalizado, você pode pular esta etapa e consultar nossos [docs de desenvolvimento](https://sesami.dev/docs/sesami-experience/shopify-integration/intro/) para instruções de integração.
{% endhint %}

#### **Etapa 1: ativar o app embed**

1. No painel do Sesami, clique em **Personalizar tema** na seção **Incorporar experiência de reserva** .
2. Isso abrirá o editor de temas com o painel **Embeds de apps** (normalmente na barra lateral esquerda ou nas configurações do tema)
3. Localize o **Sesami Booking App** e ative o botão para permitir que o app seja incorporado ao seu tema.
4. **Salvar**

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

#### **Etapa 2: adicionar ao produto**

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

O widget de reserva agora aparecerá nas páginas de produtos da sua loja, permitindo que os clientes selecionem horários disponíveis.

<div><figure><img src="https://3937878330-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://3937878330-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 a app embed:

1. No editor do tema, adicione um botão ou link às páginas de produto
2. Link para a página de produto com o calendário do Sesami ativo
3. Ou entre em contato com o suporte para obter ajuda de integração específica do tema

Veja: [Configuração da loja virtual Shopify](/pt-br/apps-integrations/shopify/online-store.md)
{% endhint %}

{% hint style="success" %}
**Dica de especialista**: Adicione um link de navegação "Reservar agora" no menu principal apontando para uma coleção de todos os serviços reserváveis.
{% endhint %}
{% endstep %}

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

Antes de ir ao ar, teste um fluxo completo de reserva:

1. **Abra sua loja** em uma janela anônima/privada do navegador (para ver a visão do cliente)
2. **Navegue até a página de um produto de 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 siga para o checkout
6. **Conclua a compra** (use o modo de teste do Shopify ou faça uma reserva real)
7. **Verifique se a reserva aparece** no admin do Sesami em Reservas
8. **Verificar no celular** - Teste o mesmo fluxo em um dispositivo móvel

**O que verificar:**

* Os horários disponíveis correspondem à disponibilidade do seu recurso
* O fuso horário correto é exibido
* A reserva aparece atribuída ao recurso correto
* Os horários não se sobrepõem se você reservar vários agendamentos

{% hint style="warning" %}
**Se nenhum horário disponível aparecer**, veja a seção de solução de problemas abaixo.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## Solução de problemas

<details>

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

Verifique:

1. **O app embed do Sesami está ativado** nas Configurações do tema
2. **O produto tem a tag sesami-service** no Shopify
3. **O Sesami está ativado** nas Configurações do Sesami
4. Você está visualizando o **tema publicado** (não uma versão de rascunho/não publicada)
5. **O serviço está configurado** no Sesami com o produto vinculado

</details>

<details>

<summary>O serviço não está funcionando ou exibe 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. **O formato da variante de duração** está correto (por exemplo, "30 Minutes", "1 Hour" — sem espaços extras, em inglês)
5. **"Product does not have a Duration option" -** A variante de duração deve ser escrita em inglês, sem erros de digitação.

</details>

<details>

<summary>Nenhum horário disponível sendo exibido</summary>

O problema mais comum! Verifique:

1. **Os recursos estão atribuídos** ao serviço (Etapa 2)
2. **A disponibilidade está definida** para os recursos atribuídos (Etapa 2)
3. **A janela de reserva** permite reservas futuras (verifique as configurações avançadas)
4. **Nenhum bloqueio de agenda** está cobrindo todas as datas disponíveis
5. **Os botões de compra estão ocultos ou removidos na página do produto**

Veja: [Sem disponibilidade](/pt-br/primeiros-passos/onboarding/troubleshooting/no-availability.md)

</details>

<details>

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

1. Vá para **Sesami > Configuraçõ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 o cache do navegador e teste no modo anônimo

Veja: [Incompatibilidade de fuso horário](/pt-br/primeiros-passos/onboarding/troubleshooting/timezone-mismatch.md)

</details>

<details>

<summary>O comportamento do checkout está inesperado</summary>

Se o checkout foi ignorado quando você esperava que fosse executado (ou vice-versa):

1. Verifique se **Reserva instantânea** está ativada (ignora o checkout)
2. Verifique **as configurações de depósito** (pode alterar o fluxo de checkout)
3. Revise o produto **preço** (produtos gratuitos podem pular o checkout)

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

</details>

<details>

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

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

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

Veja: [Solução de problemas: atribuído a ninguém](/pt-br/primeiros-passos/onboarding/troubleshooting/troubleshooting-assigned-to-no-one-caused-by-invalid-order.md)

</details>

<details>

<summary>Os clientes veem erros "Sessão expirada" ou "Link inválido"</summary>

Causas comuns:

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

Veja: [Sessão expirada](/pt-br/primeiros-passos/onboarding/troubleshooting/session-expired.md) | [Cookies do Safari](/pt-br/primeiros-passos/onboarding/troubleshooting/safari-cookies.md) | [Erro de link inválido](/pt-br/primeiros-passos/onboarding/troubleshooting/as-a-customer-why-am-i-seeing-an-invalid-link-error-page.md)

</details>

***

## Próximas etapas

Depois que as reservas básicas estiverem funcionando, considere:

* [**Notificações por e-mail**](/pt-br/notificacoes/notification-emails.md) - Configure e-mails de confirmação e lembrete
* [**Sincronização com o Google Agenda**](/pt-br/apps-integrations/google-calendar.md) - Sincronização bidirecional com os calendários dos membros da equipe
* [**Reagendamento pelo cliente**](/pt-br/reserva/booking-features/cancellations-rescheduling.md) - Permita que os clientes reagendem ou cancelem
* [**Agendamentos em grupo**](/pt-br/reserva/booking-features/group-appointments.md) - Ative várias reservas por intervalo de tempo
* [**Depósitos**](/pt-br/pagamentos/deposits.md) - Cobrar pagamento parcial no momento da reserva
* [**Ponto de venda**](/pt-br/apps-integrations/shopify/pos.md) - Faça reservas presencialmente

***

## Precisa de ajuda?

* [**Ligação gratuita de onboarding**](/pt-br/primeiros-passos/onboarding/onboarding-call.md) - Agende uma sessão com nossa equipe de Sucesso do Cliente
* [**Serviço de configuração white-glove**](/pt-br/primeiros-passos/onboarding/white-glove-setup.md) - Obtenha ajuda profissional com a integração e configuração do tema
* [**Serviços profissionais**](/pt-br/primeiros-passos/onboarding/professional-services.md) - Desenvolvimento personalizado para requisitos exclusivos
* [**Suporte**](mailto:help@sesami.co) - Envie um e-mail para <help@sesami.co> para obter assistência

## Relacionado

* [Guia de recursos](/pt-br/administracao/resources.md) - Configuração detalhada de recursos
* [Configuração de disponibilidade](/pt-br/reserva/availability/resource-availability.md) - Opções avançadas de disponibilidade
* [Portal de administração do Sesami](/pt-br/administracao/sesami-admin-portal.md) - Visão geral da interface de administração
* [Configuração de serviços](/pt-br/administracao/services.md) - Configuraçõ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-br/primeiros-passos/quickstart.md?ask=<question>&goal=<endgoal>
```

`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.