> ## 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). # πŸ”— Integra PopUps tramite Webhooks > ℹ️ **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 πŸ”— ---