Magento-Integration

Verbinden Sie Ihren Magento 2-Shop (Open Source / Adobe Commerce) mit Conviro, damit Ihr Chatbot Bestellungen verfolgen, Stornierungen und Rücksendungen abwickeln und Produktfragen direkt im Chat beantworten kann.

Es gibt zwei Wege zur Verbindung, und beide schalten dieselben Flow-Funktionen frei:

1. Mit der offiziellen Conviro-Erweiterung – eine automatisierte Ein-Klick-Einrichtung. Für die meisten Händler empfohlen.
2. Ganz ohne Erweiterung – eine manuelle Einrichtung über die native REST-API von Magento plus ein kleines Widget-Snippet. Verwenden Sie dies, wenn Sie keine Module von Drittanbietern installieren können (oder möchten).

> Wichtig: Die Erweiterung ist eine Komfort-Schicht, keine Voraussetzung. Bestellverfolgung, Stornierung, Rücksendungen und Produktsuche laufen auf dem Conviro-Backend über die native REST-API von Magento – sie funktionieren also in beiden Fällen. Die Erweiterung automatisiert lediglich die Einrichtung, die Widget-Einbindung und die Event-Webhooks.

Voraussetzungen

• Pro-Tarif oder höher
• Magento 2.4+ (Open Source / Community oder Adobe Commerce)
• Administratorzugriff auf Ihren Magento-Shop
• Ihr Conviro-API-Schlüssel (erstellen Sie einen unter Dashboard -> Settings -> API Keys)

Methode A – Mit der offiziellen Erweiterung (empfohlen)

Der schnellste Weg. Ein Feld, ein Klick, und alles ist verbunden.

Installation

1. Installieren Sie das Modul über 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

(Oder laden Sie das Erweiterungs-ZIP aus dem Conviro-Dashboard hoch, falls Sie Composer nicht verwenden.)

1. Gehen Sie im Magento-Admin zu Stores -> Configuration -> Conviro -> AI Chat.
2. Fügen Sie Ihren Conviro-API-Schlüssel ein und klicken Sie auf Save Config.

Was automatisch passiert

Wenn Sie den API-Schlüssel speichern, führt die Erweiterung Folgendes aus:

• Erstellt eine Magento-Integration namens „Conviro AI Chat“ mit minimalen REST-Berechtigungen (Sales orders, Catalog products, Customers, Carts) und erzeugt ein Zugriffstoken.
• Registriert Ihren Shop bei Conviro (Shop-URL + Token), damit Flows Ihre Daten lesen können.
• Bindet das Chat-Widget automatisch auf jeder Storefront-Seite ein – ohne Theme-Bearbeitung.
• Sendet Event-Webhooks (Bestellung aufgegeben, Bestellstatus geändert, Produkt gespeichert, Kunde registriert), damit die Daten nahezu in Echtzeit aktuell bleiben.
• Speichert ein signiertes Webhook-Secret, damit ein- und ausgehende Events verifiziert werden.

Das war's – Ihre Flows sind live.

Methode B – Ohne Erweiterung (manuelle Einrichtung)

Keine Modulinstallation nötig. In etwa 5 Minuten erledigen Sie das, was die Erweiterung automatisch tut: ein API-Token erstellen und das Widget-Snippet einfügen.

Schritt 1 – Magento-Integration erstellen (für die Flows)

1. Gehen Sie im Magento-Admin zu System -> Extensions -> Integrations.
2. Klicken Sie auf Add New Integration.
3. Geben Sie ihr einen Namen (z. B. „Conviro“) und Ihr Administratorkennwort ein.
4. Öffnen Sie den Tab API und gewähren Sie Zugriff auf diese Ressourcen:

• Sales -> Operations -> Orders (Bestellsuche, Status, Stornierung)
• Catalog -> Inventory -> Products (Produktsuche)
• Customers -> Customer (Kunden-/Bestellinhaberprüfung)
• (optional) Sales -> Operations -> Returns, falls Sie den Rücksende-Flow nutzen

