Webhooky a callbacky

Dostupné v:

Post Affiliate Pro , Post Affiliate Pro Ultimate , Post Affiliate Network

Čo sú webhooky a callbacky?

Webhooky (tiež nazývané Application Callbacks alebo Postback URL) sú automatizované HTTP notifikácie, ktoré Post Affiliate Pro odosiela externým systémom, keď nastanú špecifické udalosti. Namiesto neustáleho dotazovania na aktualizácie dostávajú vaše pripojené systémy okamžité notifikácie v momente, keď sa niečo stane vo vašom affiliate programe.

Táto funkcia je nevyhnutná pre:

• Integráciu CRM - Automatická aktualizácia vašej zákazníckej databázy pri predajoch
• Automatizáciu e-mailov - Spustenie e-mailových sekvencií na základe akcií afiliátov
• Účtovné systémy - Synchronizácia transakčných údajov s vaším finančným softvérom
• Vlastné dashboardy - Budovanie dashboardov s reportami v reálnom čase
• Sledovanie tretích strán - Upozornenie externých sledovacích platforiem na konverzie

Spustite svoj affiliate program ešte dnes

Nastavte pokročilé sledovanie za pár minút. Kreditná karta nie je potrebná.

Požiadať o demo Začať 30-dňovú bezplatnú skúšku

Typy webhookov

Post Affiliate Pro podporuje dva hlavné typy webhookov:

Webhooky sledovania predajov

Tieto webhooky sú spúšťané udalosťami súvisiacimi s transakciami:

Môžete nakonfigurovať jeden webhook na spustenie pri viacerých udalostiach alebo vytvoriť oddelené webhooky pre každý typ udalosti.

Webhooky registrácie afiliátov

Tieto webhooky sú spúšťané udalosťami registrácie afiliátov:

Typy požiadaviek

Post Affiliate Pro podporuje tri typy HTTP požiadaviek pre webhooky:

GET požiadavka

Parametre sú pripojené k URL ako parametre query string.

https://vas-system.com/webhook?transactionid=abc123&commission=50.00&orderid=ORD-456

POST požiadavka (Form-Urlencoded)

Parametre sú odoslané v tele požiadavky pomocou štandardného kódovania formulára.

Content-Type: application/x-www-form-urlencoded

transactionid=abc123&commission=50.00&orderid=ORD-456

POST JSON požiadavka

Parametre sú odoslané ako JSON objekt v tele požiadavky.

Content-Type: application/json

{"transactionid": "abc123", "commission": "50.00", "orderid": "ORD-456"}

Prihláste sa na odber noviniek

Buďte prvý, kto sa dozvie o nových funkciách a aktualizáciách produktu.

E-mailová adresa

Prihlásiť sa

Dostupné premenné pre webhooky predajov

