> ## 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). # 🔗 Intégrer les PopUps via Webhooks > ℹ️ **Note:** Cet article a été traduit automatiquement en utilisant l'IA et peut contenir des inexactitudes. Si quelque chose ne va pas, veuillez contacter notre équipe de soutien. Webhooks vous permet d'envoyer des données de soumission popup à n'importe quelle URL externe en temps réel. C'est parfait pour se connecter Hoppy PopUps avec des systèmes personnalisés, des CRM, des services de notification ou toute plateforme qui accepte les requêtes HTTP. Chaque fois qu'un visiteur soumet un formulaire popup, l'application envoie une charge utile JSON à votre terminal webhook configuré — instantanément et automatiquement. --- # **⚠️ Avant de commencer** Avant de configurer les webhooks, assurez-vous: * Les **Hoppy PopUps** app est installé sur votre Shopify magasin * Vous avez une **URL de webhook** prêt à recevoir des données (de votre développeur, CRM ou service tiers) Aucune clé d'API ou aucun compte externe n'est requis dans l'application — juste un paramètre HTTPS valide. --- # **🛠️ Étape 1 — Ouvrir la section Intégrations** Ouvrir la **Hoppy PopUps** application de votre Shopify Admin. Alors : → Cliquez sur le **Intégrations** onglet du menu de navigation de gauche Localiser la **Intégration de Webhook** carte. Si elle n'est pas encore connectée, la carte affiche : → **Non connecté** --- # **🔗 Étape 2 — Entrez votre URL Webhook** À l'intérieur de la carte d'intégration Webhook: → Cliquez sur **Connecter Webhook** Saisissez l'URL de votre webhook dans le champ fourni. ### **Exemple** `https://your-crm.com/api/popup-submissions` Alors : → Cliquez sur **Enregistrer & se connecter** L'application marquera le webhook comme connecté. Le badge d'état change pour : → ✅ **Connecté** --- # **📋 Étape 3 — Comprendre la charge utile** Sur chaque soumission popup, l'application envoie un **POSTE** demander à votre URL webhook avec la charge utile JSON suivante: `{` `"email": "user@example.com",` `"phone": "+1234567890",` `"EmailCollectionName": "My Popup Name",` `"country": "United States",` `"time": "14:30",` `"date": "2025-01-15",` `"isReturningCustomer": false` `}` ### **Description des champs** Champ Désignation des marchandises **Courriel** L'adresse électronique soumise par le visiteur **téléphone** Le numéro de téléphone soumis (si recueilli) **EmailCollectionNom** Le nom interne du popup qui a reçu la soumission **Pays** Le pays détecté depuis l'emplacement du visiteur **heure** Heure locale de la soumission **date** Date de la demande **est de retour Client** `true` si le visiteur s'est déjà présenté; `false` si nouveau La demande est envoyée avec `Content-Type: application/json` et comprend un délai de 5 secondes. --- # **⚙️ Étape 4 — Comment le Webhook se comporte** * **Incendie sur chaque soumission** — Quel que soit le type ou le contenu de popup * **Non-blocage** — Si votre webhook est lent ou ralenti, l'expérience du client n'est pas affectée * **Récupérations automatiques** — L'application enregistre le succès et l'échec de la console; vérifiez les journaux de votre serveur si les données n'arrivent pas * **Temps réel** — La charge utile est envoyée immédiatement après l'enregistrement --- # **✅ Étape 5 — Sauver l'intégration** Après avoir entré votre URL webhook : → Cliquez sur **Enregistrer** Votre intégration webhook est maintenant active. --- # **🧪 Étape 6 — Tester l'intégration** Pour vérifier que votre paramètre reçoit des données : → Ouvrir votre vitrine **Incognito ou privé** fenêtre du navigateur → Déclencher un popup et soumettre une adresse e-mail de test Exemple : `testwebhook@example.com` Alors : → Vérifiez les journaux de votre webhook ou votre système connecté → Vérifier qu'une charge utile JSON est arrivée contenant l'email de test, le nom contextuel, la date, l'heure et les données de localisation 💡 Si vous n'avez pas accès aux journaux de serveurs, utilisez un service de test gratuit (comme webhook.site) comme paramètre temporaire pour inspecter la structure de la charge utile. --- # **⚠️ Dépannage courant** ## **Webhook ne reçoit pas de données** Si des soumissions se produisent mais que votre point final ne reçoit rien: → Vérifier l'URL de webhook est correcte et utilise **HTTPS** → Vérifier que le webhook est marqué comme **Connecté** dans la carte d'intégration → Vérifier que le popup est **publié** et reçoit activement les communications → Vérifiez les règles de votre serveur pare-feu ou CDN — ils peuvent bloquer la requête ## **Charges utiles retardées ou manquantes** Si les charges utiles sont incompatibles: → L'application utilise un délai de 5 secondes — assurez-vous que votre endpoint répond dans cette fenêtre → Le webhook n'est pas un blocage ; un paramètre lent n'arrêtera pas le popup de travailler, mais la demande peut se terminer → Vérifiez les limites de tarifs du serveur si vous recevez des volumes de soumission élevés ## **Erreurs JSON ou d'analyse non valides** Si votre système ne peut pas lire la charge utile: → L'application envoie `Content-Type: application/json` avec un corps JSON standard → Assurez-vous que votre terminal attend JSON et non des données codées par formulaire → Quelques champs (comme `phone`) peuvent être des chaînes vides si elles ne sont pas collectées — gérer les valeurs null/vide gracieusement --- # **🎉 Résultat final** Une fois configuré avec succès : ✅ Chaque soumission popup envoie des données en temps réel à votre paramètre personnalisé ✅ La charge utile comprend le courriel, le téléphone, le nom contextuel, l'emplacement, l'horodatage et le statut du client de retour ✅ L'expérience client n'est jamais bloquée par la livraison webhook ✅ Vous pouvez vous connecter Hoppy PopUps à pratiquement tout système qui accepte les requêtes HTTP 🔗 ---