ℹ️ 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 🔗

Mis à jour le : 10/09/2026