# Zapier-integráció

> A LearnDash összekötése több ezer alkalmazással a Zapieren át: telepítés, eseményindítók és műveletek, zap létrehozása lépésről lépésre, régi webhookos módszer, gyakori kérdések.

A Zapier-integráció a LearnDash eseményeit (beiratkozás, lecke befejezése, kvíz kitöltése és mások) továbbítja a Zapier felé, így a LearnDash több mint ezerötszáz másik alkalmazással összekapcsolható. Az adatok akkor mennek át a másik alkalmazásba, amikor a LearnDash webhelyen egy megadott esemény (eseményindító) bekövetkezik.

A használathoz Zapier-fiók kell. Van ingyenes és fizetős csomag; néhány Zapier-funkció, például a szűrők, fizetős csomagot igényel.

## Mi az a zap?

A zap két (vagy több) alkalmazás összekapcsolása. Egy eseményindítóból és egy vagy több műveletből áll.

1. Eseményindító: az első alkalmazásban (itt a LearnDash) történik valami.
2. Az első alkalmazás adatai a Zapierhez kerülnek.
3. Szűrő (nem kötelező, fizetős csomag kell): az adatokat módosíthatod vagy szűkítheted.
4. Művelet: az adatok egésze vagy egy része a második alkalmazásba kerül.

## Telepítés

Előbb hozz létre egy fiókot a Zapier webhelyén: kattints a regisztrációs gombra, és kövesd a lépéseket. A fiókot hagyd megnyitva a böngészőben.

### A Kiegészítők menüből (aktív LearnDash-licenc kell)

1. Nyisd meg a **LearnDash LMS → Kiegészítők** oldalt.
2. Keresd meg a **Zapier for LearnDash** kiegészítőt.
3. Kattints a telepítés gombra.
4. Kattints az aktiválás gombra.

### Kézi feltöltéssel

1. Töltsd le a kiegészítő zip-fájlját a LearnDash-fiókodból.
2. A WordPressben nyisd meg a **Bővítmények → Új bővítmény hozzáadása** oldalt.
3. Kattints a bővítmény feltöltésére, válaszd ki a letöltött zip-et.
4. Kattints a telepítésre, majd az aktiválásra.

## Eseményindítók és műveletek

### Eseményindítók

- Beiratkozás kurzusba
- Beiratkozás csoportba
- Csoport teljesítése
- Kurzus teljesítése
- Lecke teljesítése
- Téma teljesítése
- Kvíz kitöltve
- Kvíz teljesítve
- Esszé beküldve

### Műveletek

- Felhasználó hozzáadása kurzushoz
- Felhasználó eltávolítása kurzusból
- Felhasználó hozzáadása LearnDash-csoporthoz
- Felhasználó eltávolítása LearnDash-csoportból

## Új zap létrehozása

### Az eseményindító: „Ha ez történik…”

1. Jelentkezz be a Zapierbe, és kattints a jobb felső sarokban a zap létrehozására szolgáló gombra („Make a Zap”).
2. Adj nevet a zapnak (csak belső használatra).
3. Az alkalmazás kiválasztásánál keress rá a „learndash” szóra, és válaszd ki a LearnDash alkalmazást.
4. Az eseményindító eseményénél válaszd ki a listából a kívántat, majd kattints a folytatásra.
5. Kattints a „Sign in to LearnDash” gombra.
6. Felugrik egy ablak, amely a webhelyed webcímét és egy API-kulcsot kér.
7. A WordPressben nyisd meg a **LearnDash LMS → Zapier → Beállítások** oldalt, és másold ki az API-kulcsot.

### A művelet: „Tedd ezt…”

