Funkcja webhooków i callbacków Post Affiliate Pro pozwala automatycznie powiadamiać zewnętrzne systemy, gdy występują określone zdarzenia, takie jak nowa sprzedaż, rejestracja partnera lub zatwierdzenie prowizji.
Dostępne w:
Post Affiliate Pro , Post Affiliate Pro Ultimate , Post Affiliate Network
Webhooki (nazywane również Callbackami Aplikacji lub URL-ami Postback) to automatyczne powiadomienia HTTP, które Post Affiliate Pro wysyła do zewnętrznych systemów, gdy występują określone zdarzenia. Zamiast ciągłego odpytywania o aktualizacje, Twoje połączone systemy otrzymują natychmiastowe powiadomienia w momencie, gdy coś się dzieje w Twoim programie partnerskim.
Ta funkcja jest niezbędna do:
Post Affiliate Pro obsługuje dwa główne typy webhooków:
Te webhooki są wywoływane przez zdarzenia związane z transakcjami:
| Zdarzenie Wyzwalające | Opis |
|---|---|
| Przy Utworzeniu | Uruchamia się natychmiast po zarejestrowaniu nowej transakcji (sprzedaż, akcja, lead) |
| Przy Zatwierdzeniu | Uruchamia się gdy oczekująca transakcja jest zatwierdzana |
| Przy Odrzuceniu | Uruchamia się gdy transakcja jest odrzucana |
| Przy Zwrocie/Chargebacku | Uruchamia się gdy zwrot lub chargeback jest przetwarzany |
Możesz skonfigurować pojedynczy webhook do uruchamiania przy wielu zdarzeniach lub utworzyć oddzielne webhooki dla każdego typu zdarzenia.
Te webhooki są wywoływane przez zdarzenia rejestracji partnerów:
| Zdarzenie Wyzwalające | Opis |
|---|---|
| Przy Rejestracji | Uruchamia się natychmiast gdy nowy partner wypełni formularz rejestracyjny |
| Przy Zatwierdzeniu | Uruchamia się gdy oczekujący partner jest zatwierdzany przez sprzedawcę |
Post Affiliate Pro obsługuje trzy typy żądań HTTP dla webhooków:
Parametry są dołączane do URL jako parametry ciągu zapytania.
https://twoj-system.com/webhook?transactionid=abc123&commission=50.00&orderid=ORD-456
Parametry są wysyłane w treści żądania używając standardowego kodowania formularza.
Content-Type: application/x-www-form-urlencoded
transactionid=abc123&commission=50.00&orderid=ORD-456
Parametry są wysyłane jako obiekt JSON w treści żądania.
Content-Type: application/json
{"transactionid": "abc123", "commission": "50.00", "orderid": "ORD-456"}
Możesz używać zmiennych dynamicznych w swoich URL-ach webhooków, które są automatycznie zastępowane rzeczywistymi wartościami. Użyj formatu ${#nazwazminnej#} aby dołączyć zmienną.
| Zmienna | Opis |
|---|---|
${#transactionid#} | Unikalny identyfikator transakcji |
${#visitorid#} | ID odwiedzającego (ciasteczko śledzenia) |
${#commission#} | Kwota prowizji |
${#totalcost#} | Całkowita wartość zamówienia |
${#fixedcost#} | Kwota stałego kosztu |
${#orderid#} | ID zamówienia z Twojego systemu e-commerce |
${#productid#} | ID produktu |
${#dateinserted#} | Data i godzina utworzenia transakcji |
${#dateapproved#} | Data i godzina zatwierdzenia transakcji |
${#tier#} | Poziom prowizji |
${#status#} | Status transakcji (Zatwierdzona, Oczekująca, Odrzucona) |
${#statuscode#} | Kod statusu (A, P, D) |
${#type#} | Typ transakcji (Sprzedaż, Akcja itp.) |
| Zmienna | Opis |
|---|---|
${#campaignid#} | Identyfikator kampanii |
${#campaignname#} | Nazwa kampanii |
${#bannerid#} | Identyfikator banera |
${#channel#} | Nazwa kanału |
${#channel_code#} | Kod kanału |
${#coupon_code#} | Użyty kod kuponu |
| Zmienna | Opis |
|---|---|
${#userid#} | ID użytkownika partnera |
${#refid#} | ID polecenia partnera |
| Zmienna | Opis |
|---|---|
${#firstclicktime#} | Znacznik czasu pierwszego kliknięcia |
${#firstclickreferer#} | URL referrera pierwszego kliknięcia |
${#firstclickip#} | Adres IP pierwszego kliknięcia |
${#firstclickdata1#} | Niestandardowe dane 1 pierwszego kliknięcia |
${#firstclickdata2#} | Niestandardowe dane 2 pierwszego kliknięcia |
${#lastclicktime#} | Znacznik czasu ostatniego kliknięcia |
${#lastclickreferer#} | URL referrera ostatniego kliknięcia |
${#lastclickip#} | Adres IP ostatniego kliknięcia |
${#lastclickdata1#} | Niestandardowe dane 1 ostatniego kliknięcia |
${#lastclickdata2#} | Niestandardowe dane 2 ostatniego kliknięcia |
| Zmienna | Opis |
|---|---|
${#saledata1#} | Niestandardowe pole danych transakcji 1 |
${#saledata2#} | Niestandardowe pole danych transakcji 2 |
${#saledata3#} | Niestandardowe pole danych transakcji 3 |
${#saledata4#} | Niestandardowe pole danych transakcji 4 |
${#saledata5#} | Niestandardowe pole danych transakcji 5 |
| Zmienna | Opis |
|---|---|
${#ip#} | Adres IP klienta |
${#countrycode#} | Kod kraju na podstawie IP |
${#refererurl#} | URL referrera |
| Zmienna | Opis |
|---|---|
${#originalcurrency#} | Nazwa oryginalnej waluty |
${#originalcurrencyvalue#} | Wartość oryginalnej waluty |
${#originalcurrencyrate#} | Użyty kurs wymiany |
| Zmienna | Opis |
|---|---|
${#merchantnote#} | Notatka widoczna dla partnera |
${#systemnote#} | Notatka widoczna tylko dla sprzedawcy |
${#actionName#} | Nazwa typu prowizji za akcję |
${#actionCode#} | Kod typu prowizji za akcję |
Dla webhooków rejestracji partnerów możesz używać zmiennych profilu partnera:
| Zmienna | Opis |
|---|---|
${#username#} | E-mail/nazwa użytkownika partnera |
${#firstname#} | Imię partnera |
${#lastname#} | Nazwisko partnera |
${#name#} | Pełne imię i nazwisko |
${#userId#} | ID użytkownika partnera |
| Niestandardowe pola | Dowolne niestandardowe pole profilu po jego kodzie |
Domyślnie webhooki są wykonywane tylko dla prowizji poziomu 1 (bezpośrednich). Możesz włączyć opcję “Wykonaj dla każdego poziomu” aby wyzwalać webhooki dla wszystkich poziomów w wielopoziomowych strukturach prowizji.
Jest to przydatne gdy:
Możesz skonfigurować webhooki, aby były bardziej specyficzne:
Ogranicz webhook do określonego typu prowizji (np. tylko dla prowizji za akcję “Sprzedaż Premium”).
Twórz webhooki, które uruchamiają się tylko dla określonego partnera. Jest to przydatne dla:
W Post Affiliate Network możesz tworzyć webhooki specyficzne dla konta.
Post Affiliate Pro utrzymuje kompleksowy log wszystkich wykonań webhooków, dostępny w panelu sprzedawcy w Narzędzia > Log Callbacków.
Log pokazuje:
Jeśli webhook nie powiedzie się (np. Twój serwer jest tymczasowo niedostępny), Post Affiliate Pro automatycznie ponowi żądanie. Zapewnia to niezawodne dostarczanie nawet podczas tymczasowych awarii.
Logi webhooków są automatycznie czyszczone po konfigurowalnej liczbie dni (domyślnie: 60 dni). Możesz dostosować to w Konfiguracja > Funkcje > Callbacki Aplikacji.
Domyślnie webhooki utworzone przez partnerów wymagają zatwierdzenia sprzedawcy przed aktywacją. Sprzedawcy mogą:
Webhooki mają trzy możliwe statusy:
Sprzedawcy mogą zmienić status webhooka w dowolnym momencie z ekranu zarządzania webhookami.
Post Affiliate Pro może wysyłać powiadomienia e-mail o zdarzeniach związanych z webhookami:
Te powiadomienia można włączyć lub wyłączyć w Konfiguracja > Powiadomienia E-mail.
Wyślij dane nowej sprzedaży do swojego CRM gdy transakcja jest zatwierdzana:
https://crm.przyklad.com/api/sales?customer_order=${#orderid#}&value=${#totalcost#}&affiliate=${#refid#}
Powiadom swój kanał zespołu gdy nowy partner się rejestruje:
https://hooks.slack.com/services/xxx/yyy?text=Nowy+partner:+${#firstname#}+${#lastname#}
Dodaj klientów do sekwencji e-mail po zakupie:
POST https://email.przyklad.com/api/subscribers
Body: {"email": "${#saledata1#}", "purchase_value": "${#totalcost#}"}
Rejestruj płatności prowizji w swoim systemie księgowym:
https://ksiegowosc.przyklad.com/webhook?affiliate_id=${#userid#}&commission=${#commission#}&order=${#orderid#}
Webhooki (nazywane również Callbackami Aplikacji) to żądania HTTP, które Post Affiliate Pro automatycznie wysyła na podany przez Ciebie URL, gdy występują określone zdarzenia, takie jak nowa sprzedaż, zatwierdzenie prowizji lub rejestracja partnera. Pozwala to na integrację z zewnętrznymi systemami w czasie rzeczywistym.
Webhooki mogą być wywoływane przez: utworzenie nowej transakcji, zatwierdzenie transakcji, odrzucenie transakcji, zwroty i chargebacki, rejestrację nowego partnera oraz zatwierdzenie partnera. Możesz skonfigurować różne URL-e dla różnych zdarzeń.
Możesz dołączyć dowolne dane transakcji lub partnera używając zmiennych dynamicznych. Dla webhooków sprzedaży możesz użyć ponad 40 zmiennych, w tym ID transakcji, prowizji, ID zamówienia, ID produktu, ID partnera, nazwy kampanii i niestandardowych pól danych. Dla webhooków rejestracji możesz dołączyć szczegóły partnera takie jak imię, e-mail i niestandardowe pola profilu.
Tak, Post Affiliate Pro obsługuje typy żądań GET, POST (form-urlencoded) i POST JSON. Możesz wybrać format, który najlepiej odpowiada wymaganiom Twojego systemu odbierającego.
Połącz Post Affiliate Pro ze swoim CRM, platformą e-mail lub dowolnym zewnętrznym systemem dzięki potężnym webhookom i callbackom. Otrzymuj powiadomienia w czasie rzeczywistym o każdym ważnym zdarzeniu.
Dowiedz się, jak wykonywać wywołania zwrotne (callbacki) w Post Affiliate Pro. Poznaj konfigurację, ustawienia, najlepsze praktyki bezpieczeństwa oraz praktyczn...
W tym artykule dowiesz się więcej o Post Affiliate Pro jako aplikacji opartej na technologii Web 2.0 oraz jak z niej korzystać.
Wzmocnij swoich partnerów dzięki integracjom z mediami społecznościowymi w Post Affiliate Pro. Udostępniaj banery na Facebooku, Twitterze, LinkedIn i Pinterest,...
Dołącz do naszej społeczności zadowolonych klientów i zapewnij doskonałą obsługę klienta dzięki PostAffiliatePro.
