# Automatizálás: Zapier, Uncanny Automator és Pushover

> Az AffiliateWP összekötése külső szolgáltatásokkal: Zapier-triggerek és műveletek, Uncanny Automator receptek, Pushover push-értesítések a partnereknek.

## Zapier

A Zapier kiegészítő (Pro licenccel érhető el) összeköti az AffiliateWP-t a Zapier több mint 700 alkalmazásával. Automatikusan létrehozhat partnereket, szinkronizálhatja őket például a Mailchimppel, és értesítéseket küldhet. A Zapier **triggerekkel** és **műveletekkel** dolgozik:

- **Trigger:** az az esemény, amelyről a Zapier adatot kap (például új partner jött létre az oldaladon). Ha a Zapier adatot kap egy alkalmazástól, azt hívja triggernek.
- **Művelet (action):** amit a Zapier egy másik alkalmazásban elvégez (például partnert hoz létre az oldaladon, vagy frissít egy ajánlást). A triggerek váltják ki a műveleteket.

A Zapier az AffiliateWP REST API-ján keresztül biztonságosan kapcsolódik az oldaladhoz. Csak azokat az adatokat kapja meg, amelyeket a Zapier-beállításokban engedélyeztél.

### Előfeltételek

- Egy ingyenes Zapier-fiók.
- Az AffiliateWP Zapier-alkalmazás hozzáadása a Zapier-fiókodhoz (a kiegészítőnek két része van: a bővítmény az oldaladon és a Zapier-alkalmazás a Zapier piacterén).
- A **REST API Extended** kiegészítő telepítve és bekapcsolva: az API-kulcsokhoz és a triggerekhez, műveletekhez szükséges.

### Bekapcsolás és triggerek

1. Telepítsd és kapcsold be a Zapier kiegészítőt.
2. Nyisd meg az **AffiliateWP → Beállítások** oldalt, kattints a **Zapier** fülre, és jelöld be az **Enable Zapier** négyzetet.
3. Az **AffiliateWP → Zapier** oldalon jelöld be azokat, amelyekhez triggert akarsz használni: **Affiliates**, **Referrals**, **Creatives**, **Visits**, **Payouts**.

Mindegyikhez három esemény használható triggerként: létrejött egy elem, frissült egy elem, törölték az elemet. A kifizetéseknél nincs frissítés, mert a kifizetések nem szerkeszthetők. A partner adatai akkor is frissülnek, ha az AffiliateWP újraszámolja a keresetét egy módosított ajánlás miatt.

Az elérhető események: új, törölt és frissített partner; új, törölt és frissített ajánlás; új, törölt és frissített látogatás; új, törölt és frissített kreatív; új és törölt kifizetés.

### Az oldal összekötése a Zapierrel

A Zapier **WordPress** nevű alkalmazása nem hitelesít az AffiliateWP-nél: csak az alábbi API-kulcsos módszer működik.

1. A Zapier **Create A Zap** szerkesztőjében kattints a **Trigger** mezőre, keress rá az **AffiliateWP**-re, és add hozzá az első lépésnek.
2. Válaszd ki a kívánt eseményt, majd az **account** mezőben kattints a **Connect AffiliateWP** gombra: megnyílik egy felugró ablak.
3. Az oldaladon nyisd meg az **AffiliateWP → Eszközök** oldalt, és kattints az **API-kulcsok** fülre.
4. A felső mezőbe írd be egy adminisztrátori felhasználó nevét (nem kell partnernek lennie, ez csak a Zapierrel való kommunikációra szolgál), és kattints az új kulcsok létrehozására szolgáló gombra.
5. Másold a nyilvános kulcsot a Zapier **Public Key** mezőjébe, a tokent a **Token** mezőbe, az oldal címét pedig az **Site URL** mezőbe (az oldal címét a **Beállítások → Általános → Webhely címe** alatt találod).
6. Kattints a **Yes, Continue** gombra, majd a **Continue** és a **Test Trigger** gombra. Siker esetén a Zapier megmutatja a talált partner adatait.
7. Add meg a műveletet, például egy új Google-dokumentum létrehozását a partner e-mail-címével és nevével, majd nevezd el és kapcsold be a zapet.

### Műveletek

A műveletekhez is kell a **REST API Extended** kiegészítő, és az **AffiliateWP → Beállítások → REST API** fülön be kell kapcsolnod a művelethez tartozó végpontot (például partner létrehozásához az **Affiliate Endpoints** alatt a **Create** végpontot).

Elérhető műveletek: partner létrehozása (a szükséges WordPress-felhasználót is létrehozza; a fizetési e-mail kötelező), partner létrehozása meglévő felhasználóazonosítóból, partner frissítése és törlése, ajánlás létrehozása partnerazonosítóból, felhasználóazonosítóból vagy felhasználónévből, ajánlás frissítése és törlése, kifizetés létrehozása, frissítése és törlése, látogatás létrehozása, frissítése és törlése, kreatív létrehozása, frissítése és törlése.

**Példa: partner létrehozása táblázatsorból.** Egy Google Sheets táblázat sorából a Zapier partnert hoz létre: a trigger a Google Sheets **New Spreadsheet Row** eseménye, a művelet az AffiliateWP **Create Affiliate** művelete. A táblázatban legalább a fizetési e-mail kell. Ha nincs felhasználónév oszlop, a felhasználónév a fizetési e-mailből készül. Rendeld hozzá a táblázat oszlopait az AffiliateWP mezőihez, próbáld ki, és tedd közzé a zapet. A Zapier az új sort az előfizetéstől függően ötpercenként vagy tizenöt percenként veszi észre.

