WooCommerce — a PolyOS pluginnal
Az ajánlott út WooCommerce-bolthoz: a bolt küldi az adatot, ezért a tárhely bot-védelme nem akadályozza. A régi rendelések is feltölthetők.
Ez az ajánlott út, ha a boltod WooCommerce. A bolt küldi az adatot a PolyOS-nak, nem mi kérdezzük le tőle — és pont ez a lényeg.
Sok magyar tárhelyen a bot-védelem (BitNinja, ModSecurity) kívülről nem engedi be a WooCommerce REST API-t: a kérésre 403 és egy „Hitelesítés / Verification" oldal jön vissza JSON helyett. Ilyenkor az API-kulcsos bekötés akkor sem működik, ha a kulcs tökéletes.
A kimenő irányt viszont a bot-védelem nem érinti. A plugin megfordítja az irányt: a boltban futó kód küld, mi fogadunk. Bónusz: így a régi rendelések is feltölthetők egyetlen gombbal.
Mi lesz a végeredmény #
- Minden rendelés dealként landol a CRM-ben, a vevő kontaktként, a vásárlási összesítőjével együtt.
- A régi rendelések és vevők is behúzhatók, visszamenőleg.
- A készlet is látszik a PolyOS Áttekintés oldalán („Készlet — mennyi van még").
- Ha a boltban van átvételi/szállítási időpont, az is átjön — és időzíteni lehet rá emlékeztetőt.
Mire lesz szükséged #
- WordPress-admin a boltban, WooCommerce-kezelő joggal
- A PolyOS-ban tulajdonosi vagy admin jog
- Kb. 10 perc
1. lépés — Párosító kód kérése (PolyOS) #
Bal menü → Webshop → az egység sorában a legördülőből WooCommerce (PolyOS plugin) → Bekötés.
Itt egyben letöltöd a plugint is (Plugin letöltése (.zip)), majd nyomd meg a Párosító kód generálása gombot. A kód egyszer látszik teljes egészében — másold ki rögtön.
A kód dönti el, melyik fiók melyik egységéhez tartozik a beérkező adat. Aki megszerzi, a te CRM-edbe tud rendelést írni. Csak a plugin mezőjébe illeszd be; ne küldd chaten, ne tedd képernyőképre.
Ha mégis kiszivárgott: generálj újat — a régi azonnal érvényét veszti. (A már behozott rendelések megmaradnak.)
2. lépés — A plugin telepítése (WordPress) #
WordPress-admin → Bővítmények → Új hozzáadása → Bővítmény feltöltése → válaszd ki a letöltött .zip-et → Telepítés, majd Aktiválás.
3. lépés — Párosítás (WordPress) #
A bal menüben: WooCommerce → PolyOS kapcsolat.
| Mező | Mit írj bele |
|---|---|
| PolyOS cím | Hagyd, ahogy van. Csak akkor írd át, ha külön kérjük. |
| Párosító kód | Az 1. lépésben kimásolt kód |
Majd Mentés.
4. lépés — Kapcsolat tesztelése #
Ugyanezen az oldalon, lejjebb: Kapcsolat tesztelése.
Ha jó a kód, visszaírja, melyik egységhez kapcsolódott. Ha nem, a hibaüzenet megmondja, mi a baj — a leggyakoribb az elgépelt vagy időközben újragenerált kód.
Az oldal kiírja, hogy a boltban jelenleg hány rendelés és hány regisztrált vásárló van. A feltöltés után ehhez tudod hasonlítani, hogy tényleg minden átment-e.
Ha 0 regisztrált vásárlót ír, az általában nem hiba: azt jelenti, hogy a boltban vendégként (regisztráció nélkül) vásárolnak. Ilyenkor a vevő a rendelésből kerül a CRM-be, tehát nem veszik el senki.
5. lépés — A régi rendelések feltöltése #
Régi rendelések és vevők feltöltése. Ez hozza be a bolt eddigi történetét.
Idempotens: bármennyiszer megnyomhatod, ugyanaz a rendelés nem kerül be kétszer, és a vásárlási összesítő sem nő újra. Nagy boltnál több kört is futtathat — türelem, a gomb jelzi, hol tart.
A visszamenőleges feltöltés szándékosan nem tüzel automatizmust. Senki nem akar 900 „új rendelés" e-mailt a múltból. A workflow-k a következő ÉLES rendeléstől indulnak.
6. lépés — Készlet (nem kötelező) #
Készlet szinkron most — felküldi az összes termék készletét. Utána a változásokat a plugin magától küldi, nem kell újra megnyomni.
Darabszám csak azoknál a termékeknél lesz, ahol a boltban be van kapcsolva a készletkezelés. Ami nélküle van, az a listán megjelenik, csak szám nélkül.
Átvételi / szállítási időpont #
Ha a boltban egy másik bővítmény (pl. Order Delivery Date) bekéri az átvételi vagy szállítási időpontot, a PolyOS át tudja venni — és időzített emlékeztetőt lehet rá kötni („a foglalás előtt 24 órával küldj levelet").
A plugin beállító-oldalán két legördülő van: Dátum mezője és Idősáv mezője. A választékot a plugin a bolt saját legutóbbi rendeléseiből olvassa ki, minta-értékkel együtt — nem kell tudnod előre, melyik bővítmény hogyan nevezi a mezőt. A valószínű jelöltek elöl vannak.
Ha a boltban nincs ilyen, hagyd üresen — akkor semmi nem megy át, és ez nem hiba.
Ha kiválasztottál egy dátum-mezőt, az oldal rögtön megmutatja, mi jönne ki a legutóbbi rendelésből. Ha zöld pipát látsz az értékkel, jó mezőt választottál. Ha azt írja, hogy a mező üres vagy nem sikerült időponttá alakítani, válassz másikat.
Ez azért fontos, mert enélkül csak az éles adatból derülne ki a tévedés — akkor viszont már rossz időpontra ment ki egy emlékeztető.
Szegmens-szabályok — ezek NEM a pluginban vannak #
Azt, hogy melyik termék vásárlója melyik szegmensbe kerüljön, és milyen mezőket mentsen hozzá a rendszer, a PolyOS-ban állítod be: Webshop → az egység sorában Besorolási szabályok.
Szándékosan ott van, és nem a pluginban: így a szabály a plugin frissítése nélkül módosítható, és minden bolt-bekötésre egyszerre érvényes — az API-s útra is.
Új szabály a következő rendeléstől él. Visszamenőleg a Régi rendelések és vevők feltöltése gombbal érvényesíthető (nem duplikál).
Ellenőrzés — mit ír az állapotsor #
Az egység kártyája alatti sor mindig megmondja, hol tart a dolog.
| Amit látsz | Mit jelent | Mit tegyél |
|---|---|---|
| „A plugin még nem küldött adatot…" | A kód ki van adva, de a boltból még semmi nem érkezett | Telepítsd és párosítsd a plugint, majd nyomd meg benne a feltöltés gombot |
| „Plugintól érkezett · utolsó adat: …" | Minden rendben, ennyi jött be | — |
| Piros hibaüzenet | A plugin küldött, de valami elakadt | Az üzenet megmondja; a plugin oldalán az „Utolsó küldés" sor is mutatja |
Mit NEM továbbít a plugin #
Jelszót és fizetési adatot nem. Kizárólag rendelést és vevőt küld, HTTPS-en, a párosító kóddal hitelesítve, kizárólag a beállított PolyOS-címre.
Ha elakadsz #
Két helyen van állapotüzenet, és majdnem mindig megmondják a választ: a plugin oldalán az „Utolsó küldés" sor, a PolyOS Webshop oldalán pedig az egység alatti sor. Ha egyik sem segít, írj a support@polyos.hu címre, és küldd el, mit írnak.