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

Aktualisiert am: 10/09/2026