Raysly auf Magento installieren

Das Raysly-Modul (Raysly_Connect) fügt Ihrem Magento-2- oder Adobe-Commerce-Shop das Sofortangebot-Formular hinzu und kann Checkout-Kunden, die zugestimmt haben, an Ihre Raysly-Lead-Pipeline senden. Ihre Produkte, der Checkout und die Rechnungen bleiben in Magento.

Dieser Connector befindet sich in der Beta-Phase. Raysly stellt Angebote und Rechnungen weiterhin wie bisher aus; die Rechnungsweitergabe bleibt ausgeschaltet, solange der Connector in der Beta-Phase ist.

Bevor Sie beginnen

• Sie benötigen ein Raysly-Konto. Falls Sie noch keines haben, erstellen Sie zuerst ein Raysly-Konto.
• Magento Open Source oder Adobe Commerce 2.4.x (2.4.4 oder neuer empfohlen) mit PHP 8.1 oder neuer und den PHP-Erweiterungen curl, json und mbstring.
• Ihr Shop muss über HTTPS auf dem Standardport ausgeliefert werden (One-Click-Connect benötigt das; der Weg über den manuellen Schlüssel nicht).
• Der Webserver muss Raysly über HTTPS erreichen können, und Sie benötigen Kommandozeilenzugriff, um bin/magento auszuführen.

Installieren und verbinden

1. Modulpaket besorgen. Raysly stellt das Paket als ZIP-Datei bereit. Fordern Sie die aktuelle Version beim Raysly-Support an: support@raysly.com.
2. Moduldateien installieren. Binden Sie das Paket entweder mit Composer ein (solange es nicht veröffentlicht ist, stellen Sie die ZIP-Datei über ein Composer-"artifact"-Repository bereit: composer config repositories.raysly artifact /path/to/artifacts, dann composer require raysly/module-connect:0.1.0) oder entpacken Sie es nach app/code/Raysly/Connect.
3. Modul aktivieren. Führen Sie bin/magento module:enable Raysly_Connect aus, dann bin/magento setup:upgrade, im Production-Modus anschließend bin/magento setup:di:compile und bin/magento setup:static-content:deploy -f und zuletzt bin/magento cache:flush. Im Developer-Modus genügen module:enable, setup:upgrade und cache:flush.
4. Auf Connect to Raysly klicken. Öffnen Sie im Admin Raysly → Raysly settings (oder Stores → Configuration → Raysly) und klicken Sie auf Connect to Raysly. Melden Sie sich in Raysly an oder registrieren Sie sich und bestätigen Sie diesen Shop. Sie werden zurück zum Shop geleitet, der den Handshake abschließt und Sie dann zum Admin weiterleitet. Öffnen Sie Raysly settings erneut, um den Status zu sehen.
5. Ihren Shop zur Widget-Liste hinzufügen. Fügen Sie in Raysly die Adresse des Shops zur Liste unter Settings → Website widget hinzu, damit das Formular dort geladen werden darf.
6. Festlegen, welche Checkout-Kunden zu Leads werden (optional). Setzen Sie unter Lead bridge Send leads to Raysly auf Yes und I confirm a lawful basis for sharing auf Yes. Solange nicht beides gesetzt ist, wird nichts gesendet.
7. Ihre Produkte verknüpfen (optional). Klicken Sie im Abschnitt Product sync auf Sync my products to Raysly. Was genau dabei geteilt wird, steht im Benutzerleitfaden.

Was die Verbindung kann und was nicht

Beim Verbinden erstellt Raysly für diesen Shop einen API-Schlüssel, der nur Leads anlegen kann (Berechtigung leads:write), und übermittelt ihn sicher an das Plugin oder Modul. Der Schlüssel kann Ihre Produkte, Preise, Bestellungen, Kunden oder Einstellungen weder lesen noch ändern. Kein Schlüssel wird in einer URL übertragen, und Sie kopieren oder fügen nie einen Schlüssel ein. Wenn Sie im Shop die Verbindung trennen, wird der Schlüssel in Raysly widerrufen.

Manuell verbinden (fortgeschritten)

Fügen Sie unter Connect manually (advanced) die Tenant-ID, den Schlüssel mit der Berechtigung leads:write (Settings → API keys) und den Widget-Host (Settings → Website widget) ein.

Wenn Sie das Modul entfernen

• Disconnect widerruft den Schlüssel in Raysly und löscht ihn aus dem Shop, unabhängig davon, was Raysly antwortet.
• bin/magento module:uninstall --remove-data Raysly_Connect bewirkt dasselbe.
• Ein von Hand eingefügter Schlüssel wird vom Shop aus nicht widerrufen: Widerrufen Sie ihn unter Settings → API keys.

Sprachen

Das Modul spricht Englisch, Deutsch, Französisch, Italienisch und Griechisch.