Magento-integratie

Verbind je Magento 2-winkel (Open Source / Adobe Commerce) met Conviro zodat je chatbot bestellingen kan volgen, annuleringen en retouren kan afhandelen en productvragen direct in de chat kan beantwoorden.

Er zijn twee manieren om te verbinden, en beide ontgrendelen dezelfde flow-mogelijkheden:

1. Met de officiële Conviro-extensie – een geautomatiseerde opzet met één klik. Aanbevolen voor de meeste verkopers.
2. Zonder enige extensie – een handmatige opzet met de native REST-API van Magento plus een kleine widget-snippet. Gebruik dit als je geen modules van derden kunt (of wilt) installeren.

> Belangrijk: de extensie is een gemakslaag, geen vereiste. Bestellingen volgen, annuleren, retourneren en producten zoeken verlopen via de native REST-API van Magento op de Conviro-backend – ze werken dus op beide manieren. De extensie automatiseert alleen de opzet, de widget-injectie en de event-webhooks.

Vereisten

• Pro-abonnement of hoger
• Magento 2.4+ (Open Source / Community of Adobe Commerce)
• Beheerderstoegang tot je Magento-winkel
• Je Conviro API-sleutel (genereer er een via Dashboard -> Settings -> API Keys)

Methode A – Met de officiële extensie (aanbevolen)

De snelste route. Eén veld, één klik en alles is verbonden.

Installatie

1. Installeer de module via 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

(Of upload de extensie-ZIP vanuit het Conviro-dashboard als je geen Composer gebruikt.)

1. Ga in de Magento-admin naar Stores -> Configuration -> Conviro -> AI Chat.
2. Plak je Conviro API-sleutel en klik op Save Config.

Wat er automatisch gebeurt

Wanneer je de API-sleutel opslaat, doet de extensie het volgende:

• Maakt een Magento-integratie met de naam ‘Conviro AI Chat’ met REST-rechten op basis van minimale rechten (Sales orders, Catalog products, Customers, Carts) en genereert een access token.
• Registreert je winkel bij Conviro (winkel-URL + token) zodat flows je gegevens kunnen lezen.
• Injecteert de chatwidget automatisch op elke storefront-pagina – zonder themabewerking.
• Stuurt event-webhooks (bestelling geplaatst, bestelstatus gewijzigd, product opgeslagen, klant geregistreerd) zodat gegevens vrijwel realtime actueel blijven.
• Bewaart een ondertekend webhook-secret zodat inkomende/uitgaande events worden geverifieerd.

Dat is alles – je flows zijn live.

Methode B – Zonder de extensie (handmatige opzet)

Geen module-installatie nodig. In ~5 minuten doe je wat de extensie automatisch doet: een API-token aanmaken en de widget-snippet plakken.

Stap 1 – Een Magento-integratie aanmaken (voor de flows)

1. Ga in de Magento-admin naar System -> Extensions -> Integrations.
2. Klik op Add New Integration.
3. Geef het een naam (bijv. ‘Conviro’) en voer je beheerderswachtwoord in.
4. Open het tabblad API en geef toegang tot deze resources:

• Sales -> Operations -> Orders (bestelling zoeken, status, annuleren)
• Catalog -> Inventory -> Products (producten zoeken)
• Customers -> Customer (controle eigenaarschap klant/bestelling)
• (optioneel) Sales -> Operations -> Returns als je de retourflow gebruikt

1. Klik op Save en daarna op Activate.
2. Kopieer het Access Token dat na activatie wordt getoond.

Stap 2 – Verbinden in Conviro

1. Ga naar Dashboard -> Settings -> Integrations -> Magento.
2. Voer je winkel-URL in (bijv. https://your-store.com) en plak het Access Token.
3. Klik op Connect. Conviro verifieert het token en activeert de e-commerceflows.

Stap 3 – De chatwidget toevoegen

Omdat er geen extensie is die de widget automatisch injecteert, voeg je de snippet zelf toe. Plaats hem vlak voor de afsluitende body-tag van je thema, of laad hem via Google Tag Manager:

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

In Magento is de netste plek Content -> Design -> Configuration -> [je thema] -> HTML Head / Footer, of een Miscellaneous HTML-blok. GTM werkt ook en overleeft thema-updates.

Wat elke methode je biedt

Kort gezegd: alle klantgerichte flows werken in beide modi. Zonder de extensie lever je alleen de opzet met één klik, de automatische widget-injectie en de realtime webhook-synchronisatie in – en daar zijn telkens eenvoudige handmatige alternatieven voor.

Beveiliging: verificatie van besteleigenaarschap

Beide methoden bevatten dezelfde bescherming tegen het raden van bestelnummers. Voordat besteldetails worden getoond, vraagt de flow de klant om het e-mailadres van de bestelling:

1. De klant geeft een bestelnummer op.
2. De bot vraagt om het e-mailadres dat bij de checkout is gebruikt.
3. Conviro toont besteldetails alleen als het e-mailadres overeenkomt met de bestelling.
4. Komt het niet overeen, dan reageert de bot precies alsof de bestelling niet is gevonden – zo kan een aanvaller niet zien of een bestelnummer echt is.

Dit wordt afgedwongen in de Conviro-backend, los van de extensie, via de e-mailverificatiestap van de bestelflow. De vooraf gebouwde e-commerce-flowsjablonen verzamelen het e-mailadres al vóór elke opzoeking.

E-commerceflows

Gebruik de vooraf gebouwde sjablonen onder Dashboard -> Flows -> New Flow -> Use Template -> E-Commerce:

• Order Status – status, verzending en tracking opzoeken op bestelnummer + e-mail.
• Cancel & Refund – eigenaarschap verifiëren en vervolgens een in aanmerking komende bestelling annuleren.
• Returns & Exchanges – eigenaarschap verifiëren, de reden vastleggen en een RMA starten.
• Product Search – producten zoeken op naam/SKU en details in de chat delen.

Dit alles roept de native REST-API van Magento aan met het token uit Methode A of B – geen aangepaste endpoints nodig.

Tips

• Gebruik de extensie als het kan – die haalt elke handmatige stap weg en houdt gegevens actueel via webhooks.
• Gebruik de handmatige modus bij afgeschermde winkels, marktplaatsen, of wanneer een beveiligingsbeleid nieuwe modules verbiedt.
• Geef de integratie alleen de minimale resources die je echt gebruikt – je kunt Returns altijd later toevoegen.
• Begin met de Order Status-flow; die beantwoordt de e-commerce-vraag nummer 1 en bewijst dat de verbinding werkt.
• Test na het verbinden door de bot naar een echte bestelling (met het overeenkomende e-mailadres) en een echt product/SKU te vragen.