Installer Raysly sur Magento

Le module Raysly (Raysly_Connect) ajoute le formulaire d'offre instantanée à votre boutique Magento 2 ou Adobe Commerce et peut envoyer à votre pipeline de leads Raysly les clients du paiement qui y ont consenti. Vos produits, votre paiement et vos factures restent dans Magento.

Ce connecteur est en version bêta. Raysly continue d'émettre les offres et les factures comme aujourd'hui ; la transmission de la facturation reste désactivée tant que le connecteur est en bêta.

Avant de commencer

• Vous avez besoin d'un compte Raysly. Si vous n'en avez pas encore, créez d'abord un compte Raysly.
• Magento Open Source ou Adobe Commerce 2.4.x (2.4.4 ou plus récent recommandé) sur PHP 8.1 ou plus récent, avec les extensions PHP curl, json et mbstring.
• Votre boutique doit être servie en HTTPS sur le port par défaut (la connexion en un clic l'exige ; la voie par clé manuelle non).
• Le serveur web doit pouvoir joindre Raysly en HTTPS, et vous avez besoin d'un accès en ligne de commande pour exécuter bin/magento.

Installer et connecter

1. Obtenir le paquet du module. Raysly fournit le paquet sous forme de fichier ZIP. Demandez la version actuelle au support Raysly : support@raysly.com.
2. Installer les fichiers du module. Soit vous installez le paquet avec Composer (tant qu'il n'est pas publié, servez le ZIP depuis un dépôt Composer "artifact" : composer config repositories.raysly artifact /path/to/artifacts, puis composer require raysly/module-connect:0.1.0), soit vous le décompressez dans app/code/Raysly/Connect.
3. Activer le module. Exécutez bin/magento module:enable Raysly_Connect, puis bin/magento setup:upgrade, puis en mode production bin/magento setup:di:compile et bin/magento setup:static-content:deploy -f, et enfin bin/magento cache:flush. En mode développeur, seuls module:enable, setup:upgrade et cache:flush sont nécessaires.
4. Cliquer sur Connect to Raysly. Dans l'administration, ouvrez Raysly → Raysly settings (ou Stores → Configuration → Raysly) et cliquez sur Connect to Raysly. Connectez-vous ou inscrivez-vous dans Raysly et confirmez cette boutique. Vous êtes renvoyé vers la boutique, qui termine l'échange puis vous redirige vers l'administration. Ouvrez de nouveau Raysly settings pour voir l'état.
5. Ajouter votre boutique à la liste du widget. Dans Raysly, ajoutez l'adresse de la boutique à la liste sous Settings → Website widget, afin que le formulaire puisse s'y charger.
6. Choisir quels clients du paiement deviennent des leads (facultatif). Sous Lead bridge, réglez Send leads to Raysly sur Yes et I confirm a lawful basis for sharing sur Yes. Tant que les deux ne sont pas réglés, rien n'est envoyé.
7. Lier vos produits (facultatif). Dans la section Product sync, cliquez sur Sync my products to Raysly. Consultez le guide d'utilisation pour savoir exactement ce qui est partagé.

Ce que la connexion peut et ne peut pas faire

Lorsque vous vous connectez, Raysly crée pour cette boutique une clé d'API qui peut uniquement créer des leads (autorisation leads:write) et l'envoie de façon sécurisée au plugin ou au module. La clé ne peut ni lire ni modifier vos produits, prix, commandes, clients ou paramètres. Aucune clé ne circule dans une URL, et vous ne copiez ni ne collez jamais de clé. La déconnexion dans la boutique révoque la clé dans Raysly.

Connexion manuelle (avancé)

Sous Connect manually (advanced), collez le tenant ID, la clé avec l'autorisation leads:write (Settings → API keys) et l'hôte du widget (Settings → Website widget).

Si vous supprimez le module

• Disconnect révoque la clé dans Raysly et la supprime de la boutique, quelle que soit la réponse de Raysly.
• bin/magento module:uninstall --remove-data Raysly_Connect fait de même.
• Une clé que vous avez collée à la main n'est pas révoquée depuis la boutique : révoquez-la sous Settings → API keys.

Langues

Le module est disponible en anglais, allemand, français, italien et grec.