1. Térj vissza a Zapier felugró ablakába, írd be a webhelyed webcímét és a kimásolt API-kulcsot, majd kattints a „Yes, Continue” gombra. A webcím végén legyen ott a záró perjel (`/`).
2. Kattints a nagy folytatás gombra.
3. A kapcsolatot háromféleképpen tesztelheted: kihagyod a tesztet, tesztelsz és megnézed az eredményt, vagy tesztelsz és folytatod a beállítást. Ha az eredményt megnézed, a választott eseményindítónak megfelelő mintaadatot látsz.
4. Ha a kapcsolat rendben van, az eseményindító mellett zöld pipa jelenik meg.
5. Kattints a „2. Do this…” címsorra.
6. Keress és válassz egy alkalmazást a listából.
7. A műveleti esemény listából válaszd ki a műveletet. A választható műveletek az alkalmazástól függnek (a példában Mailchimp).
8. Kattints a folytatásra, majd jelentkezz be a kiválasztott alkalmazásba, és engedélyezd a hozzáférést. A felugró ablak alkalmazásonként más.
9. A kapcsolat megjelenik a legördülő listában; kattints a folytatásra.
10. Töltsd ki az alkalmazásnak küldendő adatokat. Ez alkalmazásonként más. Ha e-mail-címet küldesz a LearnDashből, mindig a dinamikus „User Data User Email” mezőt használd, ne gépelj be e-mail-címet.
11. Kattints a folytatásra, majd tesztelheted az adatküldést ugyanúgy, mint az eseményindítónál. Sikeres teszt után a másik alkalmazásban is látod az eredményt (a példában egy teszt-feliratkozó jelenik meg a Mailchimp-listán).
12. Kattints a szerkesztés befejezése gombra.
13. Kapcsold be a zapot a képernyő alján lévő kapcsolóval. Bekapcsolt állapotban a jobb felső sarokban zöld „ON” jelzés látszik, és a zap azonnal működik.

## LearnDash-zap és régi webhookos zap

A régi módszerrel (webhookokkal) készült zapok tovább működnek, de az új beállításokhoz a hivatalos LearnDash-alkalmazást ajánlott használni. A Zapierben a kétféle zap az eseményindító ikonjáról ismerhető fel: a régiek piros-narancs webhook-jelet, az újak kék „LD” ikont viselnek.

## Régi beállítás (1.x verzió)

A kiegészítő 2.0 előtti módszere. Nem ajánlott, de ha régi zapokat kell karbantartanod, ez a menete.

### Eseményindító a Zapierben

1. A Zapierben kattints a zap létrehozására, és adj neki nevet.
2. Eseményindító alkalmazásnak válaszd a **Webhooks** elemet, eseménynek a **Catch Hook** lehetőséget, és mentsd.
3. Másold ki a webhook webcímét; a következő lépésben kell.

### A zap beállítása a LearnDashben

1. Nyisd meg a **LearnDash LMS → Zapier** oldalt.
2. Kattints az eseményindító hozzáadására.
3. Adj nevet az eseményindítónak (belső használatra).
4. Eseményindító esemény: válaszd a kurzusba való beiratkozást.
5. Eseményindító kurzus: válassz egy konkrét kurzust, vagy hagyd az összes kurzuson.
6. A webhook webcíme mezőbe illeszd be a Zapierből kimásolt webcímet.
7. Kattints a közzétételre.

A régi módszer eseményei: kurzusba beiratkozás, kurzus, lecke, téma teljesítése, kvíz teljesítése, kvíz sikeres és sikertelen kitöltése, esszé beküldése. A Zapier a WooCommerce eseményeit is ismeri, azokat a Zapier saját WooCommerce-alkalmazásában találod.

### Tesztadat küldése

A Zapiernek tesztadat kell, hogy tudja, milyen adatokat küldjön tovább.

1. Hozz létre egy tesztkurzust: **LearnDash LMS → Kurzusok → Új hozzáadása**, adj címet, a **Beállítások** fülön a beiratkozási mód legyen **Ingyenes**, majd tedd közzé. Leckék nem kellenek; a tesztkurzust később törölheted.
2. Hozz létre tesztfelhasználót: **Felhasználók → Új hozzáadása**, a szerepkör **Feliratkozó** legyen. Mivel az adminisztrátorok minden kurzusba automatikusan be vannak iratkozva, tesztfelhasználó kell; később törölheted.
3. Jelentkezz ki, vagy nyiss privát böngészőablakot, és lépj be a tesztfelhasználóval.
4. Nyisd meg a tesztkurzus oldalát, és kattints a **Take this Course** gombra. Az esemény szerinti művelet elvégzése a választott eseményindítótól függ.
5. A Zapierben kattints az „OK, I did this” gombra, válaszd ki a mintát a listából (a legördülő nyílra kattintva látod, milyen adatot gyűjtött a Zapier), és folytasd.

