ℹ️ 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 🔗

Actualizado em: 10/09/2026