Magento integratsioon

Ühenda oma Magento 2 (Open Source / Adobe Commerce) pood Conviroga, et vestlusrobot saaks jälgida tellimusi, menetleda tühistamisi ja tagastusi ning vastata tootepäringutele otse vestluses.

Ühendamiseks on kaks viisi ja mõlemad avavad samad voogude võimalused:

1. Ametliku Conviro laiendusega – ühe klõpsuga automaatne seadistus. Soovitatav enamikule kauplejatele.
2. Ilma laienduseta – käsitsi seadistus, mis kasutab Magento natiivset REST API-t ja väikest vidina koodijuppi. Kasuta seda, kui sa ei saa (või ei taha) kolmandate osapoolte mooduleid paigaldada.

> Oluline: laiendus on mugavuskiht, mitte nõue. Tellimuste jälgimine, tühistamine, tagastused ja toodete otsing käivad kõik Conviro taustasüsteemis Magento natiivse REST API kaudu – seega töötavad need mõlemal juhul. Laiendus lihtsalt automatiseerib seadistuse, vidina lisamise ja sündmuste webhookid.

Nõuded

• Pro pakett või kõrgem
• Magento 2.4+ (Open Source / Community või Adobe Commerce)
• Administraatori ligipääs sinu Magento poele
• Sinu Conviro API võti (loo see siin: Dashboard -> Settings -> API Keys)

Meetod A – Ametliku laiendusega (soovitatav)

Kiireim tee. Üks väli, üks klõps ja kõik on sinu eest ära ühendatud.

Paigaldamine

1. Paigalda moodul Composeri abil:

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

(Või laadi Conviro juhtpaneelilt üles laienduse ZIP-fail, kui sa Composerit ei kasuta.)

1. Ava Magento administraatoriliideses Stores -> Configuration -> Conviro -> AI Chat.
2. Kleebi oma Conviro API võti ja klõpsa Save Config.

Mis toimub automaatselt

Kui salvestad API võtme, siis laiendus:

• Loob Magento integratsiooni nimega „Conviro AI Chat“ minimaalsete õigustega REST-lubadega (Sales orders, Catalog products, Customers, Carts) ja genereerib juurdepääsutokeni.
• Registreerib sinu poe Conviros (poe URL + token), et vood saaksid sinu andmeid lugeda.
• Lisab vestlusvidina automaatselt igale poe lehele – teemat ei pea muutma.
• Saadab sündmuste webhookid (tellimus esitatud, tellimuse staatus muutunud, toode salvestatud, klient registreerunud), et andmed püsiksid peaaegu reaalajas värsked.
• Salvestab allkirjastatud webhooki salavõtme, et sissetulevaid ja väljaminevaid sündmusi verifitseeritaks.

Ongi kõik – sinu vood on aktiivsed.

Meetod B – Ilma laienduseta (käsitsi seadistus)

Ühtegi moodulit ei ole vaja paigaldada. Umbes 5 minutiga teed ära selle, mida laiendus teeb automaatselt: lood API tokeni ja kleebid vidina koodijupi.

Samm 1 – Loo Magento integratsioon (voogude jaoks)

1. Ava Magento administraatoriliideses System -> Extensions -> Integrations.
2. Klõpsa Add New Integration.
3. Anna sellele nimi (nt „Conviro“) ja sisesta oma administraatori parool.
4. Ava vahekaart API ja anna juurdepääs nendele ressurssidele:

• Sales -> Operations -> Orders (tellimuse otsing, staatus, tühistamine)
• Catalog -> Inventory -> Products (toodete otsing)
• Customers -> Customer (kliendi/tellimuse omandi kontroll)
• (valikuline) Sales -> Operations -> Returns, kui kasutad tagastusvoogu

1. Klõpsa Save ja seejärel aktiveeri integratsioon nupuga Activate.
2. Kopeeri pärast aktiveerimist kuvatav Access Token.

Samm 2 – Ühenda see Conviros

1. Ava Dashboard -> Settings -> Integrations -> Magento.
2. Sisesta oma poe URL (nt https://your-store.com) ja kleebi Access Token.
3. Klõpsa Connect. Conviro kontrollib tokeni üle ja lülitab e-kaubanduse vood sisse.

Samm 3 – Lisa vestlusvidin

Kuna vidinat automaatselt lisavat laiendust ei ole, lisa koodijupp ise. Kleebi see oma teema sulgeva body-sildi ette või laadi see Google Tag Manageri kaudu:

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

Magentos on kõige puhtam koht Content -> Design -> Configuration -> [sinu teema] -> HTML Head / Footer või Miscellaneous HTML plokk. Ka GTM töötab ja püsib üle teema uuenduste.

Mida kumbki meetod annab

Kokkuvõttes: kõik kliendini jõudvad vood töötavad mõlemas režiimis. Ilma laienduseta loobud ainult ühe klõpsuga seadistusest, vidina automaatsest lisamisest ja reaalajas webhookide sünkroonimisest – ning kõigil neil on lihtne käsitsi tehtav vaste.

Turvalisus: tellimuse omandi kontroll

Mõlemad meetodid sisaldavad sama kaitset tellimusnumbrite äraarvamise vastu. Enne tellimuse üksikasjade avaldamist küsib voog kliendilt tellimusega seotud e-posti aadressi:

1. Klient annab tellimuse numbri.
2. Robot küsib ostu vormistamisel kasutatud e-posti aadressi.
3. Conviro avaldab tellimuse üksikasjad ainult siis, kui e-posti aadress ühtib tellimusega.
4. Kui see ei ühti, vastab robot täpselt nii, nagu tellimust ei leitudki – nii ei saa ründaja aru, kas tellimuse number on päris.

Seda jõustatakse Conviro taustasüsteemis, laiendusest sõltumatult, tellimusvoo e-posti kontrolli sammu kaudu. Valmis e-kaubanduse voomallid koguvad e-posti aadressi juba enne mis tahes otsingut.

E-kaubanduse vood

Kasuta valmis malle asukohas Dashboard -> Flows -> New Flow -> Use Template -> E-Commerce:

• Order Status – vaata staatust, täitmist ja jälgimisinfot tellimuse numbri + e-posti aadressi järgi.
• Cancel & Refund – kontrolli omandit ja seejärel tühista sobiv tellimus.
• Returns & Exchanges – kontrolli omandit, kogu põhjus ja alusta RMA-d.
• Product Search – leia tooteid nime/SKU järgi ja jaga üksikasju vestluses.

Kõik need pöörduvad Magento natiivse REST API poole Meetodi A või Meetodi B tokeniga – kohandatud lõpp-punkte pole vaja.

Näpunäited

• Kasuta laiendust, kui saad – see kaotab iga käsitsi tehtava sammu ja hoiab andmed webhookide abil värsked.
• Kasuta käsitsi režiimi rangelt piiratud poodides, turuplatsidel või siis, kui turvapoliitika keelab uued moodulid.
• Anna integratsioonile ainult minimaalsed ressursid, mida sa tegelikult kasutad – Returns saab alati hiljem lisada.
• Alusta Order Status vooga; see katab e-kaubanduse küsimuse nr 1 ja tõestab, et ühendus töötab.
• Pärast ühendamist testi, küsides robotilt päris tellimuse (sobiva e-posti aadressiga) ja päris toote/SKU kohta.