Zapier-integráció

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:

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.