> ## 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 PopUps via Webhooks

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

Webhooks permitem enviar dados de submissão popup para qualquer URL externa em tempo real. Isto é perfeito para conectar Hoppy PopUps com sistemas personalizados, CRMs, serviços de notificação ou qualquer plataforma que aceite solicitações HTTP.

Cada vez que um visitante envia um formulário popup, o aplicativo envia uma carga útil JSON para o seu endpoint webhook configurado — instantaneamente e automaticamente.

---

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

Antes de configurar os webhooks, certifique-se:

*   A **Hoppy PopUps** app está instalado no seu Shopify guardar
*   Você tem um **URL do webhook** pronto para receber dados (de seu desenvolvedor, CRM ou serviço de terceiros)

Nenhuma chave de API ou contas externas são necessárias dentro do aplicativo — apenas um endpoint HTTPS válido.

---

# **🛠️ Passo 1 — Abra a seção Integração**

Abrir o **Hoppy PopUps** app a partir da sua Shopify Admin.

Depois:

→ Clique no **Integração** aba do menu de navegação do lado esquerdo

Localizar o **Integração Webhook** Cartão.

Se ainda não estiver conectado, o cartão será exibido:

→ **Não Ligado**

---

# **🔗 Passo 2 — Digite seu URL do Webhook**

Dentro do cartão de integração Webhook:

→ Clique **Ligar o Webhook**

Introduza o URL do seu terminal webhook no campo fornecido.

### **Exemplo**

`https://your-crm.com/api/popup-submissions`

Depois:

→ Clique **Salvar & conexão**

O aplicativo marcará o webhook como conectado. O crachá de estado muda para:

→ ✅ **Ligado**

---

# **📋 Passo 3 — Entenda a carga útil**

Em cada submissão popup, o aplicativo envia um **POSTO** solicitar ao seu URL webhook com a seguinte carga útil JSON:

`{`  
`"email": "user@example.com",`  
`"phone": "+1234567890",`  
`"EmailCollectionName": "My Popup Name",`  
`"country": "United States",`  
`"time": "14:30",`  
`"date": "2025-01-15",`  
`"isReturningCustomer": false`  
`}`

### **Descrições do Campo**

Campo

Designação das mercadorias

**e- mail**

O endereço de e- mail enviado pelo visitante

**telefone**

Número de telefone apresentado (se recolhidos)

**E- mailCollectionName**

Nome interno do popup que recebeu a apresentação

**País**

O país detectado a partir da localização do visitante

**tempo**

A hora local da apresentação

**data**

Data da apresentação

**isReturning Cliente**

`true` Se o visitante tiver apresentado antes; `false` se novo

O pedido é enviado com `Content-Type: application/json` e inclui um intervalo de 5 segundos.

---

# **⚙️ Passo 4 — Como o gancho se comporta**

*   **Incêndios sobre cada submissão** — Independentemente do tipo ou do conteúdo do popup
*   **Não-bloqueamento** — Se o seu endpoint webhook for lento ou lento, a experiência do comprador não é afetada
*   **Repetições automáticas** — O aplicativo registra sucesso e falha no console; verifique os registros do servidor se os dados não chegarem
*   **Em tempo real** — A carga útil é enviada imediatamente após a apresentação ser salva

---

# **✅ Passo 5 — Salve a Integração**

Depois de entrar em seu URL webhook:

→ Clique **Gravar**

Sua integração webhook agora está ativa.

---

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

Para verificar seu endpoint está recebendo dados:

→ Abra sua loja em um **Incógnito ou Privado** janela do navegador  
→ Ativar um popup e enviar um endereço de e-mail de teste

Exemplo:

`testwebhook@example.com`

Depois:

→ Verifique os registros de endpoint do seu webhook ou sistema conectado  
→ Verifique se chegou uma carga útil JSON contendo os dados de data, hora e localização do email de teste

💡 Se você não tiver acesso aos logs do servidor, use um serviço de teste webhook gratuito (como webhook.site) como um ponto final temporário para inspecionar a estrutura de carga útil.

---

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

## **Webhook não Recebendo Dados**

Se as submissões acontecerem mas o seu objetivo não receber nada:

→ Verifique o URL webhook está correto e usa **HTTPS**  
→ Verificar o webhook está marcado como **Ligado** no cartão de integração  
→ Verificar o popup é **publicado** e recebendo ativamente submissões  
→ Verifique suas regras de firewall ou CDN do servidor — eles podem estar bloqueando a solicitação

## **Cargas de pagamento atrasadas ou em falta**

Se as cargas são inconsistentes:

→ O aplicativo usa um tempo- limite de 5 segundos — garantir que seu endpoint responde dentro dessa janela  
→ O webhook não está bloqueando; um endpoint lento não vai impedir o popup de trabalhar, mas a solicitação pode parar  
→ Verifique os limites de taxa do servidor se você está recebendo altos volumes de submissão

## **Erros de análise ou JSON inválidos**

Se o seu sistema não consegue ler a carga útil:

→ O aplicativo envia `Content-Type: application/json` com um corpo padrão JSON  
→ Certifique-se de que seu endpoint espera JSON e não dados codificados por formulário  
→ Alguns campos (como `phone`) podem ser cadeias vazias se não recolhidas — manusear valores nulos/vazios graciosamente

---

# **🎉 Resultado Final**

Uma vez configurado com sucesso:

✅ Cada submissão popup envia dados em tempo real para o seu endpoint personalizado  
✅ Payload inclui e-mail, telefone, nome popup, localização, timestamp e status de cliente retornando  
✅ A experiência do comprador nunca é bloqueada pela entrega webhook  
✅ Você pode conectar Hoppy PopUps para praticamente qualquer sistema que aceite solicitações HTTP 🔗

---