> ## 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).

# ⚡ Como o Appointment Bookings funciona com o Shopify Flow

> ℹ️ **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.

Quer que sua loja reaja automaticamente sempre que alguém marcar, remarcar ou cancelar um agendamento? 🤖

É exatamente para isso que serve a integração **Hoppy Appointments + Shopify Flow**.

**Shopify Flow** é a ferramenta gratuita de automação da Shopify. Ele monitora eventos na sua loja e executa as ações que você escolher — sem necessidade de código.

O Hoppy Appointments adiciona **8 acionadores de agendamento** ao Flow, para que você possa automaticamente:

* 📬 Notificar sua equipe quando chegar um novo agendamento  
* 🏷️ Etiquetar clientes com base na atividade de agendamento deles  
* ⏰ Lembrar a equipe sobre agendamentos aguardando aprovação  
* 🔁 Fazer acompanhamento após cancelamentos ou agendamentos concluídos  
* 🔗 Conectar seus agendamentos a outros aplicativos por meio dos conectores do Flow

Tudo isso funciona em segundo plano, 24 horas por dia, 7 dias por semana — para que nada passe despercebido enquanto você gerencia sua loja ✨

---

# **⚠️ Antes de começar**

Antes de configurar as automações de agendamento, certifique-se de que:

* O aplicativo **Hoppy Appointments** esteja instalado na sua loja Shopify  
* Você tenha pelo menos um serviço **ativo**  
  → Novo no aplicativo? Siga primeiro "How to Setup Appointment Booking Services"  
* O aplicativo **Shopify Flow** esteja instalado (ele é gratuito e desenvolvido pela Shopify)

ℹ️ Bom saber:

Não há nada para ativar dentro do Hoppy Appointments. Assim que o aplicativo estiver instalado, todos os 8 acionadores de agendamento aparecem automaticamente dentro do Shopify Flow.

---

# **🔔 Os 8 acionadores de agendamento disponíveis**

Dentro do Shopify Flow, você encontrará os seguintes acionadores do Hoppy Appointments:

---

## **📅 Booking Created**

Dispara quando um novo agendamento **gratuito** é confirmado — seja feito na sua loja, presencialmente via POS ou criado manualmente pela sua equipe.

---

## **💳 Payment Booking Created**

Dispara quando um agendamento **pago** é confirmado — após o cliente concluir o checkout e o pagamento.

---

## **⏳ Booking Needs Approval**

Dispara quando um agendamento requer aprovação manual da sua equipe.

---

## **🔁 Booking Rescheduled**

Dispara quando um agendamento é movido para uma nova data ou horário — inclui tanto o agendamento anterior quanto o novo.

---

## **❌ Booking Cancelled**

Dispara quando um agendamento é cancelado — pela sua equipe ou pelo cliente.

---

## **🚫 Booking Declined**

Dispara quando a sua equipe recusa um agendamento que estava aguardando aprovação, ou uma solicitação de lista de espera.

---

## **✅ Booking Completed**

Dispara quando a sua equipe marca a presença de um agendamento como **Completed** na página Bookings — perfeito para acompanhamentos pós-agendamento.

---

## **📋 Waitlist Booking Created**

Dispara quando um cliente entra na lista de espera de um horário totalmente reservado — um ótimo sinal de que aquele horário está em alta demanda.

---

# **📦 Que informações vêm com cada acionador**

Cada acionador traz os detalhes do agendamento, para que seus fluxos de trabalho possam usá-los em condições e mensagens:

* 📅 **Booking details** (Detalhes do agendamento) → Data e hora, duração, tipo de agendamento (regular, `multiday`, `bundle` ou waitlist) e se foi criado manualmente pela equipe  
* 👤 **Customer details** (Detalhes do cliente) → Nome e e-mail  
* 🛍️ **Service details** (Detalhes do serviço) → Nome e ID do serviço  
* 🔗 **Linked Shopify records** (Registros Shopify vinculados) → O produto, o cliente e (para agendamentos pagos) o pedido — para que você possa usar ações como **Add customer tags** (Adicionar etiquetas de cliente)

Alguns casos especiais:

* **Multiday bookings** (Agendamentos de vários dias) → Incluem tanto a data de início quanto a de término  
* **Booking Rescheduled** → Inclui a data e hora **anteriores** e a **nova**  
* **Payment Booking Created** → Inclui o pedido vinculado

---

# **⚙️ Etapa 1 — Instalar o Shopify Flow**

O Shopify Flow é um aplicativo gratuito desenvolvido pela Shopify.

→ Abra a **Shopify App Store**  
→ Pesquise por **Flow**  
→ Instale o aplicativo

Depois de instalado, você o encontrará em **Apps → Flow** no seu Shopify Admin.

---

# **🛠️ Etapa 2 — Create workflow (Criar um fluxo de trabalho)**

Abra o aplicativo **Flow** no seu Shopify Admin.

Depois:

→ Clique em **Create workflow**  
→ Clique em **Select a trigger** (Selecionar um acionador)  
→ Pesquise por "booking" ou navegue até os acionadores do **Hoppy Appointments**  
→ Escolha o acionador desejado — por exemplo, **Booking Created**

---

# **🎯 Etapa 3 — Add a condition (Adicionar uma condição) (Opcional)**

As condições permitem controlar exatamente quando o fluxo de trabalho deve ser executado.

### **Condições de exemplo**

* **Booking Type** (Tipo de agendamento) é `multiday` → automatiza apenas para estadias e aluguéis  
* **Manual Booking** (Reserva manual) é `false` → ignora agendamentos criados pela sua equipe no POS ou no admin  
* **Service Name** (Nome do serviço) contém "Consultation" → executa apenas para um serviço específico

