> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.hoppyapps.com/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # O Calendário de Agendamento Não Aparece na Minha Loja [Resolvido] > ℹ️ **Note:** Este artigo foi traduzido automaticamente utilizando IA e pode conter imprecisões. Se algo parecer errado, entre em contato com nossa equipe de suporte. O calendário de reservas geralmente começa a funcionar logo após a configuração — mas, às vezes, uma pequena configuração, tema ou definição de disponibilidade pode impedir que ele apareça na sua loja. A boa notícia é que estes problemas costumam ser muito rápidos de resolver 🚀 Este guia percorre as razões mais comuns pelas quais o calendário de reservas (ou o botão **Book Now** (Reservar agora)) pode não aparecer, e como resolver cada uma passo a passo. Na maioria dos casos, o problema está relacionado com um dos seguintes: * **App Embed** (Incorporação da app) está desativado * O serviço não foi guardado, foi desativado ou arquivado * Está a ver a página de produto ou variante errada * As variantes do produto foram alteradas depois de o serviço ter sido criado * Está a pré-visualizar um tema de rascunho (não publicado) * Conflitos com tema personalizado ou construtor de páginas * As definições de disponibilidade estão a ocultar todas as datas * Os horários estão totalmente reservados ou os limites de reserva foram atingidos * Cache do navegador ou da loja Vamos percorrê-los um a um 👇 --- # **✅ Passo 1: Verifique se o App Embed está ativo** Para que o calendário de reservas apareça na sua loja, o app embed deve estar ativo no seu tema Shopify. Esta é a causa mais comum. A forma mais rápida de verificar é dentro da própria app: Abra a app **Hoppy Appointments** → na **dashboard/homepage** (página inicial / painel de controlo), encontre o cartão **App Status** (Estado da app). * **Active** (Ativo) → O app embed está ativo ✅ * **Inactive** (Inativo) → Clique em **Activate** (Ativar) — isso leva-o diretamente ao editor do tema Para ativar manualmente, vá a: **Shopify Admin → Online Store → Themes → Customize → App Embeds** Em seguida: * Encontre “**Appointment Bookings**” * Ative o toggle * Clique em **Save** (Guardar) Dica: Se já estava ativo, experimente desativar (OFF) → **Save** → ativar (ON) → **Save** novamente e depois atualize a sua loja. Depois deste passo, o botão **Book Now** deverá aparecer na página de produto associada ao seu serviço. --- # **✅ Passo 2: Certifique-se de que o Serviço está Guardado e Ativo** Mesmo com o app embed ativo, um serviço só aparece na sua loja quando está **guardado** e **ativo**. Abra a app → **dashboard/homepage** e verifique o estado junto ao seu serviço: * **Inactive** (Inativo) → Abra o menu **More** (Mais) → **Turn on** (Ativar) * **Archived** (Arquivado) → Abra o menu **More** → **Unarchive** (Desarquivar) e certifique-se de que está ativado Depois, abra o serviço e clique em **Save** — mesmo que não tenha alterado nada. Guardar ressincroniza o serviço com a sua loja, o que resolve a maioria dos casos de “antes funcionava”. Depois de guardar, aparece um banner no topo da página: * **“Make sure Appointment Booking App Embed is active”** → Clique em **Enable App Embed** (Ativar app embed) (consulte o Passo 1\) * **“Confirm Appointment Booking is published successfully”** → Clique em **Open Store** (Abrir loja) para verificar o resultado ℹ️ Se o botão **Book Now** abrir uma popup em branco ou vazia, o serviço geralmente está desativado ou arquivado — este passo também resolve isso. --- # **✅ Passo 3: Confirme que está na Página de Produto e Variante Certas** O botão **Book Now** só aparece na página de produto associada ao seu serviço — não noutros produtos. Abra o seu serviço → separador **General** (Geral) → cartão **Booking** (Reserva) e confirme qual o produto selecionado. Exemplo: Se o seu serviço está associado a “Guitar Lesson” mas está a ver a página de produto “Drum Lesson”, o botão não aparecerá aí. Se o produto tiver **multiple variants** (várias variantes), experimente também alternar entre variantes na loja. ⚠️ Importante: Se editou, eliminou ou recriou as variantes do produto no Shopify **depois** de configurar o serviço, a ligação pode ficar desatualizada. A solução é simples: → Abra o serviço → Clique em **Change** (Alterar) → Selecione as variantes corretas depois de modificar as variantes do produto → Clique em **Save** (Guardar) Isto ressincroniza as informações mais recentes do produto e das variantes com a sua loja. --- # **✅ Passo 4: Verifique no Seu Tema Publicado e Ativo** O app embed é verificado — e o calendário é exibido — apenas no seu **tema publicado e ativo**. Isto significa: * Ativar o app embed enquanto edita um **draft or unpublished theme** (tema de rascunho ou não publicado) não fará o calendário aparecer na sua loja ativa * Se mudou recentemente para um **new theme** (novo tema), o app embed permanece desativado nesse tema até o voltar a ativar (consulte o Passo 1\) Teste sempre na sua loja ativa: → Abra a sua loja num separador normal do navegador, e não apenas na pré-visualização do editor de temas. --- # **✅ Passo 5: Atualização Forçada e Janela Anónima** Às vezes, o Shopify ou o seu navegador armazenam temporariamente em cache os elementos da loja. Uma atualização forçada resolve isso normalmente de imediato. ### **Windows** `Ctrl + Shift + R` ### **Mac** `Cmd + Shift + R` Experimente também: * Abrir a sua loja numa **janela anónima / privada** * Testar noutro navegador ou no seu telemóvel Isto confirma se o problema é apenas conteúdo em cache. --- # **✅ Passo 6: Está a Usar um Tema Personalizado ou um Construtor de Páginas?** A maioria dos temas Shopify funciona com o Hoppy Appointments sem configuração adicional — a app substitui automaticamente o botão **Add to Cart** (Adicionar ao carrinho) pelo botão **Book Now** nas páginas de produtos reserváveis. No entanto, temas fortemente personalizados ou temas criados com construtores de páginas podem utilizar formulários de produto não padrão, que a app nem sempre consegue detetar. Nesse caso, coloque o calendário manualmente: Abra o **Shopify Theme Editor** (Editor de temas Shopify) → Navegue para a página pretendida → **Add Block** (Adicionar bloco) → **Apps** → **Appointment Calendar** (Calendário de agendamentos) Em seguida: * Cole o seu **Service ID** (ID do serviço) → Encontre-o no topo da página de edição do serviço, ou através de **My services** (Os meus serviços) → **More** → **Copy Service ID** (Copiar ID do serviço) * Escolha o **Embedding Mode** (Modo de incorporação): * **Modal** → Mostra um cartão de reserva que abre o calendário numa popup * **Direct** (Direto) → Incorpora o calendário completo diretamente na página * Clique em **Save** no tema O bloco também indica quando algo está errado: * **“App Embed Not Enabled”** → Volte ao Passo 1 — o app embed é necessário mesmo para a colocação manual * **“Appointment service configuration not found”** → Verifique novamente o **Service ID** que colou 💡 Alternativa: ative o **Floating Action Button** (Botão de ação flutuante) dentro do seu serviço (**General tab** (separador Geral) → **Enable floating button** (Ativar botão flutuante)) para mostrar um botão flutuante **Book Now** em todas as páginas da loja. Lembre-se de **Save** o serviço depois. --- # **✅ Passo 7: O Calendário Abre mas Não Mostra Datas/Horários? Verifique a Disponibilidade** Se a popup abrir mas os clientes não conseguirem selecionar datas, as definições de disponibilidade são normalmente a causa. Abra o seu serviço → separador **Availability** (Disponibilidade) e verifique o seguinte: * **Working days** (Dias úteis) estão ativados com horários de início e fim válidos * **Date-range availability** (Disponibilidade por intervalo de datas) → Se definiu datas específicas e elas já passaram, nenhuma data aparecerá. Adicione um novo intervalo de datas atual * **Minimum scheduling notice** (Antecedência mínima de agendamento) → Um valor elevado (p. ex. 48 horas) remove hoje e amanhã do calendário. O padrão é 1 hora * **Look ahead** (Antecedência de visualização) → Controla até quanto tempo à frente os clientes podem reservar. Um valor curto (p. ex. 2–3 dias) faz o calendário parecer quase vazio * **Break times** (Intervalos) → Certifique-se de que não cobrem todas as suas horas de funcionamento * **Blocked dates** (Datas bloqueadas) → Remova quaisquer datas que não devam estar bloqueadas Exemplo: Se o seu **Look ahead** estiver definido para 2 dias e o seu **Minimum scheduling notice** para 48 horas, os clientes podem não ver datas reserváveis de todo. Depois de ajustar, clique em **Save** e atualize a sua loja — as datas deverão tornar-se selecionáveis. --- # **✅ Passo 8: Verifique as Definições de Fuso Horário** Um fuso horário errado pode deslocar os seus horários — ou fazer parecer que não há disponibilidade nas horas que espera. Abra o seu serviço → separador **Availability** (Disponibilidade) → cartão **Timezone & hour format** (Fuso horário e formato de hora): * Confirme que o seu **Timezone** (Fuso horário) está correto * **Lock timezone** (Bloquear fuso horário) → Quando ativo, todos os clientes veem os horários no seu fuso horário, independentemente de onde estejam * **Show timezone selector** (Mostrar seletor de fuso horário) → Permite aos clientes mudar para o seu próprio fuso horário 💡 Se clientes noutros países reportarem horários “em falta”, provavelmente estão a ver o seu horário convertido para o fuso horário local deles. --- # **✅ Passo 9: Verifique se os Horários Estão Totalmente Reservados ou se os Limites Foram Atingidos** Às vezes, o calendário está a funcionar corretamente — os horários estão simplesmente ocupados. Verifique o seguinte: * **Maximum bookings per time slot** (Máximo de reservas por horário) → O padrão é 1, pelo que um horário desaparece assim que alguém o reserva. Aumente-o para aulas ou sessões de grupo * **Maximum bookings per day** (Máximo de reservas por dia) → Quando atingido, o dia inteiro fica indisponível * **Existing bookings** (Reservas existentes) → Abra a página **Bookings** (Reservas) para ver quais os horários já ocupados Está a utilizar o modo **Availability per teammate** (Disponibilidade por elemento da equipa)? Se nenhum elemento da equipa estiver atribuído ao serviço, não serão gerados horários de todo: → **Availability tab** (separador Disponibilidade) → **Assign teammates to this service** (Atribuir elementos da equipa a este serviço), ou volte a **Availability per service** (Disponibilidade por serviço) 💡 Quer que os dias totalmente reservados continuem visíveis? Ative a **Waitlist** (Lista de espera) no separador **Payment** (Pagamento) e depois ative **Show waitlist when a slot is fully booked** (Mostrar lista de espera quando um horário estiver totalmente reservado) — os clientes verão a opção **“Join waitlist”** (Entrar na lista de espera) em vez de um calendário vazio. --- # **⚠️ Bom Saber** * A pré-visualização dentro da página de configuração do serviço é aproximada — confie sempre no calendário na sua **live product page** (página de produto ativa) * O bloco de app **Appointment Calendar** também requer o app embed do Passo 1 * Cada produto ou variante só pode estar associado a **one active service** (um serviço ativo) de cada vez --- # **Ainda Não Aparece?** Se já experimentou todos os passos acima e o calendário de reservas ainda não estiver visível: 1. Volte a guardar o serviço 2. Confirme que **App Status** (Estado da app) mostra **Active** (Ativo) 3. Teste na **live product page** (página de produto ativa), não na pré-visualização do tema 4. Teste numa janela anónima Se o problema persistir, contacte-nos diretamente a partir da app Hoppy Appointments. Para nos ajudar a resolver mais rapidamente, inclua: * O URL da sua loja * O URL da página de produto onde o calendário deveria aparecer * O seu **Service ID** (**My services** → **More** → **Copy Service ID**) * O nome do seu tema * Uma captura de ecrã do cartão **App Status** Teremos todo o gosto em ajudar 🙌