# Início Rápido

## O que você vai configurar

* **Serviços** - Produtos da Shopify representando serviços agendá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 recursos
* **Integração da vitrine** - Botões de reserva e calendário na sua loja online

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

## Antes de começar

Certifique-se de ter:

* **Acesso de administrador** na sua loja Shopify
* **Uma lista de serviços** que você quer oferecer com:
  * Nome do serviço (ex.: "Massagem de 60 minutos", "Tosa para 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 dos recursos**:
  * Nomes dos membros da equipe e seus horários de trabalho
  * Requisitos de sala ou equipamento (se aplicável)

***

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

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

1. No admin da Shopify, vá para **Produtos > Adicionar produto**
2. Insira um **título de produto** claro e sem duração (ex.: "Corte de cabelo", "Massagem", "Consulta")
   * Mantenha o título simples - ele 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. **Salve** o produto

Repita para cada tipo de serviço que você quer oferecer.

{% hint style="success" %}
**Boa prática**: Use variações para diferentes durações do mesmo serviço. Por exemplo, um produto "Massagem" com as variações "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 o 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 da Shopify, os recursos estão rotulados como "Membros da equipe". Isso será atualizado para "Recursos" em uma próxima versão.
{% endhint %}

1. Abra **Sesami** no admin da Shopify
2. Navegue até **Membros da equipe** (Recursos)
3. Clique em **Adicionar membro da equipe** e crie seus recursos:
   * Para funcionários: adicione cada membro da equipe pelo nome (ex.: "Sarah", "Alex", "Jamie")
   * Para salas/equipamentos: adicione-os como membros da equipe por enquanto (ex.: "Sala 1", "Kit de câmera A")
4. Para cada recurso, defina sua **disponibilidade**:
   * Clique no nome do recurso
   * Vá para a **Disponibilidade** aba
   * Adicione regras de disponibilidade (ex.: segunda a sexta, 9h00 - 17h00)
   * **Salve** a agenda

**Exemplo de configuração:**

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

Veja: [Guia de recursos](/pt-br/admin/resources.md) | [Configuração de disponibilidade](/pt-br/reserva/availability/resource-availability.md)
{% endstep %}

{% step %}
**Vincular serviços aos recursos**

Informe 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 a **Recursos** seção
5. Escolha quais tipos de recursos são necessários:
   * Selecione **Membro da equipe** se o serviço exigir um funcionário
   * Selecione **Sala** se o serviço exigir um espaço físico
   * Selecione **Equipamento** se ferramentas específicas forem necessárias
6. Opcionalmente, atribua recursos específicos:
   * Marque **Apenas recursos específicos** para limitar o serviço a determinados membros da equipe ou salas
   * Deixe desmarcado para permitir qualquer recurso disponível desse tipo
7. **Salve**

**Exemplos de configuração:**

* **Corte de cabelo**: Requer "Cabeleireiro" (qualquer cabeleireiro pode fazê-lo)
* **Tratamento facial**: Requer "Esteticista" + "Sala de tratamento" (ambos necessários)
* **Treinamento particular**: Requer apenas o recurso específico "Personal Trainer - Sarah"

{% hint style="warning" %}
**Erro comum**: Se você não vincular nenhum recurso, nenhum horário disponível aparecerá! Todo serviço precisa ter pelo menos um tipo de recurso atribuído.
{% endhint %}
{% endstep %}

{% step %}
**Adicionar reserva à sua vitrine**

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

**Opção 1: Incorporação do app no tema (recomendado - temas modernos)**

A maioria dos temas Shopify 2.0 oferece suporte a incorporações de app:

1. No admin da Shopify, vá para **Loja online > Temas**
2. Clique em **Personalizar** no tema ativo
3. Clique em **Incorporações de app** (geralmente na barra lateral esquerda ou nas configurações do tema)
4. Ative a **Sesami** incorporação do app
5. **Salve**

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

{% hint style="warning" %}
**Observação importante:** O botão Comprar não pode ser ocultado ou removido do modelo do produto. \
O botão Comprar é necessário para exibir a disponibilidade de reservas no calendário. \
Se você preferir não exibir o botão Comprar para os clientes, pode ativar a opção “Adicionar automaticamente ao carrinho / Pular carrinho”. Isso remove o botão do fluxo de reserva.
{% endhint %}

**Opção 2: Integração manual (temas antigos)**

Para temas mais antigos sem suporte a incorporação de app:

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

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

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

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

Antes de entrar no ar, teste um fluxo completo de reserva:

1. **Abra sua loja** em uma janela anônima/privada do navegador (para ver a experiência 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 prossiga 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. **Verifique no celular** - Teste o mesmo fluxo em um dispositivo móvel

**O que verificar:**

* Os horários disponíveis correspondem à disponibilidade dos seus recursos
* O fuso horário correto é exibido
* A reserva aparece atribuída ao recurso correto
* Os horários não se sobrepõem se você fizer várias marcações

{% hint style="warning" %}
**Se nenhum horário 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. **A incorporação do app Sesami está ativada** nas Configurações do tema (Etapa 5)
2. **O produto tem a tag sesami-service** na 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 um serviço** no Sesami
2. **Os recursos estão atribuídos** ao serviço (Etapa 3)
3. **Os recursos exigidos estão ativados** (não desativados)
4. **O formato da variação de duração** está correto (ex.: "30 Minutes", "1 Hour" - sem espaços extras, em inglês)

</details>

<details>

<summary>Nenhum horário disponível aparecendo</summary>

O problema mais comum! Verifique:

1. **Os recursos estão atribuídos** ao serviço (Etapa 3)
2. **A disponibilidade está definida** para os recursos atribuídos (Etapa 2)
3. **O fuso horário está correto** nas Configurações do Sesami
4. **A janela de reserva** permite reservas futuras (verifique as configurações avançadas)
5. **Nenhum bloqueio** está cobrindo todas as datas disponíveis

Veja: [Sem disponibilidade](/pt-br/comece-agora/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/comece-agora/onboarding/troubleshooting/timezone-mismatch.md)

</details>

<details>

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

Se o checkout foi pulado quando você esperava que não fosse (ou vice-versa):

1. Verifique se **Reserva instantânea** está ativada (pula o checkout)
2. Verifique as **configurações de depósito** (podem alterar o fluxo de checkout)
3. Revise o **preço do produto** (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 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 de Atribuído a Ninguém](/pt-br/comece-agora/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 no Safari
3. **Problemas de cache** - Limpe o cache do navegador e tente novamente

Veja: [Sessão expirada](/pt-br/comece-agora/onboarding/troubleshooting/session-expired.md) | [Cookies do Safari](/pt-br/comece-agora/onboarding/troubleshooting/safari-cookies.md) | [Erro de link inválido](/pt-br/comece-agora/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 Calendar**](/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 remarquem 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 de onboarding gratuita**](/pt-br/comece-agora/onboarding/onboarding-call.md) - Agende uma sessão com nossa equipe de Sucesso do Cliente
* [**Serviço de configuração White-Glove**](/pt-br/comece-agora/onboarding/white-glove-setup.md) - Obtenha ajuda profissional com integração e configuração do tema
* [**Serviços profissionais**](/pt-br/comece-agora/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/admin/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 do admin do Sesami](/pt-br/admin/sesami-admin-portal.md) - Visão geral da interface de administração
* [Configuração de serviços](/pt-br/admin/services.md) - Configuraçõ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-br/comece-agora/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.