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

# 🔗 Integrar a aplicação PopUps com Shopify Fluxo

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

Conectando Hoppy PopUps com **Shopify Fluxo** permite acionar automações cada vez que um visitante envia um formulário popup. Como o aplicativo expõe um gatilho nativo do Flow, você pode criar fluxos de trabalho que reagem instantaneamente às submissões popup — não é necessário codificar.

Use esta integração para enviar notificações internas, marcar clientes, criar ordens de rascunho, iniciar sequências de email ou conectar-se com outros aplicativos que suportem Flow.

---

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

Antes de criar esta integração, certifique-se:

*   A **Hoppy PopUps** app está instalado no seu Shopify guardar
*   **Shopify Fluxo** está disponível no seu Shopify plano (Flow vem livre em Shopify, Planos Avançados e Plus)

Não são necessárias chaves ou credenciais da API — o gatilho é incorporado ao aplicativo e aparece automaticamente dentro do Flow.

---

# **🛠️ Passo 1 — Abrir Shopify Fluxo**

De sua Shopify Administrador:

→ Ir para **Aplicações → Shopify Fluxo**

---

# **➕ Passo 2 — Criar um Novo Fluxo de Trabalho**

Dentro Shopify Fluxo:

→ Clique **Criar fluxo de trabalho**

Você verá o construtor de fluxo de trabalho com um **Trigger** Bloquear.

---

# **🎯 Passo 3 — Selecione o gatilho PopUp**

No fluxo de trabalho:

→ Clique em **Seleccionar um gatilho**  
→ Procurar **Hoppy PopUps**

→ Selecione o gatilho nomeado **📩 Formulário Popup Apresentado**

Este gatilho dispara automaticamente cada vez que qualquer popup em sua loja recebe uma submissão de formulário.

---

# **📋 Passo 4 — Entenda os dados disponíveis**

Quando o gatilho disparar, Shopify Flow recebe os seguintes campos de dados que você pode usar em seu fluxo de trabalho:

Campo

Tipo

Designação das mercadorias

**ID do Popup**

Texto

O ID único do popup que foi enviado

**Cliente**

Referência do Cliente

Um link para o Shopify Registro de cliente (se existe ou foi criado)

**ID do cliente**

Texto

A Shopify Texto GID do cliente

**URL da página**

Texto

A página onde o visitante enviou o popup

**E- mail do Cliente**

Texto

O endereço de e- mail indicado no contexto

**Telefone do Cliente**

Texto

O número de telefone inserido no popup (se fornecido)

Você pode usar esses campos como condições ou passá-los em ações mais tarde no fluxo de trabalho.

---

# **⚙️ Passo 5 — Adicionar condições (opcional)**

Se quiser que o fluxo de trabalho seja executado apenas para pop-ups ou submissões específicas:

→ Clique **Adicionar condição** abaixo do gatilho

Condições de exemplo:

*   **ID Popup é igual a** `your-popup-id` — Executar apenas para uma campanha específica
*   **O e- mail do cliente não está vazio** — Ignorar as observações incompletas
*   **URL da página contém** `/products/` — Reagir apenas às observações das páginas do produto

---

# **🔧 Passo 6 — Adicionar ações**

Após o gatilho (e quaisquer condições), adicione as ações que você deseja que Flow execute.

As ações populares incluem:

*   **Enviar e- mail interno através da aplicação Mensagens** — Notifique sua equipe quando uma popup de alto valor é enviada
*   **Adicionar etiquetas de clientes** — Assinantes de etiquetas para segmentação
*   **Criar uma ordem de rascunho** — Se o seu popup incluir uma oferta especial
*   **Iniciar um fluxo de e- mail Klaviyo** — Conector de fluxo via Klaviyo
*   **Atualizar a nota do cliente** — Registar o URL da fonte ou da página

---

# **✅ Passo 7 — Virar No fluxo de trabalho**

Uma vez que seu fluxo de trabalho é construído:

→ Clique **Activar o fluxo de trabalho**

O fluxo de trabalho está agora ao vivo. Cada submissão popup irá ativar automaticamente a lógica que você configurou.

---

# **🧪 Passo 8 — Teste a integração**

Para verificar os disparos de fluxo de trabalho corretamente:

→ Abra sua loja em um **Incógnito ou Privado** janela do navegador  
→ Ativar um popup e enviar um email de teste

Exemplo:

`testflow@example.com`

Depois:

→ Voltar para **Shopify Fluxo**  
→ Abra seu fluxo de trabalho  
→ Clique no **Actividade** aba  
→ Verifique se uma execução foi registrada com os dados de contexto corretos

---

# **⚠️ Solução comum de problemas**

## **Fluxo de trabalho não em execução**

Se as submissões acontecerem, mas o fluxo de trabalho não executar:

→ Verificar o fluxo de trabalho é **ligado** Em Fluxo  
→ Verificar o popup é **publicado** e ativo  
→ Verifique se quaisquer condições que você adicionou estão realmente sendo cumpridas  
→ Lembre-se que Flow executa servidor-lado — pode haver um pequeno atraso de alguns segundos

## **Dados do Cliente em Falta**

Se o campo Cliente estiver vazio no Flow:

→ O visitante pode ter apresentado como convidado sem um existente Shopify conta  
→ Activar o **Shopify Integração com a Lista de Clientes** em Hoppy PopUps para criar automaticamente clientes na submissão

---

# **🎉 Resultado Final**

Uma vez configurado com sucesso:

✅ Cada submissão popup desencadeia um Shopify Fluxo de fluxo automaticamente  
✅ Você pode segmentar, marcar, notificar ou agir em submissões sem código  
✅ Dados popup (e-mail, telefone, URL da página, ID do popup) flui diretamente em Flow  
✅ Fluxos de trabalho podem ser tão simples ou complexos quanto suas necessidades de negócio 🔗

---