ℹ️ Note: Este artículo fue traducido automáticamente usando AI y puede contener imprecisiones. Si algo se ve mal, póngase en contacto con nuestro equipo de apoyo.

Webhooks le permite enviar datos de la presentación popup a cualquier URL externa en tiempo real. Esto es perfecto para conectar Hoppy PopUps con sistemas personalizados, CRM, servicios de notificación o cualquier plataforma que acepte solicitudes HTTP.

Cada vez que un visitante envía un formulario de popup, la aplicación envía una carga útil JSON a su punto final de Webhook configurado — instantánea y automáticamente.

⚠️ Antes de empezar

Antes de configurar webhooks, asegúrese de:

• El Hoppy PopUps app está instalada en tu Shopify tienda
• Tienes un webhook URL listo para recibir datos (desde tu desarrollador, CRM o servicio de terceros)

No se requieren claves de API ni cuentas externas dentro de la aplicación, sólo un punto final HTTPS válido.

🛠️ Paso 1 - Abra la Sección de Integración

Abrir el Hoppy PopUps aplicación de tu Shopify Admin.

Entonces:

→ Haga clic en Integración pestaña del menú de navegación del lado izquierdo

Localizar el Integración Webhook tarjeta.

Si aún no está conectado, la tarjeta mostrará:

→ No conectado

🔗 Paso 2 - Introduzca su URL de Webhook

Dentro de la tarjeta de integración Webhook:

→ Conecta Webhook

Introduzca su URL de punto final de Webhook en el campo proporcionado.

Ejemplo

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

Entonces:

→ Guardar & Conectar

La aplicación marcará el webhook como conectado. La placa de estado cambia a:

→ ✅ Conectado

📋 Paso 3 - Comprender la carga útil

En cada presentación popup, la aplicación envía un POST solicitar a su URL webhook con la siguiente 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
}

Descripción del campo

Campo

Descripción

email

La dirección de correo electrónico enviada por el visitante

teléfono

Número de teléfono presentado (si se recoge)

EmailCollectionName

El nombre interno del popup que recibió la comunicación

país

El país detectado desde la ubicación del visitante

tiempo

The local time of the submission

Fecha

Fecha de presentación

isReturning Cliente

true si el visitante ha presentado antes; false si nuevo

La solicitud se envía con Content-Type: application/json e incluye un tiempo de 5 segundos.

⚙️ Paso 4 - Cómo se comporta el Webhook

• Incendios en cada presentación - Independientemente del tipo de popup o el contenido
• No bloqueo — Si su punto final de Webhook es lento o abajo, la experiencia del comprador no se ve afectada
• Fresas automáticas — La aplicación registra el éxito y el fracaso de la consola; comprueba los registros del servidor si los datos no llegan
• Hora real — La carga útil se envía inmediatamente después de que se guarde la comunicación

✅ Paso 5 - Guardar la integración

Después de introducir su URL de Webhook:

→ Guardar

Su integración webhook está activa.

🧪 Paso 6 - Prueba la integración

Para verificar su punto final está recibiendo datos:

→ Abrir su escaparate en un Incognito o Privado ventana del navegador
→ Producir un popup y enviar una dirección de correo electrónico de prueba

Ejemplo:

testwebhook@example.com

Entonces:

→ Compruebe los registros de su webhook endpoint o sistema conectado
→ Verificar que una carga útil JSON llegó que contiene el email de prueba, nombre de popup, fecha, hora y datos de ubicación

💡 Si no tiene acceso a los registros del servidor, utilice un servicio gratuito de pruebas webhook (como webhook.site) como punto final temporal para inspeccionar la estructura de carga útil.

⚠️ Solución de problemas comunes

Webhook no recibe datos

Si las presentaciones suceden pero su punto final no recibe nada:

→ Verificar la URL de Webhook es correcta y utiliza HTTPS
→ Verificar el Webhook está marcado como Conectado en la tarjeta de integración
→ Verificar el popup es publicado y recibir activamente comunicaciones
→ Compruebe su firewall servidor o las reglas de CDN — pueden estar bloqueando la solicitud

Cargas desactivadas o perdidas

Si las cargas de pago son inconsistentes:

→ La aplicación utiliza un tiempo de 5 segundos - asegurar que su punto final responda dentro de esa ventana
→ El webhook no es bloqueador; un punto final lento no parará el popup de trabajar, pero la solicitud puede tiempo fuera
→ Compruebe los límites de la tasa del servidor si está recibiendo altos volúmenes de sumisión

Errores JSON inválidos o paresing

Si su sistema no puede leer la carga útil:

→ La aplicación envía Content-Type: application/json con un cuerpo JSON estándar
→ Asegurar que su endpoint espera JSON y no datos codificados en forma
→ Algunos campos (como phone) puede ser cadenas vacías si no recolectadas - manejar los valores nulos / vacíos con gracia

🎉 Resultado final

Una vez configurado con éxito:

✅ Cada envío popup envía datos en tiempo real a su punto final personalizado
✅ La carga incluye correo electrónico, teléfono, nombre popup, ubicación, horarios y estado de cliente de regreso
✅ La experiencia del comprador nunca es bloqueada por la entrega de webhook
✅ Puedes conectarte Hoppy PopUps a prácticamente cualquier sistema que acepte solicitudes HTTP 🔗

Actualizado el: 10/09/2026