Môžete použiť dynamické premenné vo vašich URL webhookov, ktoré sú automaticky nahradené skutočnými hodnotami. Použite formát ${#nazovpremennej#} na zahrnutie premennej.

Transakčné údaje

Údaje kampane a bannera

Údaje afiliáta

Údaje kliknutia

Vlastné transakčné údaje

Geografické a technické údaje

Údaje o mene

Poznámky

Dostupné premenné pre webhooky registrácie

Pre webhooky registrácie afiliátov môžete použiť premenné profilu afiliáta:

Podpora viacerých úrovní

Predvolene sa webhooky vykonávajú iba pre úroveň 1 (priame) provízie. Môžete povoliť možnosť “Vykonať pre každú úroveň” na spustenie webhookov pre všetky úrovne vo viacúrovňových províznych štruktúrach.

To je užitočné, keď:

• Potrebujete sledovať provízie na všetkých úrovniach vašej affiliate hierarchie
• Váš externý systém potrebuje vedieť o zárobkoch sub-afiliátov
• Budujete komplexné reportovanie, ktoré zahŕňa všetky úrovne provízií

Možnosti filtrovania webhookov

Môžete nakonfigurovať webhooky tak, aby boli špecifickejšie:

Podľa typu provízie

Obmedzte webhook na konkrétny typ provízie (napr. iba pre akčné provízie “Premium Sales”).

Podľa afiliáta

Vytvorte webhooky, ktoré sa spúšťajú iba pre konkrétneho afiliáta. To je užitočné pre:

• Afiliátov, ktorí používajú vlastné sledovacie systémy
• Špeciálne integrácie pre najvýkonnejších afiliátov
• Testovanie webhookov s jedným afiliátom pred nasadením

Podľa účtu (Network Mode)

V Post Affiliate Network môžete vytvoriť webhooky špecifické pre účet.

Log a monitorovanie webhookov

Post Affiliate Pro udržiava komplexný log všetkých vykonaní webhookov, dostupný v obchodnom paneli pod Nástroje > Callbacks Log.

Log zobrazuje:

• Log ID - Jedinečný identifikátor pre každé vykonanie webhooku
• Callback ID - Ktorá konfigurácia webhooku bola použitá
• Request URL - Úplná URL, ktorá bola volaná (s nahradenými premennými)
• Dátum vytvorenia - Kedy bol webhook zaradený do fronty
• Posledný pokus - Kedy bol vykonaný posledný pokus o vykonanie
• Číslo pokusu - Koľkokrát sa systém pokúsil vykonať
• Stav - Pending, Sent alebo Error
• Chybová správa - Detaily ak webhook zlyhal

Automatický opakovaný pokus

Ak webhook zlyhá (napr. váš server je dočasne nedostupný), Post Affiliate Pro automaticky zopakuje požiadavku. To zabezpečuje spoľahlivé doručenie aj počas dočasných výpadkov.

Uchovávanie logov

Logy webhookov sú automaticky čistené po konfigurovateľnom počte dní (predvolené: 60 dní). Toto môžete upraviť v Konfigurácia > Funkcie > Application Callbacks.

Správa webhookov

Schvaľovací pracovný postup

Predvolene webhooky vytvorené afiliátmi vyžadujú schválenie obchodníkom predtým, ako sa stanú aktívnymi. Obchodníci môžu:

• Povoliť automatické schválenie - Automaticky schváliť všetky nové webhooky
• Manuálne preskúmať - Schváliť alebo odmietnuť každý webhook individuálne

Správa stavu

Webhooky majú tri možné stavy:

• Approved - Aktívny a bude vykonaný pri spustení
• Pending - Čaká na schválenie obchodníkom
• Declined - Odmietnutý a nebude vykonaný

Obchodníci môžu kedykoľvek zmeniť stav webhooku z obrazovky správy webhookov.

E-mailové notifikácie

Post Affiliate Pro môže odosielať e-mailové notifikácie pre udalosti súvisiace s webhookmi:

Notifikácie pre obchodníka

• Nový webhook vytvorený afiliátom

Notifikácie pre afiliáta (voliteľné)

• Zmena stavu webhooku (schválený/odmietnutý)
• Webhook upravený obchodníkom
• Webhook vymazaný obchodníkom

Tieto notifikácie je možné povoliť alebo zakázať v Konfigurácia > E-mailové notifikácie.

Príklady použitia

1. Integrácia CRM

Odošlite údaje o novom predaji do vášho CRM pri schválení transakcie:

https://crm.example.com/api/sales?customer_order=${#orderid#}&value=${#totalcost#}&affiliate=${#refid#}

2. Slack notifikácia

Upozornite váš tímový kanál, keď sa zaregistruje nový afiliát:

https://hooks.slack.com/services/xxx/yyy?text=Novy+afiliat:+${#firstname#}+${#lastname#}

3. Spustenie e-mailovej platformy

Pridajte zákazníkov do e-mailovej sekvencie po nákupe:

POST https://email.example.com/api/subscribers
Body: {"email": "${#saledata1#}", "purchase_value": "${#totalcost#}"}

4. Synchronizácia účtovného softvéru

Zaznamenajte platby provízií vo vašom účtovnom systéme:

https://accounting.example.com/webhook?affiliate_id=${#userid#}&commission=${#commission#}&order=${#orderid#}

Ako nastaviť webhook

1. Prihláste sa do vášho Obchodníckeho panela
2. Prejdite na Konfigurácia > Funkcie
3. Aktivujte funkciu Application Callbacks
4. Prejdite na Kampane > [Vyberte kampaň] > Callbacks alebo globálny správca callbackov
5. Kliknite na Pridať nový callback
6. Nakonfigurujte:
   • Názov - Popisný názov pre webhook
   • Typ - Sale Tracking alebo Affiliate Signup
   • Vykonanie - Kedy spustiť (pri vytvorení, schválení, odmietnutí, refundácii)
   • Typ požiadavky - GET, POST alebo POST JSON
   • URL - Váš endpoint s premennými
   • Vykonať pre každú úroveň - Áno/Nie
7. Uložte webhook

Bezpečnostné úvahy

• Používajte HTTPS endpointy pre bezpečný prenos údajov
• Zvážte pridanie tajného parametra na overenie zdroja webhooku
• Implementujte limitovanie požiadaviek na vašom prijímajúcom endpointe
• Validujte prichádzajúce údaje pred spracovaním
• Uchovávajte logy webhookov pre účely auditu

Súvisiace funkcie

• S2S sledovanie - Server-to-server sledovanie pre presné konverzie
• API - Plný programový prístup k Post Affiliate Pro
• API v3 - Moderné RESTful API s OAuth 2.0