{"id":3178,"date":"2026-06-22T11:18:36","date_gmt":"2026-06-22T09:18:36","guid":{"rendered":"https:\/\/help.zanfia.com\/docs\/webhooki-zdarzenia-payload-konfiguracja\/"},"modified":"2026-06-22T11:35:50","modified_gmt":"2026-06-22T09:35:50","password":"","slug":"webhooki-zdarzenia-payload-konfiguracja","status":"publish","type":"docs","link":"https:\/\/help.zanfia.com\/pl\/docs\/webhooki-zdarzenia-payload-konfiguracja\/","title":{"rendered":"Webhooki: zdarzenia, payload i konfiguracja"},"content":{"rendered":"\n

Webhook to powiadomienie, kt\u00f3re Zanfia wysy\u0142a do Twojego systemu w momencie, gdy w produkcie dzieje si\u0119 co\u015b wa\u017cnego (na przyk\u0142ad kto\u015b kupuje produkt). Dzi\u0119ki temu Tw\u00f3j system (CRM, ERP, w\u0142asna aplikacja, automatyzacja) dostaje dane od razu, bez odpytywania API.<\/p>\n\n\n\n

Webhooki konfigurujesz osobno dla ka\u017cdego produktu i sam decydujesz, jakie zdarzenia maj\u0105 je wyzwala\u0107 oraz jakie dane maj\u0105 trafi\u0107 do Twojego systemu.<\/p>\n\n\n\n

Gdzie znale\u017a\u0107 webhooki<\/h2>\n\n\n\n

Wejd\u017a w Produkty<\/strong>, wybierz produkt, otw\u00f3rz zak\u0142adk\u0119 Automatyzacje<\/strong> i przejd\u017a do sekcji Webhooks<\/strong>. Kliknij + Dodaj pierwsz\u0105 integracj\u0119<\/strong> (lub Dodaj webhook, je\u015bli masz ju\u017c jaki\u015b skonfigurowany).<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Konfiguracja webhooka krok po kroku<\/h2>\n\n\n\n
    \n
  1. Adres URL<\/strong> \u2014 adres endpointu w Twoim systemie, na kt\u00f3ry maj\u0105 trafia\u0107 dane.<\/li>\n\n\n\n
  2. Opis<\/strong> \u2014 dowolny opis pomocniczy, u\u0142atwia rozr\u00f3\u017cnienie webhook\u00f3w na li\u015bcie.<\/li>\n\n\n\n
  3. Metoda HTTP<\/strong> \u2014 GET albo POST (r\u00f3\u017cnice opisane ni\u017cej).<\/li>\n\n\n\n
  4. Zdarzenia (triggery)<\/strong> \u2014 jedno lub wiele zdarze\u0144, kt\u00f3re wyzwol\u0105 webhook (pe\u0142na lista ni\u017cej).<\/li>\n\n\n\n
  5. Typ autoryzacji<\/strong> \u2014 Brak, Basic Auth, Bearer Token albo API Key.<\/li>\n\n\n\n
  6. Payload \/ parametry<\/strong> \u2014 lista p\u00f3l, kt\u00f3re chcesz wys\u0142a\u0107, wraz z nazw\u0105 klucza pod jak\u0105 trafi\u0105 do Twojego systemu.<\/li>\n\n\n\n
  7. Aktywny<\/strong> \u2014 prze\u0142\u0105cznik w\u0142\u0105czaj\u0105cy webhook.<\/li>\n<\/ol>\n\n\n\n
    \"\"<\/figure>\n\n\n\n

    Lista dost\u0119pnych zdarze\u0144 (triggery)<\/h2>\n\n\n\n

    Nazwa techniczna (pole eventType w payloadzie) zawsze ma prefiks, na przyk\u0142ad product.ProductPurchased.<\/p>\n\n\n\n

    Dost\u0119pne dla ka\u017cdego produktu (darmowego i p\u0142atnego)<\/h3>\n\n\n\n
    Zdarzenie (eventType)<\/th>Opis<\/th>Kiedy si\u0119 wyzwala<\/th><\/tr><\/thead>
    product.ProductPurchased<\/td>Nowa subskrypcja\/zakup<\/td>Klient kupi\u0142 produkt (Tw\u00f3j nowy zakup)<\/td><\/tr>
    product.OrderCreated<\/td>Utworzono zam\u00f3wienie<\/td>Powsta\u0142o zam\u00f3wienie, r\u00f3wnie\u017c przy nieudanej p\u0142atno\u015bci<\/td><\/tr>
    product.ClientImported<\/td>Zaimportowano klienta<\/td>Klient zosta\u0142 dodany przez import<\/td><\/tr>
    productReferrals.ValidSubscriberFromReferral<\/td>Zweryfikowane polecenie<\/td>Zaliczono wa\u017cne polecenie w programie polece\u0144<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

    Dodatkowo dla produktu p\u0142atnego<\/h3>\n\n\n\n
    Zdarzenie (eventType)<\/th>Opis<\/th><\/tr><\/thead>
    product.ProductSubscriptionRenewed<\/td>Odnowienie subskrypcji<\/td><\/tr>
    product.ProductSubscriptionEnd<\/td>Koniec subskrypcji<\/td><\/tr>
    product.ProductAccessRenewed<\/td>Odnowienie okresu dost\u0119pu<\/td><\/tr>
    product.ProductAccessPeriodEnd<\/td>Koniec okresu dost\u0119pu<\/td><\/tr>
    product.ProductAccessPeriodEndingIn14Days<\/td>14 dni do ko\u0144ca okresu dost\u0119pu (tylko dla dost\u0119p\u00f3w rocznych)<\/td><\/tr>
    product.ProductAccessPeriodEndingIn7Days<\/td>7 dni do ko\u0144ca okresu dost\u0119pu<\/td><\/tr>
    product.ProductAccessPeriodEndingIn3Days<\/td>3 dni do ko\u0144ca okresu dost\u0119pu<\/td><\/tr>
    product.ProductAccessPeriodEndingIn1Day<\/td>1 dzie\u0144 do ko\u0144ca okresu dost\u0119pu<\/td><\/tr>
    product.ProductAccessPeriodEndingToday<\/td>Okres dost\u0119pu ko\u0144czy si\u0119 dzisiaj<\/td><\/tr>
    product.ProductClientArchived<\/td>Klient zarchiwizowany w produkcie<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

    Dodatkowo dla produktu darmowego<\/h3>\n\n\n\n
    Zdarzenie (eventType)<\/th>Opis<\/th><\/tr><\/thead>
    product.ProductClientRemoved<\/td>Klient usuni\u0119ty z produktu<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

    [SCREENSHOT: Rozwini\u0119ta lista zdarze\u0144 w formularzu webhooka]<\/strong><\/p>\n\n\n\n

    Pola payloadu<\/h2>\n\n\n\n

    Sam wybierasz, kt\u00f3re pola wys\u0142a\u0107, i pod jak\u0105 nazw\u0105 klucza maj\u0105 trafi\u0107 do Twojego systemu. Dost\u0119pne pola:<\/p>\n\n\n\n

    Pole<\/th>Opis<\/th><\/tr><\/thead>
    eventType<\/td>Typ zdarzenia (pe\u0142na nazwa, na przyk\u0142ad product.ProductPurchased)<\/td><\/tr>
    productId<\/td>ID produktu<\/td><\/tr>
    productName<\/td>Nazwa produktu<\/td><\/tr>
    priceId<\/td>ID ceny<\/td><\/tr>
    price<\/td>Cena: obiekt z kwot\u0105, walut\u0105 i stawk\u0105 VAT<\/td><\/tr>
    paymentType<\/td>Rodzaj p\u0142atno\u015bci<\/td><\/tr>
    orderId<\/td>Numer transakcji<\/td><\/tr>
    quantity<\/td>Liczba zakupionych (domy\u015blnie 1)<\/td><\/tr>
    clientEmail<\/td>Email klienta<\/td><\/tr>
    clientFirstName<\/td>Imi\u0119 klienta<\/td><\/tr>
    clientLastName<\/td>Nazwisko klienta<\/td><\/tr>
    clientName<\/td>Imi\u0119 i nazwisko klienta (po\u0142\u0105czone)<\/td><\/tr>
    clientAddress<\/td>Adres klienta<\/td><\/tr>
    phoneNumber<\/td>Numer telefonu<\/td><\/tr>
    companyName<\/td>Nazwa firmy<\/td><\/tr>
    taxNumber<\/td>NIP<\/td><\/tr>
    consents<\/td>Dodatkowe zgody<\/td><\/tr>
    discordId<\/td>Discord ID<\/td><\/tr>
    additionalInfo<\/td>Dodatkowe informacje<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

    Jak budowany jest payload<\/h2>\n\n\n\n