> ## 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). # 🔗 PopUps über Webhooks integrieren > ℹ️ **Note:** Dieser Artikel wurde automatisch mit AI übersetzt und kann Ungenauigkeiten enthalten. Wenn etwas falsch aussieht, kontaktieren Sie bitte unser Support-Team. Mit Webhooks können Sie Popup-Eingabedaten in Echtzeit an jede externe URL senden. Dies ist perfekt für die Verbindung Hoppy PopUps mit benutzerdefinierten Systemen, CRMs, Benachrichtigungsdiensten oder einer Plattform, die HTTP-Anfragen akzeptiert. Jedes Mal, wenn ein Besucher ein Popup-Formular sendet, sendet die App eine JSON-Nutzlast an Ihren konfigurierten Webhook-Endpunkt - sofort und automatisch. --- # **⚠️ Bevor Sie beginnen** Bevor Sie Webhooks einrichten, stellen Sie sicher: * Die **Hoppy PopUps** Die App ist auf Ihrem Shopify Lager * Sie haben eine **Webhook URL** bereit, Daten zu erhalten (von Ihrem Entwickler, CRM oder Drittanbieter-Service) Innerhalb der App sind keine API-Schlüssel oder externe Konten erforderlich – nur ein gültiger HTTPS-Endpunkt. --- # **🛠️ Schritt 1 - Öffnen Sie den Abschnitt Integrationen** Offen **Hoppy PopUps** App von Deiner Shopify Admin. Dann: → Klicken Sie auf **Integrationen** Tab aus dem linksseitigen Navigationsmenü Suchen Sie die **Webhook-Integration** Karte. Wenn die Karte noch nicht angeschlossen ist, wird angezeigt: → **nicht verbunden** --- # **🔗 Schritt 2 - Geben Sie Ihre Webhook-URL ein** Innerhalb der Webhook Integration Card: → Klicken **Verbinden Sie Webhook** Geben Sie Ihre Webhook-Endpunkt-URL in das bereitgestellte Feld ein. ### **Beispiel** `https://your-crm.com/api/popup-submissions` Dann: → Klicken **Save & Connect** Die app markiert den webhook als verbunden. Das Status-Badge ändert sich in: → ✅ **Verbunden** --- # **📋 Schritt 3 - Verstehen Sie die Payload** Bei jeder Popup-Einreichung sendet die App eine **POST** Anfrage an Ihre Webhook-URL mit folgender JSON-Nutzlast: `{` `"email": "user@example.com",` `"phone": "+1234567890",` `"EmailCollectionName": "My Popup Name",` `"country": "United States",` `"time": "14:30",` `"date": "2025-01-15",` `"isReturningCustomer": false` `}` ### **Feldbeschreibungen** Feld Beschreibung **E-Mail** Die vom Besucher übermittelte E-Mail-Adresse **Telefon** Die angegebene Telefonnummer (falls gesammelt) **EmailCollectionName** Der interne Name des Popups, das die Einreichung erhalten hat **Land** Das Land, das vom Standort des Besuchers erkannt wurde **Uhrzeit** Ortszeit der Einreichung **Datum** Datum der Übermittlung **isReturning Kunde** `true` wenn der Besucher zuvor eingereicht hat; `false` wenn neu Die Anfrage wird gesendet mit `Content-Type: application/json` und beinhaltet ein 5-Sekunden-Timeout. --- # **⚙️ Schritt 4 - Wie sich der Webhook verhält** * **Feuer auf jeder Einreichung** Unabhängig von Popup-Typ oder Inhalt * **Nicht blockierend** Wenn Ihr Webhook-Endpunkt langsam oder heruntergefahren ist, ist die Erfahrung des Käufers nicht beeinträchtigt * **Automatische Retries** - Die App protokolliert Erfolg und Misserfolg auf der Konsole; Überprüfen Sie Ihre Serverprotokolle, wenn keine Daten ankommen * **Echtzeit** - Die Nutzlast wird unmittelbar nach dem Speichern der Übermittlung gesendet --- # **✅ Schritt 5 — Speichern der Integration** Nach Eingabe Ihrer Webhook-URL: → Klicken **Sparen** Ihre Webhook-Integration ist jetzt aktiv. --- # **🧪 Schritt 6 — Testen Sie die Integration** Um zu überprüfen, ob Ihr Endpunkt Daten empfängt: → Öffnen Sie Ihre Storefront in einem **Inkognito oder Privat** Browserfenster → Ein Popup auslösen und eine Test-E-Mail-Adresse senden Beispiel: `testwebhook@example.com` Dann: → Überprüfen Sie die Protokolle oder das verbundene System Ihres Webhook-Endpunkts Stellen Sie sicher, dass eine JSON-Nutzlast angekommen ist, die die Test-E-Mail, den Popup-Namen, Datum, Uhrzeit und Standortdaten enthält 💡 Wenn Sie keinen Zugriff auf Serverprotokolle haben, verwenden Sie einen kostenlosen Webhook-Testdienst (wie webhook.site) als temporären Endpunkt, um die Nutzlaststruktur zu überprüfen. --- # **⚠️ Gemeinsame Fehlerbehebung** ## **Webhook erhält keine Daten** Wenn Einsendungen passieren, aber Ihr Endpunkt nichts erhält: → Überprüfen Sie, ob die Webhook-URL korrekt ist und verwendet **HTTPS** → Überprüfen Sie, ob der Webhook als **Verbunden** in der Integrationskarte → Überprüfen Sie, ob das Popup **veröffentlicht** und aktiv Beiträge entgegennehmen → Überprüfen Sie Ihre Server-Firewall oder CDN-Regeln - sie blockieren möglicherweise die Anforderung ## **Verzögerte oder fehlende Payloads** Wenn Nutzlasten inkonsistent sind: → Die App verwendet ein 5-Sekunden-Timeout - stellen Sie sicher, dass Ihr Endpunkt innerhalb dieses Fensters reagiert → Der Webhook ist nicht blockierend; ein langsamer Endpunkt wird das Popup nicht vom Arbeiten abhalten, aber die Anforderung kann auslaufen → Überprüfen Sie die Server-Ratenlimits, wenn Sie hohe Einreichungsvolumina erhalten ## **Ungültige JSON- oder Parsing-Fehler** Wenn Ihr System die Nutzlast nicht lesen kann: → Die App sendet `Content-Type: application/json` mit Standard-JSON-Körper → Stellen Sie sicher, dass Ihr Endpunkt JSON erwartet und keine formkodierten Daten Einige Felder (wie) `phone`) können leere Strings sein, wenn sie nicht gesammelt werden - behandeln Sie null / leere Werte anmutig --- # **🎉 Endergebnis** Einmal erfolgreich konfiguriert: ✅ Jede Popup-Einreichung sendet Echtzeitdaten an Ihren benutzerdefinierten Endpunkt ✅ Payload umfasst E-Mail, Telefon, Popup-Name, Standort, Zeitstempel und Kundenstatus ✅ Die Shopper-Erfahrung wird niemals durch Webhook-Lieferung blockiert ✅ Sie können sich verbinden Hoppy PopUps zu praktisch jedem System, das HTTP-Anfragen akzeptiert 🔗 ---