WooCommerce integráció

WooCommerce egy ingyenes webáruház kiegészítő a Wordpress rendszerhez. A WooCommerce egyszerűen integrálható SalesAutopilot-tal bővítmény (plugin) vagy webhook segítségével.

FONTOS: A WooCommerce folyamatos változásait sajnos nem tudjuk nyomonkövetni, így - bár Tudásbázis bejegyzéseinket folyamatosan frissítjük - előfordulhat, hogy a WooCommerce felületén kisebb változások megjelentek, melyeket mi nem frissítettük. A WordPress és a WooCommerce rengeteg verzióval rendelkezik, így sajnos ügyfélszolgálatunk nem tud segíteni a WooCommerce hibájából eredendő problémák megoldásában. Amennyiben a hiba nem a SalesAutopilot rendszerében van, hanem a WooComerce-nél merül fel, javasoljuk, hogy az integráció és a használat kérdéseiben keresse megvalósító partnereinket vagy más SalesAutopilot integrációban jártas szakember támogatását.

Beállítás a SalesAutopilotban

1. Webshop integráció beállítások

Kattintson a bal oldali menü Beállítások / eCommerce / Webshop integráció beállítások (1) menüpontjára. A megjelenő képernyőn a Termék szinkronizáció blokkban két beállítási lehetőség közül választhat.

A Termék megfeleltetés (2) opciót akkor érdemes választania, ha 1000 terméknél kevesebbet kezel a webshopjában. Ha 1000-nél több terméke van, és Termék megfeleltetést használ, akkor számolnia kell azzal, hogy a termékfeltételt tartalmazó szegmensek beállítása a nagy adatbázis miatt lassúak lehetnek. Ezen opció választása esetén a SalesAutopilotban meg fognak jelenni azon Woocommerce termékei amelyekből legalább egy rendelés már történt az integráció beállítása után.

A Termék kategória - SalesAutopilot termék megfeleltetés (3) opciót akkor érdemes választania ha több, mint 1000 terméke van a webshopban. Ebben az esetben a SalesAutopilotban a rendelt termékek kategóriái fognak megjelenni. Például ha érkezik egy rendelés, amelyben három termék a babaápolás kategóriában szerepel és két termék a tejtermékek kategóriában, akkor a SalesAutopilotban ez úgy fog megjelenni, hogy érkezett három babaápolás megrendelés és két tejtermék megrendelés. A termék neve nem fog megjelenni a SalesAutopilotban.

2. Listák és űrlapok létrehozása

Az integrációhoz szüksége van email listák és űrlapok létrehozására a SalesAutopilotban. A rendelések fogadásának érdekében, szükséges egy megrendelés lista, és hozzá egy megrendelő/technikai űrlap.

Az újabban regisztrált fiókokban elérhetőek az Indulást segítő ellenőrzőlisták, ennek használatával (1. pont) igazán egyszerűen létre tudja hozni a Megrendelő listáját és a hozzá tartozó technikai űrlapot, amelyen keresztül fognak érkezni a megrendelések a SalesAutopilotban. Ha Önnek régebbi fiókja van, akkor létre kell hoznia a megrendelő listát és a megrendelő űrlapot is a 2. pont szerint.

A hírlevélre feliratkozók adatainak fogadása érdekében pedig létre kell hoznia egy hírlevél listát, és hozzá egy feliratkozó űrlapot is (3. pont).

1. Megrendelési lista és technikai űrlap létrehozás az Ellenőrző lista segítségével
2. Megrendelési lista és megrendelő űrlap létrehozás
3. Feliratkozó lista és feliratkozó űrlap létrehozása
4. Státuszváltozást kezelő űrlap létrehozása

1. Megrendelési lista és technikai űrlap létrehozás az Ellenőrző lista segítségével

Az Ellenőrzőlistát a bal oldali sávban a villám ikonra kattintva tudja előhozni.

Itt kattintson a Webshop összekapcsolás (1), majd a 1. Lista létrehozása (technikai űrlappal) (2) opcióra.

Írja be a Lista nevét (1), majd kattintson a "Fenti adatok véglegesítése" gombra (2).

A képernyő újratöltődik, és megjelennek a lista mezői. Itt egyelőre nincs szükésge módosításra, csak görgessen a képernyő aljára és kattintson a "Fenti adatok véglegesítése" gombra (1).

Ekkor létrejön a megrendelési listája (1) és a hozzá tartozó "Webshop integrációhoz" űrlap (2). A bal oldali menüben így látható:

2. Megrendelési lista és megrendelő űrlap létrehozás

A megrendelő listáját hozza létre a Megrendelés lista létrehozása c. Tudásbázis cikkünk alapján.

Mielőtt létrehozza a megrendelő űrlapot létre kell hoznia egy tetszőleges Terméket és egy tetszőleges Szállítási és fizetési módot. Nyugodtan nevezze el pl. Tesztnek, ez csak az összekötéshez kell, és a későbbiekben ez nem lesz használva.

