Magento integracija

Prijunkite savo Magento 2 (Open Source / Adobe Commerce) parduotuvę prie Conviro, kad pokalbių robotas galėtų sekti užsakymus, tvarkyti atšaukimus ir grąžinimus bei atsakyti į klausimus apie prekes tiesiai pokalbyje.

Prijungti galima dviem būdais ir abu atveria tas pačias srautų galimybes:

1. Su oficialiu Conviro plėtiniu – automatinė sąranka vienu paspaudimu. Rekomenduojama daugumai pardavėjų.
2. Be jokio plėtinio – rankinė sąranka naudojant savąją Magento REST API ir nedidelį valdiklio kodo fragmentą. Rinkitės šį būdą, jei negalite (arba nenorite) diegti trečiųjų šalių modulių.

> Svarbiausia: plėtinys yra patogumo sluoksnis, o ne būtinybė. Užsakymų sekimas, atšaukimas, grąžinimai ir prekių paieška veikia per savąją Magento REST API Conviro vidinėje sistemoje – todėl veikia abiem atvejais. Plėtinys tiesiog automatizuoja sąranką, valdiklio įterpimą ir įvykių webhook'us.

Reikalavimai

• Pro planas arba aukštesnis
• Magento 2.4+ (Open Source / Community arba Adobe Commerce)
• Administratoriaus prieiga prie jūsų Magento parduotuvės
• Jūsų Conviro API raktas (sugeneruokite jį čia: Dashboard -> Settings -> API Keys)

A metodas – Su oficialiu plėtiniu (rekomenduojama)

Greičiausias kelias. Vienas laukas, vienas paspaudimas – ir viskas sujungta už jus.

Diegimas

1. Įdiekite modulį per Composer:

composer config repositories.conviro composer https://repo.conviro.io
composer config http-basic.repo.conviro.io api <YOUR_CONVIRO_API_KEY>
composer require conviro/module-aichat
php bin/magento module:enable Conviro_AiChat
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:flush

(Arba įkelkite plėtinio ZIP failą iš Conviro valdymo skydelio, jei nenaudojate Composer.)

1. Magento administravimo srityje eikite į Stores -> Configuration -> Conviro -> AI Chat.
2. Įklijuokite savo Conviro API raktą ir spustelėkite Save Config.

Kas įvyksta automatiškai

Išsaugojus API raktą, plėtinys:

• Sukuria Magento integraciją pavadinimu „Conviro AI Chat“ su mažiausių privilegijų REST leidimais (Sales orders, Catalog products, Customers, Carts) ir sugeneruoja prieigos raktą.
• Užregistruoja jūsų parduotuvę Conviro sistemoje (parduotuvės URL + raktas), kad srautai galėtų skaityti jūsų duomenis.
• Automatiškai įterpia pokalbių valdiklį kiekviename parduotuvės puslapyje – temos redaguoti nereikia.
• Siunčia įvykių webhook'us (pateiktas užsakymas, pasikeitė užsakymo būsena, išsaugota prekė, užsiregistravo klientas), kad duomenys beveik realiuoju laiku išliktų švieži.
• Saugo pasirašytą webhook slaptąjį raktą, kad gaunami ir siunčiami įvykiai būtų patikrinami.

Tiek – jūsų srautai veikia.

B metodas – Be plėtinio (rankinė sąranka)

Jokio modulio diegti nereikia. Per maždaug 5 minutes padarysite tai, ką plėtinys atlieka automatiškai: sukursite API raktą ir įklijuosite valdiklio kodo fragmentą.

1 žingsnis – Sukurkite Magento integraciją (srautams)

1. Magento administravimo srityje eikite į System -> Extensions -> Integrations.
2. Spustelėkite Add New Integration.
3. Suteikite jai pavadinimą (pvz., „Conviro“) ir įveskite administratoriaus slaptažodį.
4. Atverkite skirtuką API ir suteikite prieigą prie šių išteklių:

• Sales -> Operations -> Orders (užsakymų paieška, būsena, atšaukimas)
• Catalog -> Inventory -> Products (prekių paieška)
• Customers -> Customer (kliento / užsakymo priklausomybės patikra)
• (nebūtina) Sales -> Operations -> Returns, jei naudojate grąžinimų srautą