💡 Sem condições, o fluxo de trabalho é executado para cada evento de agendamento desse tipo — o que geralmente é exatamente o que você deseja.

---

# **🚀 Etapa 4 — Add actions e Turn on (Adicionar ações e ativar)**

Agora escolha o que deve acontecer quando o acionador disparar.

Ações populares incluem:

* 📧 **Send internal email** (Enviar e-mail interno) → Alerta a sua equipe com os detalhes do agendamento  
* 🏷️ **Add customer tags** (Adicionar etiquetas de cliente) → Marca clientes para marketing segmentado posteriormente  
* 🔗 **Connect other apps** (Conectar outros aplicativos) → Envie uma mensagem no Slack, crie uma tarefa e muito mais por meio dos conectores do Flow

Depois:

→ Clique em **Turn on** (Ativar) para ativar o fluxo de trabalho

Sua automação está agora ativa ⚡

---

# **💡 Fluxos de trabalho de exemplo para experimentar**

Não sabe por onde começar? Aqui estão algumas configurações populares 👇

### **Exemplo 1 — Alerta da equipe para novos agendamentos**

* **Trigger:** Booking Created  
* **Action:** Send internal email para a sua equipe com o nome do cliente, o serviço e a data do agendamento

---

### **Exemplo 2 — Lembrete de aprovação**

* **Trigger:** Booking Needs Approval  
* **Action:** Send internal email — para que as solicitações não fiquem esperando

---

### **Exemplo 3 — Etiquetar clientes pagantes**

* **Trigger:** Payment Booking Created  
* **Action:** Add customer tags, aplicando a etiqueta `booked-paid` para campanhas futuras

---

### **Exemplo 4 — Acompanhamento pós-agendamento**

* **Trigger:** Booking Completed  
* **Action:** Adicionar a etiqueta `appointment-completed` ao cliente ou notificar seu aplicativo de marketing para solicitar uma avaliação

---

### **Exemplo 5 — Identificar horários em alta demanda**

* **Trigger:** Waitlist Booking Created  
* **Action:** Send internal email — um sinal para abrir mais disponibilidade para esse serviço

---

# **🏷️ Como etiquetar clientes que marcam uma reunião**

Etiquetar clientes que marcam agendamentos facilita segmentar seu público, enviar acompanhamentos direcionados ou identificar clientes fiéis dentro da Shopify.

O Hoppy Appointments envia o ID do cliente na Shopify (`customer_id`) com cada acionador do Flow, para que você possa usar a ação nativa **Add customer tags** (Adicionar etiquetas de cliente) do Shopify Flow.

## **Etapa 1 — Create the workflow (Criar o fluxo de trabalho)**

Abra o Shopify Flow, clique em **Create workflow** e selecione um acionador do Hoppy Appointments:

* **Booking Created** → etiqueta todo cliente que conclui um agendamento gratuito  
* **Payment Booking Created** → etiqueta clientes que pagaram no checkout  
* **Booking Completed** → etiqueta clientes depois que o agendamento é marcado como concluído

## **Etapa 2 — Add a condition (Adicionar uma condição) (Opcional)**

Se você quiser etiquetar clientes apenas para um serviço ou tipo de agendamento específico, adicione uma condição:

* **Service Name** (Nome do serviço) contém "Consultation"  
* **Booking Type** (Tipo de agendamento) é `multiday`  
* **Manual Booking** (Reserva manual) é `false` — para que agendamentos criados pela equipe não sejam etiquetados

## **Etapa 3 — Add customer tags (Ação de adicionar etiquetas de cliente)**

1. Clique em **Add action**  
2. Pesquise e selecione **Add customer tags**  
3. No campo **Customer** (Cliente), escolha a variável `customer_id` do acionador  
4. No campo **Tags** (Etiquetas), insira a etiqueta que deseja aplicar — por exemplo, `booked-appointment`

## **Etapa 4 — Turn on (Ativar o fluxo de trabalho)**

Clique em **Turn on**. A partir de agora, todo cliente que corresponder ao seu acionador e condição será etiquetado automaticamente.

⚠️ **Bom saber:** Se um cliente finalizar a compra como convidado ou não existir um registro de cliente Shopify para o e-mail dele, a ação de etiquetar não será aplicada.

---

# **⚠️ Bom saber**

* **Paid bookings** (Agendamentos pagos) disparam apenas **depois que o checkout for concluído** — nada dispara quando um cliente apenas escolhe um horário  
* **Bundle bookings** (Agendamentos em pacote) disparam uma vez por data de sessão no pacote  
* Agendamentos criados pela sua equipe (no admin ou no POS) incluem **Manual Booking = true** — use isso em condições se você quiser apenas agendamentos feitos pelos clientes  
* Se um cliente finalizar a compra como convidado, o agendamento pode não ser vinculado a um registro de cliente Shopify  
* Se um fluxo de trabalho falhar, seus agendamentos **nunca são afetados** — as automações funcionam de forma independente

---

# **🎉 Resultado final**

Depois de configurado com sucesso:

✅ Os eventos de agendamento disparam seus fluxos de trabalho automaticamente, 24 horas por dia, 7 dias por semana  
✅ Sua equipe é notificada no momento em que um agendamento precisa de atenção  
✅ Os clientes são etiquetados e organizados sem trabalho manual  
✅ Acompanhamentos após cancelamentos, conclusões e remarcações acontecem automaticamente  
✅ Seu sistema de agendamentos funciona junto com o restante dos seus aplicativos ✨

Com o Shopify Flow conectado, seus agendamentos ficam totalmente automatizados — para que você possa se concentrar nos seus clientes em vez da sua agenda 🚀

---