> ## 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).

# 🔗 Integracja Popups poprzez haki internetowe

> ℹ️ **Note:** Ten artykuł został automatycznie przetłumaczony za pomocą AI i może zawierać nieścisłości. Jeśli coś wygląda źle, skontaktuj się z naszym zespołem wsparcia.

Haki internetowe pozwalają na wysyłanie popowych danych na dowolny zewnętrzny adres URL w czasie rzeczywistym. To jest idealne do podłączenia Hoppy PopUps z niestandardowymi systemami, CRM, usługami notyfikacyjnymi lub jakąkolwiek platformą akceptującą żądania HTTP.

Za każdym razem, gdy odwiedzający przedstawia formularz wyskakujący, aplikacja wysyła ładunek JSON do skonfigurowanego punktu końcowego haka webowego - natychmiast i automatycznie.

---

# **⚠️ Zanim zaczniesz**

Przed ustawieniem haczyków należy upewnić się, że:

*   W **Hoppy PopUps** aplikacja jest zainstalowana na Twoim Shopify przechowywać
*   Masz **URL haka** gotowe do odbioru danych (od dewelopera, CRM lub trzeciej strony)

W aplikacji nie są wymagane żadne klucze API ani konta zewnętrzne - tylko poprawny punkt końcowy HTTPS.

---

# **🛠️ Krok 1 - Otwarcie sekcji Integracji**

Otwórz **Hoppy PopUps** aplikacja z Twojego Shopify Admin.

Następnie:

→ Kliknij **Integracje** zakładka z menu nawigacyjnego po lewej stronie

Zlokalizuj **Integracja haka internetowego** karta.

Jeśli karta nie jest jeszcze podłączona, wyświetla:

→ **Niepołączone**

---

# **🔗 Krok 2 - Wpisz swój adres URL**

Wewnątrz karty integracji Webhook:

→ Kliknij **Podłącz haczyk**

Wprowadź swój punkt końcowy haka webowego w dostarczonym polu.

### **Przykład**

`https://your-crm.com/api/popup-submissions`

Następnie:

→ Kliknij **Zapisz & podłącz**

Aplikacja zaznaczy haczyk jako podłączony. Odznaka statusu zmienia się na:

→ ✅ **Połączone**

---

# **📋 Krok 3 - Zrozumienie ładunku**

W każdym zgłoszeniu, aplikacja wysyła **POST** prośba do Twojego adresu URL z następującym ładunkiem JSON:

`{`  
`"email": "user@example.com",`  
`"phone": "+1234567890",`  
`"EmailCollectionName": "My Popup Name",`  
`"country": "United States",`  
`"time": "14:30",`  
`"date": "2025-01-15",`  
`"isReturningCustomer": false`  
`}`

### **Opisy pól**

Pole

Opis

**e-mail**

Adres e-mail podany przez odwiedzającego

**telefon**

Zgłoszony numer telefonu (jeżeli został pobrany)

**EmailCollection Name**

Wewnętrzna nazwa popu, który otrzymał zgłoszenie

**kraj**

Kraj wykryty z lokalizacji odwiedzającego

**czas**

Lokalny czas złożenia wniosku

**data**

Data złożenia wniosku

**isReturning Klient**

`true` jeżeli gość złożył już wniosek; `false` jeśli nowy

Wniosek jest przesyłany `Content-Type: application/json` i zawiera 5-sekundowy timeout.

---

# **⚙️ Krok 4 - Jak działa webhook**

*   **Pożary na każdym złożeniu** - Niezależnie od rodzaju wyskakiwania lub zawartości
*   **Nieblokowanie** - Jeśli punkt końcowy haka webhook jest powolny lub w dół, doświadczenie klienta nie jest naruszony
*   **Automatyczne powtórki** - Aplikacja loguje sukces i awarię konsoli; sprawdź dzienniki serwerów, jeśli dane nie dotrą
*   **Rzeczywisty czas** - Ładunek jest wysyłany natychmiast po zapisaniu

---

# **✅ Krok 5 - Zapisz integrację**

Po wejściu na adres URL haka:

→ Kliknij **Zapisz**

Integracja haka jest teraz aktywna.

---

# **🧪 Krok 6 - Test integracji**

Aby sprawdzić punkt końcowy, otrzymujemy dane:

→ Otwórz swój sklep w **Incognito lub prywatne** Okno przeglądarki  
→ Uruchomić wyskakiwanie i przesłać testowy adres e-mail

Przykład:

`testwebhook@example.com`

Następnie:

→ Sprawdź logi lub podłączony system w haku internetowym  
→ Sprawdzić, czy przybył ładunek JSON zawierający email testowy, nazwę wyskakującą, datę, czas i dane lokalizacyjne

💡 Jeśli nie masz dostępu do dzienników serwerów, skorzystaj z bezpłatnej usługi testowania haka (jak webhook.site) jako tymczasowego punktu końcowego, aby sprawdzić strukturę ładunku.

---

# **⚠️ Wspólne rozwiązywanie problemów**

## **Haczyk nie otrzymujący danych**

Jeśli zgłoszenia, ale punkt końcowy nie otrzymuje nic:

→ Weryfikacja adresu URL jest poprawna i używa **HTTPS**  
→ Weryfikacja haka jest oznaczona jako **Połączone** w karcie integracji  
→ Weryfikacja popup jest **opublikowane** i aktywnie otrzymywać oświadczenia  
→ Sprawdź zasady firewalla serwera lub CDN - mogą blokować żądanie

## **Opóźnione lub brakujące płatności**

Jeżeli ładunki są niespójne:

→ Aplikacja używa 5-sekundowego timeout - upewnij się, że Twój punkt końcowy odpowiada w tym oknie  
→ Haczyk internetowy nie blokuje; powolny punkt końcowy nie zatrzyma wyskakiwania z pracy, ale żądanie może czas  
→ Sprawdź limity stawek dla serwerów, jeśli odbierasz wysokie woluminy składania

## **Nieprawidłowe błędy JSON lub Parsing**

Jeśli system nie może odczytać ładunku:

→ Aplikacja wysyła `Content-Type: application/json` ze standardowym ciałem JSON  
→ Upewnij się, że Twój punkt końcowy oczekuje JSON, a nie zakodowane dane  
→ Niektóre pola (np. `phone`) mogą być puste łańcuchy, jeśli nie zostały zebrane - obsługują null / puste wartości graceful

---

# **🎉 Wynik końcowy**

Po skonfigurowaniu:

✅ Każde zgłoszenie wyskakujące wysyła dane w czasie rzeczywistym na niestandardowy punkt końcowy  
✅ Ładunek zawiera e-mail, telefon, wyskakującą nazwę, lokalizację, znacznik czasu i status klienta  
✅ Doświadczenie kupującego nigdy nie jest blokowane przez dostawę haka  
✅ Możesz się połączyć Hoppy PopUps praktycznie każdy system, który akceptuje żądania HTTP 🔗

---