1. Klicken Sie auf Save und dann auf Activate.
2. Kopieren Sie das nach der Aktivierung angezeigte Access Token.

Schritt 2 – In Conviro verbinden

1. Gehen Sie zu Dashboard -> Settings -> Integrations -> Magento.
2. Geben Sie Ihre Shop-URL (z. B. https://your-store.com) und das Access Token ein.
3. Klicken Sie auf Connect. Conviro verifiziert das Token und aktiviert die E-Commerce-Flows.

Schritt 3 – Chat-Widget hinzufügen

Da keine Erweiterung das Widget automatisch einbindet, fügen Sie das Snippet selbst hinzu. Platzieren Sie es direkt vor dem schließenden Body-Tag Ihres Themes oder laden Sie es über den 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 ist der sauberste Ort Content -> Design -> Configuration -> [Ihr Theme] -> HTML Head / Footer oder ein Miscellaneous-HTML-Block. GTM funktioniert ebenfalls und übersteht Theme-Updates.

Was jede Methode bietet

Fazit: Alle kundenseitigen Flows funktionieren in beiden Modi. Ohne die Erweiterung verzichten Sie lediglich auf die Ein-Klick-Einrichtung, die automatische Widget-Einbindung und die Echtzeit-Webhook-Synchronisierung – für all das gibt es einfache manuelle Alternativen.

Sicherheit: Prüfung des Bestellinhabers

Beide Methoden enthalten denselben Schutz gegen das Erraten von Bestellnummern. Bevor Bestelldetails angezeigt werden, fragt der Flow den Kunden nach der E-Mail-Adresse der Bestellung:

1. Der Kunde gibt eine Bestellnummer an.
2. Der Bot fragt nach der beim Checkout verwendeten E-Mail-Adresse.
3. Conviro zeigt Bestelldetails nur an, wenn die E-Mail-Adresse mit der Bestellung übereinstimmt.
4. Stimmt sie nicht überein, antwortet der Bot genau so, als wäre die Bestellung nicht gefunden worden – so kann ein Angreifer nicht erkennen, ob eine Bestellnummer echt ist.

Dies wird im Conviro-Backend durchgesetzt, unabhängig von der Erweiterung, über den E-Mail-Verifizierungsschritt des Bestell-Flows. Die vorgefertigten E-Commerce-Flow-Vorlagen erfassen die E-Mail-Adresse bereits vor jeder Abfrage.

E-Commerce-Flows

Verwenden Sie die vorgefertigten Vorlagen unter Dashboard -> Flows -> New Flow -> Use Template -> E-Commerce:

• Order Status – Status, Versand und Tracking anhand von Bestellnummer + E-Mail abrufen.
• Cancel & Refund – Inhaberschaft prüfen und dann eine berechtigte Bestellung stornieren.
• Returns & Exchanges – Inhaberschaft prüfen, den Grund erfassen und eine RMA starten.
• Product Search – Produkte nach Name/SKU finden und Details im Chat teilen.

All dies ruft die native REST-API von Magento mit dem Token aus Methode A oder B auf – keine benutzerdefinierten Endpunkte erforderlich.

Tipps

• Verwenden Sie nach Möglichkeit die Erweiterung – sie entfernt jeden manuellen Schritt und hält Daten über Webhooks aktuell.
• Verwenden Sie den manuellen Modus bei abgesicherten Shops, Marktplätzen oder wenn eine Sicherheitsrichtlinie neue Module verbietet.
• Gewähren Sie der Integration nur die minimal benötigten Ressourcen – Returns können Sie jederzeit später hinzufügen.
• Beginnen Sie mit dem Order Status-Flow; er beantwortet die häufigste E-Commerce-Frage und bestätigt, dass die Verbindung funktioniert.
• Testen Sie nach der Verbindung, indem Sie den Bot nach einer echten Bestellung (mit passender E-Mail) und einem echten Produkt/SKU fragen.