> ## 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 vía Webhooks > ℹ️ **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 🔗 ---