Welcome to the new Sesami Help Portal with AI capabilities. Search your question and get your answer instantly!
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Início rápido

Este guia leva você de "instalado" até a "primeira reserva" com o menor número 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

Tempo estimado: 15 a 30 minutos para uma configuração básica com um serviço e um membro da equipe.

Antes de começar

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)

1

Adicionar serviço ao Sesami

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

- no Sesami

  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

- 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

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

2

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.

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.

  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

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

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

3

Adicionar uma reserva à sua vitrine

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

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

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 para instruções de integração.

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

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.

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

4

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


Solução de problemas

O calendário não aparece na página do produto

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

O serviço não está funcionando ou exibe erros

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.

Nenhum horário disponível sendo exibido

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

O fuso horário parece errado
  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

O comportamento do checkout está inesperado

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 | Depósitos

A reserva mostra "Atribuído a: ninguém"

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


Próximas etapas

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


Precisa de ajuda?

Relacionado

Atualizado

Isto foi útil?