1. Spustelėkite Save, tada Activate, kad integracija būtų aktyvuota.
2. Nukopijuokite po aktyvavimo parodytą Access Token.

2 žingsnis – Prijunkite ją prie Conviro

1. Eikite į Dashboard -> Settings -> Integrations -> Magento.
2. Įveskite savo parduotuvės URL (pvz., https://your-store.com) ir įklijuokite Access Token.
3. Spustelėkite Connect. Conviro patikrina raktą ir įjungia el. prekybos srautus.

3 žingsnis – Įdėkite pokalbių valdiklį

Kadangi nėra plėtinio, kuris valdiklį įterptų automatiškai, kodo fragmentą įdėkite patys. Įklijuokite jį prieš pat savo temos uždaromąją body žymą arba įkelkite per Google Tag Manager:

<script src="https://cdn.conviro.io/widget/widget.iife.js"></script>
<script>
  cw('init', { publicKey: 'pk_YOUR_PUBLIC_KEY' });
</script>

Magento sistemoje švariausia vieta yra Content -> Design -> Configuration -> [jūsų tema] -> HTML Head / Footer arba Miscellaneous HTML blokas. GTM taip pat tinka ir išlieka po temos atnaujinimų.

Ką suteikia kiekvienas būdas

Apibendrinant: visi klientams skirti srautai veikia abiem režimais. Be plėtinio atsisakote tik sąrankos vienu paspaudimu, automatinio valdiklio įterpimo ir realiojo laiko webhook'ų sinchronizavimo – o visi jie turi paprastų rankinių atitikmenų.

Saugumas: užsakymo priklausomybės patikra

Abu būdai turi tą pačią apsaugą nuo užsakymų numerių spėliojimo. Prieš atskleisdamas bet kokią užsakymo informaciją, srautas paprašo kliento nurodyti užsakyme naudotą el. pašto adresą:

1. Klientas nurodo užsakymo numerį.
2. Robotas paprašo el. pašto adreso, naudoto atsiskaitant.
3. Conviro atskleidžia užsakymo informaciją tik tada, kai el. pašto adresas sutampa su užsakymu.
4. Jei nesutampa, robotas atsako lygiai taip pat, tarsi užsakymas nebūtų rastas – todėl užpuolikas negali suprasti, ar užsakymo numeris tikras.

Tai užtikrinama Conviro vidinėje sistemoje, nepriklausomai nuo plėtinio, per užsakymų srauto el. pašto patikros žingsnį. Parengti el. prekybos srautų šablonai el. pašto adresą surenka dar prieš bet kokią paiešką.

El. prekybos srautai

Naudokite parengtus šablonus, esančius Dashboard -> Flows -> New Flow -> Use Template -> E-Commerce:

• Order Status – patikrinkite būseną, vykdymą ir siuntos sekimą pagal užsakymo numerį + el. pašto adresą.
• Cancel & Refund – patikrinkite priklausomybę, tada atšaukite tinkamą užsakymą.
• Returns & Exchanges – patikrinkite priklausomybę, surinkite priežastį ir pradėkite RMA.
• Product Search – raskite prekes pagal pavadinimą/SKU ir pasidalykite informacija pokalbyje.

Visi jie kreipiasi į savąją Magento REST API naudodami A arba B metodo raktą – jokių papildomų galinių taškų nereikia.

Patarimai

• Jei galite, naudokite plėtinį – jis pašalina kiekvieną rankinį žingsnį ir per webhook'us palaiko duomenų šviežumą.
• Rankinį būdą rinkitės griežtai apribotose parduotuvėse, prekyvietėse arba kai saugumo politika draudžia naujus modulius.
• Integracijai suteikite tik minimalius išteklius, kuriuos iš tiesų naudojate – Returns visada galėsite pridėti vėliau.
• Pradėkite nuo Order Status srauto; jis atsako į el. prekybos klausimą Nr. 1 ir įrodo, kad ryšys veikia.
• Prijungę išbandykite paklausdami roboto apie tikrą užsakymą (su sutampančiu el. pašto adresu) ir tikrą prekę/SKU.