### A művelet lépése

1. Kattints a lépés hozzáadására, majd az „Action/Search” elemre.
2. Keress a „mailchimp” szóra, és válaszd ki.
3. Műveletnek válaszd az „Add/Update Subscriber” lehetőséget.
4. Kattints a fiók összekapcsolására, jelentkezz be a Mailchimpbe, válaszd ki a fiókot, és folytasd.
5. Válaszd ki a célközönséget (listát).
6. A feliratkozó e-mail-címéhez keresd meg a „User Email” elemet, ne gépelj be valódi címet.
7. A többi mező nem kötelező. Kattints a folytatásra, majd a teszt elküldésére, a befejezésre, végül kapcsold be a zapot.

## További lehetőségek

Fizetős Zapier-fiókkal több műveleti lépést is felvehetsz. Így az adatokat szűrheted és átalakíthatod, mielőtt a Mailchimpbe (vagy másik alkalmazásba) kerülnek.

## Zap-ötletek

| Cél | Mit csinál |
|---|---|
| Kurzusbeiratkozás és e-mail-lista | Beiratkozáskor a felhasználó felkerül az e-mail-listára |
| Kurzusbeiratkozás és CRM | Beiratkozáskor a felhasználó felkerül a CRM-adatbázisba |
| Kurzusbeiratkozás és ügyfélszolgálati rendszer | Beiratkozáskor fiókot hoz létre a felhasználónak |
| Kvízadatok táblázatban | A sikeres és sikertelen kvízeket táblázatba (Google Táblázatok, Excel) írja |
| Lecke vagy téma teljesítése és Slack | Üzenetet küld egy Slack-csatornára |
| Kurzus teljesítése és e-mail | E-mailt küld a felhasználónak vagy az adminoknak, minden vagy egy adott kurzusnál |
| Kurzus teljesítése és címke vagy egyéni mező | A CRM-ben címkét vagy egyéni mezőt állít be |
| WooCommerce előfizetés hibája és SMS | Szöveges üzenetet küld, ha egy előfizetés megújítása sikertelen |

## Gyakori kérdések

**Kizárhatom az előrendelt kurzusokat a „beiratkozás kurzusba” zapokból?**
Igen. Állítsd az előrendelt kurzusok kizárása mezőt „true” értékre.

**Működik az „Enrolled into course” eseményindító, ha a kurzus beiratkozási módja Megnyitás?**
Nem. Ennél az eseményindítónál a kurzus módja nem lehet **Megnyitás**.

**Hogyan módosíthatom a Zapiernek küldött adatokat?**
A `learndash_zapier_api_payload` szűrővel további adatokat (felhasználói vagy kurzus-metaadatot) fűzhetsz a küldött adatcsomaghoz. Példa:

```php
add_filter( 'learndash_zapier_api_payload', function( $payload, $subscription, $trigger ) {
    if ( isset( $payload['user'] ) ) {
        $payload['user']->custom_data = 'abc123';
    }

    return $payload;
}, 10, 3 );
```

**Hitelesítési hibát kapok, amikor a LearnDash-fiókot összekötöm a Zapierrel. Mit tegyek?**
A hibát általában a gyorsítótár-bővítmény vagy egy biztonsági bővítmény okozza, amely blokkolja a LearnDash webcímlekérdezési végpontját. Engedélyezd (tedd kivétellistára) a gyorsítótár- vagy biztonsági bővítményben ezt a címet: `webhely.hu/?learndash-integration=zapier`.