**Példa: partner frissítése a Mailchimpből.** A trigger a Mailchimp **Updated Subscriber** eseménye, a művelet az **Update Affiliate**. Az AffiliateWP-nek a partner azonosítója vagy a hozzá tartozó WordPress-felhasználó azonosítója kell, ezért a Mailchimp-listán hozz létre egy egyedi mezőt (**Settings → Audience fields and *MERGE* tags**) a partner azonosítójának. Ezen kívül tetszőleges más mezőt (jutalékmérték, állapot) is felvehetsz. A Zapierben az egyedi mezők neve `merges__` előtaggal jelenik meg. A zap a Mailchimp-azonosító mezőt az AffiliateWP azonosítójához rendeli.

### Kapcsolódási hibák elhárítása

- Ellenőrizd, hogy a Zapier kiegészítő (a neve **AffiliateWP - Zapier - Automated Tasks**) telepítve és bekapcsolva van-e: ha csak telepítve van, hibaüzenetet kapsz.
- Nézd meg, hogy a nyilvános kulcs és a token helyesen van-e megadva (**AffiliateWP → Eszközök → API-kulcsok**).
- Nézd meg az oldal címét: hibás cím esetén a Zapier „URL not found” vagy hitelesítési hibát ad.
- Ha a teszt küldésekor hibát kapsz, a **REST API Extended** kiegészítő hiányzik vagy nincs bekapcsolva.
- Egy másik bővítmény blokkolhatja a Zapier IP-címét, a tárhelyszolgáltató blokkolhatja azt, vagy kikapcsolhatja a távoli HTTP-hitelesítést (például a `$_SERVER['PHP_AUTH']` használatát). Kérdezd meg a tárhelyszolgáltatót.
- Ha a Zapier „(403) Forbidden” hibát ad, vagy GoDaddy tárhelyen vagy, tedd az `.htaccess` fájl elejére, az első `RewriteEngine On` sor után ezt a két sort:

```apache
RewriteCond %{HTTP:Authorization} ^(.*)
RewriteRule ^(.*) - [E=HTTP_AUTHORIZATION:%1]
```

## Uncanny Automator

Az Uncanny Automator egy WordPress-bővítmény, amellyel **receptekkel** (trigger és művelet párokkal) automatizálhatod az oldalad munkafolyamatait, és olyan külső szolgáltatásokhoz is kapcsolhatod az AffiliateWP-t, amelyekhez nincs külön kiegészítő. Egy recept például minden ajánlás után új sort ír egy Google Sheets táblázatba. Az ingyenes változat a WordPress-bővítménytárból telepíthető, de kevesebb integrációt és műveletet tud. A fizetős változat részletesebb AffiliateWP-triggereket ad, például adott feltételnek megfelelő ajánlást, vagy WooCommerce-termék vásárlását partnerlinkkel.

### Telepítés

1. Nyisd meg a **Bővítmények → Új hozzáadása** oldalt, és keress rá az **Uncanny Automator** bővítményre.
2. Kattints a **Telepítés**, majd a **Bekapcsolás** gombra, és frissítsd a vezérlőpultot.
3. A fizetős változathoz az **Automator → Upgrade to Pro** menüpontból juthatsz el, és a változatot ugyanúgy telepíted, mint bármelyik bővítményt.

### Recept létrehozása

1. Nyisd meg az **Automator → Add New** oldalt, és adj címet a receptnek.
2. Válaszd ki az **AffiliateWP** integrációt, és egy triggert, például „Egy új partner jóváhagyásra kerül” vagy „Egy felhasználó partner lesz”. Mentsd a triggert.
3. Kattints az **Add Action** gombra, és válaszd ki az integrációt (például **Google Sheets**). Kattints a **Connect account** gombra, jelentkezz be a Google-fiókoddal, és engedélyezd a hozzáférést.
4. Válaszd ki a műveletet (például **Create a row in a Google Sheet**), a táblázatot és a munkalapot.
5. Rendeld hozzá az AffiliateWP adatait (például partnerazonosító, fiók e-mail-címe) a táblázat oszlopaihoz, és mentsd.
6. Ugyanahhoz a triggerhez több műveletet is felvehetsz: kattints újra az **Add Action** gombra.
7. A recept jobb felső sarkában a kapcsolóval kapcsold a receptet **Draft** állapotból **Live** állapotba, és a trigger és a műveletek melletti kapcsolókkal is kapcsold be őket.

Próbáld ki a receptet, hogy lásd, a várt módon fut-e. Ha nem működik, ellenőrizd, hogy mindkét bővítmény aktív-e, a trigger és a műveletek helyesen vannak-e beállítva, és élesre vannak-e kapcsolva.

## Pushover-értesítések

A Pushover Notifications kiegészítő push-értesítést küld a partnerek telefonjára vagy táblagépére, valahányszor új ajánlást írnak jóvá a számlájukra. A használatához kell egy ingyenes fiók a Pushover szolgáltatónál.

### Beállítás

1. Telepítsd és kapcsold be a kiegészítőt.
2. Nyisd meg az **AffiliateWP → Beállítások** oldalt, és kattints a **Pushover** fülre.
3. Ide egy **Application Key** (alkalmazáskulcs) kell. Ha még nincs, jelentkezz be a Pushover-fiókodba, regisztrálj egy új alkalmazást, és másold ki a kapott kulcsot.
4. Illeszd be a kulcsot a mezőbe, és kattints a **Módosítások mentése** gombra.

### Mit lát a partner?

A kulcs mentése után a partnerek a partnerterület **Beállítások** fülén egy új mezőt látnak a **User Key** (felhasználói kulcs) megadásához. A felhasználói kulcshoz a partnernek is létre kell hoznia egy Pushover-fiókot. Miután megadta a kulcsot, és bekapcsolta az ajánlási értesítést, az eszközén push-értesítést kap minden új ajánlásról, amelynek állapota **Kifizetetlen**.