A Megrendelő űrlap létrehozása cikkünk alapján hozza létre az űrlapot az alábbiak figyelembevételével:

• Az űrlap létrehozásakor, a szerkesztés első lépésében a 'Milyen típusú megrendelő űrlapot szeretne létrehozni?' opció esetében válassza a 'Több termékes megrendelés, mindegyikből több rendelhető' lehetőséget.
• Az űrlapra mindegy milyen terméket, mezőket illetve köszönőoldalt állít be, ez az űrlap csak a WooCommere-ből való adatok fogadására lesz használva.

 3. Feliratkozó lista és feliratkozó űrlap létrehozása

Az alábbi Tudásbázis cikkeink alapján tudja létrehozni ezeket:

• Egyszerű e-mail lista (hírlevél lista) létrehozása
• Feliratkozó űrlap készítése

4. Státuszváltozást kezelő űrlap létrehozása

Amennyiben szeretné a webshopban történt státuszváltozást követni a SalesAutopilotban, akkor létre kell hoznia ehhez egy Adatmódosító űrlapot. Az űrlapvarázsló 2. lépésében egy tetszőleges mezőt megadhat, pl. a feliratkozó email címét, és a köszönőoldal tartalma is irreleváns. Ez az űrlap csak technikailag szükséges a rendszer számára, hogy ezen keresztül tudja követni a megrendelések állapotát. Ezt az űrlapot tudja megadni a WooCommerce plugin beállításainál "A többi státuszváltást kezelő űrlap" legördülőben.

3. API kulcs létrehozása

Ha még nem rendelkezik SalesAutopilotos API kulccsal hozzon létre egyet a bal oldali menü Beállítások / Integráció / API kulcsok menüpontjában. Részletes beállítási útmutatót itt talál.

Beállítás WooCommerce-ben

Kétféle beállítási módot mutatunk be a WooCommerce-ben: (1) bővítmény segítségével, ez az egyszerűbb, és (2) webhookkal. Azért fontos ez, mert előfordulhat, hogy más Woocommerce kiegészítők megakadályozzák a SalesAutopilot bővítmény működését, és ebben az esetben a webhook-os integrációt kell beállítani.

Integráció bővítmény segítségével

Először töltse le a bővítményt Wordpress Plugin Directory oldalról. Telepítse a bővítményt majd aktiválja.

A bal oldali menüben kattintson a WooCommerce, majd alatta a Beállítások menüpontra, majd felül válassza az Integráció fület. A képen látható felületre fog érkezni, ahol meg tudja adni az integrációhoz szükséges adatok és különböző beállításokra is lehetősége van.

1. API kulcsok megadása

Írja be a SalesAutopilot API felhasználónevét és jelszavát. Itt találja meg a SalesAutopilot-ban az API felhasználónevét és jelszavát. Kattintson a Módosítások mentése gombra.

2. Megrendelések átadásának megadása

A Módosítások mentése gombra kattintás után a Megrendelés lista legördülőben megjelennek a megrendelés listái. Válassza ki azt a listát, amelybe szeretné hogy bekerüljenek a WooCommerce-n keresztül érkezett megrendelések. Kattintson ismét a Módosítások mentése gombra, majd válassza ki a Megrendelő űrlap legördülőből azt az űrlapot, amelyen keresztül szeretné, hogy a megrendelések bekerüljenek. Ha az űrlaphoz tartoznak műveletek, akkor azok végrehajtásra kerülnek a megrendelés rögzítésekor. 

3. Fizetett státusz átadása és számlázás

Amennyiben azt szeretné, hogy a fizetett státusz beállítása (amelyet a Woocommerce a "Feldolgozás alatt" státusszal jelöl) számla generálást vonjon maga után, a megrendelő listán készítsen egy érkeztető űrlapot ezen bejegyzésünk alapján, amelyen beállítja a kívánt számlázási beállításokat, majd ezt az űrlapot válassza ki a Számlázó űrlap legördülő mezőben. A fizetett státusz az itt beállított űrlapon kerül átadásra a SalesAutopilotnak. 

Ha nem szeretné, hogy a fizetett státusz átadásakor számla álljon ki a SalesAutopilotban, akkor itt a státuszváltozást kezelő űrlapot adja meg. 

Bankkártyás megrendelések kezelése és számlázása

A bankkártyás megrendelések átadása a WooCommerce-ből a SalesAutopilotnak különös odafigyelést igényel. Ennek az az oka, hogy a SalesAutopilot API-ján keresztül érkező bankkártyás webshop megrendelések esetében a megrendelő űrlapon a használt fizetési módhoz beállított számla mindenképpen el fog készülni, függetlenül attól, hogy a fizetés valóban megtörtént-e. A fizetés sikeréről a WooCommerce-ből a számlázó űrlapon keresztül értesül a SalesAutopilot, ezért a bankkártyás fizetési módok esetében minden, a fizetés sikerességétől függő folyamatot a számlázó űrlaphoz kell kapcsolni a megrendelő űrlap helyett.
Ez a gyakorlatban általában azt jelenti, hogy:

