Como Integrar o Acuity Scheduling na Shopify para Venda e Agendamento de Serviços

Guia técnico para integrar o Acuity Scheduling na Shopify. Aprenda a configurar templates, incorporar agendas e sincronizar dados de pedidos e clientes.

Vender serviços e consultorias no e-commerce apresenta um desafio técnico comum: conciliar o fluxo de pagamento tradicional da plataforma com a gestão de calendário e disponibilidade de horários. Quando o cliente compra uma sessão, a experiência deve ser contínua, evitando que ele finalize o pedido na loja e precise navegar separadamente para uma ferramenta externa sem identificação de contexto.

Integrar o Acuity Scheduling à Shopify resolve essa fricção ao unificar catálogo de serviços, processamento de pagamentos e reserva de horários em uma única interface.


Cenários de Implementação: Antes ou Depois do Checkout?

Antes de aplicar códigos ou componentes no tema, é fundamental definir o modelo operacional da sua loja:

  1. Agendamento antes da compra (Booking-First): O cliente seleciona o dia e o horário no calendário embutido e, em seguida, prossegue para o checkout da Shopify para concluir a transação.
  2. Agendamento pós-compra (Order-First): O cliente adquire o serviço como um produto padrão na Shopify. Após a confirmação do pagamento, a página de confirmação (Order Status Page) exibe a agenda para que o comprador reserve seu horário com um identificador de pedido atrelado.

Em implementações Shopify que realizo para prestadores de serviços, a escolha do fluxo depende diretamente do tipo de negócio: consultas individuais com agenda restrita tendem a funcionar melhor com a seleção de horário prévia, enquanto cursos e pacotes de horas funcionam com maior taxa de conversão no agendamento pós-compra.


Passo a Passo Técnico de Configuração

1. Preparação do Tema (Shopify Online Store 2.0)

Para manter o código modular e seguro contra atualizações de tema, evite injetar scripts diretamente no arquivo theme.liquid. Em vez disso:

  • Acesse o Editor de Temas da Shopify.
  • Crie um novo template de página ou de produto (ex: page.agendamento.json ou product.servico.json).
  • Adicione uma seção do tipo Custom Liquid para acomodar o container do agendamento.

2. Inserção do Código Embed do Acuity Scheduling

No painel do Acuity Scheduling, acesse Client’s Scheduling Page e copie o código de incorporação (Iframe).

Dentro da seção Custom Liquid do seu template Shopify, insira o código ajustando parâmetros de altura responsiva:

html

3. Pré-preenchimento de Dados do Cliente

Para melhorar a taxa de retenção, configure os parâmetros de URL do Acuity para receber atributos do cliente autenticado na Shopify via Liquid:

liquid
{% if customer %}
{% assign clientparams = ‘?firstname=’ | append: customer.firstname | append: ‘&lastname=’ | append: customer.last_name | append: ‘&email=’ | append: customer.email %}
{% endif %}

Dessa forma, se o usuário estiver logado na loja, o calendário abrirá já com os dados básicos preenchidos, reduzindo etapas manuais.

4. Sincronização de Pedidos e Notificações

Para evitar divergências na comunicação com o cliente:

  • E-mails Transacionais: Desative a cobrança direta dentro do Acuity se o pagamento for centralizado no checkout da Shopify, mantendo ativo apenas o disparo de confirmação de agenda e lembretes de calendário.
  • Webhooks: Para lojas que exigem baixa de inventário ou criação automática de contas, utilize webhooks da Shopify vinculados à API do Acuity (via automações em Node.js ou ferramentas como Make/Zapier) para confirmar o status da reserva assim que o status do pedido for marcado como pago.

Boas Práticas de UX e Performance

  • Carregamento Assíncrono: Garanta que scripts externos do agendador não bloqueiem a renderização inicial dos elementos vitais da página (LCP).
  • Tratamento Mobile: Certifique-se de que o Iframe possua altura dinâmica suficiente para telas menores, evitando scrollbars duplas na navegação móvel.
  • Políticas Claras: Inclua uma seção de política de reagendamento e cancelamento logo abaixo do container de marcação.

Configurar uma loja Shopify do zero combinada a um sistema de agendamento externo requer alinhamento entre arquitetura de temas, parâmetros de URL e automações de pedidos. Se você precisa planejar e implementar essa integração técnica na sua operação de forma robusta e personalizada, agende uma consultoria técnica com Thiago Programador para desenhar a melhor solução para o seu negócio.

Preencha o formulário abaixo para que eu consiga entrar em contato com você.