Hivatalos Gorgias integráció a PrestaShophoz – Dokumentáció
PrestaShop modul, kompatibilis az 1.7.x – 8.1 verziókkal
Hamarosan érkezik az új kiadás, amely kompatibilis az 1.7.x – 9.X verziókkal.
A legfrissebb verzió letölthető innen: Prestashop Addons oldal
A hivatalos dokumentáció elérhető az alábbi nyelveken:
Videós telepítési útmutató:
Mit találsz ebben az útmutatóban
Telepítési lehetőségek és lépések
Megjegyzés: Ha újratelepíted a modult, készíts biztonsági mentést a Gorgiasban létrehozott egyedi makrókról, mivel ezek felülíródnak.
Megjegyzés: A modul telepítése után kérjük, figyelj az alábbi telepítési lehetőségek alatt található Apache/Nginx konfigurációs útmutatóra, különösen akkor, ha a szervered Nginx-et használ.
1. lehetőség: Telepítés a PrestaShop Addons fiókon keresztül
Csatlakoztasd az áruházadat az Addons fiókhoz, és töltsd le közvetlenül a modult.
2. lehetőség: Feltöltés a Back Office-on keresztül
- Menj a Modulok > Modulkezelő menüpontra
- Kattints a „Modul feltöltése” gombra a jobb felső sarokban
- Válaszd ki a .zip fájlt
- Folytasd a konfigurálással (lásd az alábbi lépéseket)
3. lehetőség: Feltöltés FTP-n keresztül
- Csomagold ki a modul fájlait helyben
- Töltsd fel őket a szervereden található /modules mappába
- Folytasd a konfigurálást a back office felületen
Telepítési lépések
1) Lépj be a Prestashop áruházad adminisztrációs back office felületére.
2) Nyisd meg a bal oldali főmenüben a Modulok menüpontot.
3) Nyisd meg az „Modulkezelő” almenüt.
4) Keresd meg az Official Gorgias Integration - Helpdesk modult, majd kattints az Telepítés gombra.
- Keresd meg az „Official Gorgias Integration - Helpdesk” nevű modult.
- Válaszd a „Telepítés” opciót a modul feltöltéséhez és telepítéséhez.
Megjegyzés: Ha a web szervereden futó PHP nem tartalmazza a ZipArchive komponenst, manuálisan kell kicsomagolnod az „installPack.zip” fájlt az adminisztrációs mappába FTP-n keresztül.
5) A telepítés után válaszd a modul konfigurálása lehetőséget.
6) Ha a következő modulok nincsenek telepítve, kattints az „Engedélyezés és folytatás” gombra, hogy a modul telepítse a szükséges Prestashop modulokat:
- ps_accounts
- ps_eventbus
- ps_mbo
7) Belépsz a back office-ba, ahol összekapcsolhatod a Prestashop Addons fiókodat az áruházzal (ha még nem tetted meg):
8) Miután összekapcsoltad a Prestashop fiókodat, megjelennek a mezők, ahol összekapcsolhatod a Prestashopot a Gorgias-szal. Innen csak ki kell választanod a megfelelő legördülő menükben, hogy az áruházadban mely státuszok felelnek meg a törölt és visszaküldött rendeléseknek, majd végül hozzákapcsolni a modult a Gorgias előfizetésedhez azáltal, hogy beírod a „Gorgias URL” mezőbe a Gorgias fiókod URL-jét.
Apache/Nginx szerver konfiguráció
Apache esetén:
Győződj meg róla, hogy a következő sor szerepel a .htaccess fájlban (gyökérkönyvtár):
SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1Ha nincs benne, add hozzá kézzel, majd mentsd el a fájlt.
Nginx esetén:
Add hozzá ezt a webhelyed konfigurációjához:
location / { if ($http_authorization ~ "(.*)") { set $http_authorization $1; }}Gorgias Account-tal való összekapcsolás
A modul telepítésekor automatikusan telepíti a Gorgias alkalmazást. Ellenőrzéshez:
-
Jelentkezz be a Gorgias irányítópultodra
-
Lépj a Beállítások > Saját alkalmazások menüpontra
-
Keresd meg a PrestaShop integrációt
Ha nem találod a listában, térj vissza a PrestaShop modulhoz, és kattints a Csatlakozás gombra.
Mit nyújt az integráció
Ez az alkalmazás szinkronizálja a rendelési és felhasználói adatokat a PrestaShop áruházad és a Gorgias fiókod között, továbbá makrókat és változókat ad hozzá az ügyfélkommunikáció automatizálásához. Ez azt jelenti, hogy amikor egy PrestaShop áruházadban regisztrált felhasználótól érkezik jegy, az adataik és rendeléseik a jegy jobb oldalán lesznek láthatók a Gorgiasban, lehetővé téve a gyorsabb és hatékonyabb ügyfélszolgálatot.
Kezdeti szinkronizáció
Ha ez az első alkalom, hogy a telepített alkalmazással jegyeket használsz, és azt veszed észre, hogy nincs szinkronizálva felhasználói vagy rendelési adat, valószínűleg azért van, mert még nem történt olyan esemény, amely adatfrissítést indítana el. A megoldás egyszerű: végezz bármilyen műveletet a jegyen, ami eseményt indít az alkalmazásunkban, és lekéri a felhasználó adatait és rendeléseit. Ez csak azoknál a jegyeknél történik meg, amelyek már nyitva voltak az alkalmazás telepítése előtt.
Funkciók és információk a Prestashopból érkező Gorgias jegyeidről:
Itt egy példa arra az információra, amit a Gorgias oldalsávjában láthatsz, amikor egy adott ügyféllel folytatott kommunikációt nézel át:
Rendelés- és ügyféladatok a Gorgiasban
- Teljes rendelési összeg: A vásárló által leadott rendelések összértéke.
- Rendelések száma összesen: A vásárló által leadott rendelések száma.
Ezek alatt találod a rendeléslista megjelenítését, amely a képen világoskék színnel látható. Például:
5 (KHWLILZLL) > Ezek az adatok a PrestaShop rendelési azonosítóra (5) és a rendelési hivatkozási kódra (KHWLILZLL) utalnak.
Műveletek
Minden egyes rendelés esetében az alábbi információk és műveletek érhetők el:
- Visszatérítés: Ez a művelet elindít egy visszatérítést a PrestaShopban (nem szinkronizált a bankszámláddal). Győződj meg róla, hogy az áruházadban engedélyezve van ez az opció a megfelelő működéshez.
- Raktárba visszatevés: Hasonló az előző művelethez, visszatérítést hajt végre, és ha a rendelés státusza a PrestaShopban engedi, visszateszi a termékeket a készletbe. Technikai korlátozások miatt előfordulhat, hogy ez a művelet nem állítja helyre a készletet bizonyos esetekben, és a Gorgias ilyen üzenetet jelenít meg:
- Mégse: Ez az opció törli a rendeléseket a PrestaShop áruházadban.
Értesítés: A Prestashop API korlátozása miatt a rendelés státuszának frissítése csak a következő esetekben működik:
- Ha a rendelést már kiszállították, akkor az elérhető művelet a termék visszaküldése.
- Ha a rendelés ki van fizetve, de még nincs kiszállítva, akkor az elérhető művelet a normál visszatérítés.
- Minden egyéb esetben az elérhető művelet a rendelés törlése.
Általános rendelési információk:
- Rendelésazonosító
- Rendelés dátuma
- Rendelés státusza
- Az áruház, ahol a rendelést leadták (hasznos, ha több áruház is kapcsolódik a Gorgias fiókodhoz)
- A rendelés teljes összege
- Vásárló azonosító a PrestaShopban
- Vásárló neve
- Vásárló email címe
- Jelzés, hogy a vásárló regisztrált vagy vendég
- Szállító azonosító vagy nyomon követési referencia (ez az információ alapértelmezettként a PrestaShoptól érkezik, és nem tükrözi a harmadik féltől származó integrációkat).
- Szállítási és számlázási cím adatai
- Számlázási cím adatai
- A rendelésben szereplő termékek és mennyiségek
Makrók használata
A modul automatikusan létrehoz makrókat a Gorgias fiókodban az ügyfélválaszok egyszerűsítése érdekében. Megtalálásukhoz:
- Lépj a Beállítások > Makrók menüpontra
- Keresd meg a PrestaShop előtaggal ellátott makrókat
További információkat a makrók használatáról a Gorgias hivatalos dokumentációjában találhatsz itt (https://docs.gorgias.com/en-US/articles/macros-18381).
Megjegyzés: Ha testre szabod ezeket a makrókat, készíts róluk biztonsági mentést a modul újratelepítése előtt, hogy elkerüld a változtatások elvesztését.
Ahhoz, hogy megtaláld az általunk generált makrókat, lépj be a Gorgias irányítópultodra. A felső legördülő menüben válaszd a „Beállítások” opciót. Ezután a jobb oldali menüben válaszd a „Makrók” menüpontot. Itt megjelenik a fiókodban elérhető makrók listája. A PrestaShop rendelésekhez kapcsolódó makrókat a nevükben a „Prestashop” előtag jelzi.
További információkért a jegyeid kezeléséről a Gorgiasban, megtekintheted a hivatalos dokumentációjukat:
https://www.gorgias.com/product/helpdesk
Fontos megjegyzések
Gorgias előfizetési korlátozások:
- Használatod a Gorgias előfizetésed korlátaihoz lesz kötve, beleértve a havi megnyitható jegyek számát és a kapcsolódó költségeket.
- Ha nem találod az alkalmazást a Gorgias irányítópultodon, térj vissza a Prestashop modulodhoz, és kattints újra a „Csatlakozás” gombra.
Hibaelhárítás és újratelepítés
Problémák az alkalmazás szinkronizációjával:
- Lépj be a Gorgiasban a Saját alkalmazások menübe
- Válaszd ki a PrestaShop alkalmazást, majd kattints a „Kapcsolat bontása” gombra
- Lépj az App Store > HTTP Integrations > Kezelés menübe, majd kattints a „HTTP integráció törlése” gombra
- Térj vissza a PrestaShophoz, és kattints újra a „Csatlakozás” gombra
A modul újratelepítése:
- Az újratelepítés törli és újra létrehozza a makrókat
- Mindig készíts biztonsági mentést a makrókban végzett kézi módosításaidról
Gyakran Ismételt Kérdések
Újdonságok a 2.0.2-es verzióban
Gorgias chat integráció
Mostantól közvetlenül integrálhatod a Gorgias chat widgetet a PrestaShop áruházadba.
Beállítás menete:
- Másold ki az installációs scriptet a Gorgias fiókodból.
- Illeszd be a kódot a modul „Chat Script” mezőjébe.
- Kattints a „Csatlakozás” gombra az integráció befejezéséhez.
Csatlakozás után a chat widget automatikusan megjelenik a vásárlók számára az áruházadban.
Hol találod meg a chat scriptet a Gorgiasban:
- A Gorgias irányítópultjában lépj az oldalsó menübe: Beállítások > Csatornák > Chat
- Ha még nem állítottad be a chatet, kövesd a lépéseket a hivatalos dokumentáció oldalon: Gorgias Chat – Hivatalos dokumentáció
- Beállítás után lépj az Telepítés fülre.
- A Kézi telepítés szakaszban válaszd az „Bármely más weboldal” opciót
- Másold ki a 3. lépésben található kódot, és illeszd be a PrestaShop modulba.
HTTP hitelesítés alapfunkciói
Ha az áruházad alapvető hitelesítéssel (felhasználónév és jelszó) védett, mostantól tesztelheted a PrestaShop widgetet közvetlenül a Gorgias jegyekben.
Aktiválás menete:
- Írd be a felhasználóneved és jelszavad a modul megfelelő mezőibe.
- Kattints a „Csatlakozás” gombra a hozzáférés érvényesítéséhez.
Ez a funkció lehetővé teszi a widget előnézetét akkor is, ha az oldalad nem elérhető nyilvánosan.
