ℹ️ Note: Questo articolo è stato tradotto automaticamente utilizzando AI e può contenere imprecisioni. Se qualcosa sembra sbagliato, si prega di contattare il nostro team di supporto.

Webhooks consente di inviare dati di presentazione popup a qualsiasi URL esterno in tempo reale. Questo è perfetto per il collegamento Hoppy PopUps con sistemi personalizzati, CRM, servizi di notifica, o qualsiasi piattaforma che accetta richieste HTTP.

Ogni volta che un visitatore invia un modulo popup, l'app invia un payload JSON al tuo endpoint webhook configurato, istantaneamente e automaticamente.

⚠️ Prima di iniziare

Prima di impostare webhooks, assicurarsi:

• The Hoppy PopUps app è installato sulla tua Shopify negozio
• Tu hai webhook URL pronto a ricevere i dati (dal tuo sviluppatore, CRM o servizio di terze parti)

Nessuna chiave API o account esterni sono richiesti all'interno dell'app — solo un endpoint HTTPS valido.

🛠️ Fase 1 — Aprire la sezione Integrazioni

Aprire Hoppy PopUps app dalla tua Shopify Admin.

Allora:

→ Fare clic su Integrazioni scheda dal menu di navigazione lato sinistro

Individuare il Integrazione Webhook Carta.

Se non ancora collegato, la scheda verrà visualizzata:

→ Non collegato

🔗 Passo 2 — Inserisci il tuo URL Webhook

All'interno della scheda Webhook Integration:

→ Cliccare Collegare Webhook

Inserisci il tuo URL endpoint webhook nel campo fornito.

Esempio

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

Allora:

→ Cliccare Salvare e collegare

L'app segnerà il webhook come collegato. Il badge di stato cambia a:

→ ✅ Collegato

📋 Passo 3 — Comprendere il carico di pagamento

Su ogni presentazione popup, l'app invia un POST richiedere al tuo URL webhook con il seguente payload JSON:

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

Descrizioni di campo

Campo

Descrizione

email

L'indirizzo email inviato dal visitatore

telefono

Il numero di telefono inviato (se raccolto)

EmailCollectionName

Il nome interno del popup che ha ricevuto la presentazione

Paese

Il paese rilevato dalla posizione del visitatore

tempo

L'ora locale della presentazione

data

La data della presentazione

è il ritorno Cliente

true se il visitatore ha presentato prima; false se nuovo

La richiesta viene inviata con Content-Type: application/json e include un timeout di 5 secondi.

⚙️ Passo 4 — Come il Webhook comporta

• Fuoco su ogni sottomissione — Indipendentemente dal tipo di popup o dal contenuto
• Non bloccaggio — Se il tuo endpoint webhook è lento o basso, l'esperienza del cliente non è influenzata
• Ritiri automatici — L'applicazione registra il successo e il fallimento della console; controlla i registri del server se i dati non arrivano
• In tempo reale — Il carico utile viene inviato immediatamente dopo che la presentazione è salvata

✅ Passo 5 — Salvare l'integrazione

Dopo aver inserito il tuo URL webhook:

→ Cliccare Salva

La vostra integrazione webhook è ora attiva.

🧪 Passo 6 — Testare l'integrazione

Per verificare che il tuo endpoint riceva dati:

→ Apri il tuo negozio in un Incognito o Privato finestra del browser
→ Trigger a popup e inviare un indirizzo email di prova

Esempio:

testwebhook@example.com

Allora:

→ Controlla i registri del tuo webhook endpoint o il sistema collegato
→ Verificare che un payload JSON sia arrivato contenente l'email di prova, il nome del popup, la data, l'ora e i dati della posizione

💡 Se non hai accesso ai log del server, usa un servizio di test webhook gratuito (come webhook.site) come endpoint temporaneo per ispezionare la struttura del payload.

⚠️ Risoluzione dei problemi comuni

Webhook non riceve dati

Se le presentazioni avvengono ma il tuo endpoint non riceve nulla:

→ Verificare l'URL webhook è corretto e utilizza HTTPS
→ Verificare il webhook è contrassegnato come Collegato nella scheda di integrazione
→ Verificare il popup è pubblicato e ricevere attivamente le presentazioni
→ Controllare il firewall del server o le regole CDN — possono essere bloccati la richiesta

Pagamenti in ritardo o mancanti

Se i carichi di pagamento sono incoerenti:

→ L'applicazione utilizza un timeout di 5 secondi — assicurarsi che il vostro endpoint risponde all'interno di quella finestra
→ Il webhook non è bloccante; un endpoint lento non fermerà il popup dal lavoro, ma la richiesta potrebbe uscire
→ Controlla i limiti della velocità del server se ricevi volumi di invio elevati

Errori non validi JSON o Parsing

Se il sistema non può leggere il payload:

→ L'app invia Content-Type: application/json con un corpo JSON standard
→ Assicurarsi che il vostro endpoint si aspetta JSON e non i dati codificati dalla forma
→ Alcuni campi (come phone) possono essere stringhe vuote se non raccolte — gestire valori nulli/vuoti con grazia

🎉 Risultato finale

Una volta configurato con successo:

✅ Ogni presentazione popup invia dati in tempo reale al tuo endpoint personalizzato
✅ Payload include e-mail, telefono, nome popup, posizione, timestamp e stato di ritorno-customer
✅ L'esperienza shopper non è mai bloccata dalla consegna webhook
✅ È possibile connettersi Hoppy PopUps virtualmente qualsiasi sistema che accetta richieste HTTP 🔗

Aggiornato il: 10/09/2026