• A megrendelő űrlapon kizárólag nem bankkártyás fizetési módhoz tartozik számlázás
• A feliratkozáskori levelek időzítéseiből ki vannak zárva a bankkártyás megrendelések feltétellel vagy szegmenssel
• A bankkártyás megrendelések számlázása a számlázó űrlapon történik.
• A számlázó űrlaphoz kapcsolódóan a feliratkozáskori levelekhez tartozik adatmódosításkori időzítés

Természetesen minden rendszer egyedi, így a fenti pontok csupán útmutatásul szolgálnak, alkalmazásuk az egyes rendszerekre alkalmazva átgondolást igényel.

4. Megrendelés állapotváltozásának átadása

Amennyiben szeretné, hogy a megrendelések állapotának változása átadásra kerüljön a SalesAutopilotnak, akkor "A többi státuszváltást kezelő űrlap" legördülőben válassza ki az erre a célra létrehozott adatmódosító űrlapot. Ebben az esetben a megrendelés új állapota automatikusan átadásra fog kerülni a SalesAutopilot felé, és a megrendelésnél frissül a "Webshop megrendelés állapota" mezőben.

5. Hírlevél feliratkozás

Ha szeretné, hogy a megrendelés véglegesítésekor megjelenjen a hírlevélre feliratkozás checkbox, akkor jelölje be a Hírlvél feliratkozás jelölőnégyzetet, majd válasszon ki egy email listát és a hozzá tartozó űrlapot, amelybe a megrendelő feliratkozóként be fog kerülni.

6. Vezetéknév és keresztnév felcserélése

Bizonyos Woocommerce telepítéseknél a szótárban fel van cserélve a vezetéknév és keresztnév. Emiatt a SalesAutopilot-ba is megcserélve kerülnek be a nevek. Ellenőrizze egy teszt rendelés leadásával, hogy az Ön Woocommerce-ében előfordul-e a jelenség. Ha igen, akkor jelölje be a Vezetéknév és keresztnév felcserélése opciót, különben vegye ki a jelölést.

Ha minden beállítással végzett, kattintson ismét a Beállítások mentése gombra.

Ezzel elvégezte a szükséges beállításokat. Mostantól a WooCommerce webáruházban leadott megrendelések automatikusan bekerülnek a kiválasztott SalesAutopilot listába.

Integráció webhook segítségével

A webhook beállításáról itt található leírás: Woocommerce webhooks. Hozzon létre egy új webhook-ot. A Topic opciónál állítsa be az Order Created opciót. A Delivery URL beviteli mezőbe pedig a következő értéket állítsa be:
https://sw.marketingszoftverek.hu/sw/callback/woocommerce/{api_username}/{api_password}/{megrendeles lista azon}/{megrendeles urlap azon}

Az {api_username} és {api_password} értékéhez a SalesAutopilot API felhasználónevét és jelszavát állítsa be. Itt találja meg a SalesAutopilot-ban az API felhasználónevét és jelszavát. A {megrendeles lista azon} helyére írja be a megrendelő lista azonosítóját, amelybe szeretné hogy bekerüljenek a WooCommerce-n keresztül érkezett megrendelések. A {megrendeles urlap azon} helyére pedig írja be a megrendelő űrlap azonosítóját, amelyen keresztül szeretné, hogy a megrendelések bekerüljenek. Ha az űrlaphoz tartoznak műveletek, akkor azok végrehajtásra kerülnek a megrendelés rögzítésekor.

Ha végzett a beállítással, akkor onnantól kezdve a megrendelések átkerülnek a beállított megrendelés listába.

Milyen adatokat fogad a SalesAutopilot automatikusan, ha a Woocommerce-ben be van állítva a SalesAutopilot integráció?

Ha a Woocommerce-ben be van állítva a SalesAutopilot integráció, akkor egyrészt az ott vásárlók automatikusan bekerülnek egy SalesAutopilot hírlevél listába (amennyiben megrendeléskor bejelölték, hogy szeretnének hírlevelet kapni az akciókról, újdonságokról), másrészt a megrendelések bekerülnek egy SalesAutopilot megrendelés (eCommerce) listába az alábbi adatokkal:

• megrendelő email címe
• megrendelő neve
• megrendelő telefonszáma
• megrendelő címe
• megrendelt termék(ek)
• a termék(ek) darabszáma
• nettó ár
• bruttó ár
• szállítási mód
• fizetési mód

A megrendelések fogadásakor - amennyiben még nem szerepel a SalesAutopilotban - automatikusan létrejön

• a Szállítási és fizetési mód
• a Termék

A termékfeltétel funkció használatával a későbbiekben szegmentáltan küldhet emailt például csak azoknak, akik adott termékből vásároltak vagy éppen nem vásároltak.