Documentação Técnica

Instalação do widget

Integre o widget de reservas no seu site em poucos minutos

4 min de leitura

O widget de reservas permite que os seus clientes reservem diretamente a partir do seu site.

Obter o código

  1. Vá a WidgetCódigo no menu lateral
  2. Escolha o separador de integração (Standalone é o recomendado)
  3. Clique em Copiar código — o seu clientId único já vem incluído

Opção 1: Standalone (recomendada)

É a integração mais rápida e leve. Cole este código no seu site, no sítio onde quer que o widget apareça:

<!-- Widget da Reserva de Hamacas (Standalone) -->
<div id="reserva-hamacas"></div>
<script src="https://cdn.reservadehamacas.com/widget/embed.js"></script>
<script>
  document.addEventListener('DOMContentLoaded', function () {
    ReservaHamacas.init({
      clientId: 'O_SEU_CLIENT_ID',
      container: '#reserva-hamacas',
      locale: 'pt',
      theme: {
        primaryColor: '#3B82F6'
      },
      onReservationComplete: function (data) {
        console.log('Reserva concluída:', data);
        // O seu código aqui (analítica, redirecionamento, etc.)
      },
      onError: function (error) {
        console.error('Erro:', error);
      }
    });
  });
</script>
Selecione para copiar

Não precisa de o colocar no <head>: o <script> fica junto ao <div> e o widget arranca sozinho ao carregar a página.

A cor principal e os textos do widget configuram-se em WidgetPersonalização, no painel. O primaryColor do código é opcional e serve de reforço.

Opção 2: iframe (simples)

Se a sua plataforma não permitir executar scripts, use um iframe. É a opção mais compatível:

<!-- Widget da Reserva de Hamacas (iframe) -->
<iframe
  src="https://reservadehamacas.com/embed/O_SEU_CLIENT_ID"
  width="100%"
  height="900px"
  style="border: none; border-radius: 12px; box-shadow: 0 4px 6px rgba(0,0,0,0.1);"
  title="Reserve a sua espreguiçadeira"
  allow="payment"
></iframe>
Selecione para copiar

O atributo allow="payment" é imprescindível para que os pagamentos funcionem dentro do iframe.

Opção 3: ligação direta

Envie os seus clientes diretamente para a sua página de reservas, sem instalar nada:

https://reservadehamacas.com/a-sua-empresa
Selecione para copiar

Se ainda não configurou o endereço amigável da sua empresa, use a ligação com o seu identificador:

https://reservadehamacas.com/embed/O_SEU_CLIENT_ID
Selecione para copiar

Use-a em:

  • Emails
  • Redes sociais
  • Códigos QR impressos

Widget de condomínios

Se o seu plano incluir o widget de condomínios (reservas internas, sem preços nem pagamentos), o script e o objeto global são diferentes:

<div id="reserva-hamacas"></div>
<script src="https://cdn.reservadehamacas.com/widget/embed-community.js"></script>
<script>
  document.addEventListener('DOMContentLoaded', function () {
    ReservaHamacasCommunity.init({
      clientId: 'O_SEU_CLIENT_ID',
      container: '#reserva-hamacas',
      locale: 'pt'
    });
  });
</script>
Selecione para copiar

Integrações específicas

WordPress

  1. Instale o plugin «Insert Headers and Footers» (ou semelhante)
  2. Cole o código do widget na secção do rodapé
  3. Crie uma página nova para as reservas
  4. Acrescente o <div> do contentor

Também pode usar um bloco HTML personalizado no editor de blocos.

Wix

  1. Vá ao editor do seu site
  2. Acrescente um elemento «Embed» > «HTML personalizado»
  3. Cole o código completo do widget
  4. Ajuste o tamanho do contentor

Squarespace

  1. Vá à página onde quer o widget
  2. Acrescente um bloco de «Código»
  3. Cole o código do widget
  4. Guarde e publique

Shopify

  1. Vá a Loja online > Páginas
  2. Crie uma página nova
  3. Mude para o editor HTML
  4. Cole o código do widget

Verificar a instalação

  1. Visite a página onde instalou o widget
  2. Deve ver o calendário de reservas
  3. Experimente fazer uma reserva de teste

Resolução de problemas

O widget não aparece

  • Verifique se o clientId está correto
  • Confirme que o <div id="reserva-hamacas"> existe no HTML
  • Veja a consola do navegador (F12) à procura de erros

O widget aparece mas não carrega dados

  • Confirme que a sua conta está ativa
  • Verifique se tem pelo menos uma zona publicada
  • Confirme que tem espreguiçadeiras disponíveis

Erro de CORS

  • O widget tem de ser carregado a partir de um domínio público
  • Não funciona abrindo o ficheiro HTML diretamente (file://)

Requisitos técnicos

RequisitoMínimo
Largura do site400 px (recomendado 800 px de altura)
JavaScriptAtivado
HTTPSRecomendado
NavegadoresChrome, Firefox, Safari, Edge (últimas 2 versões)

Passo seguinte

Aprenda a personalizar o widget com as suas opções de configuração.

Instalação do widget