Installer Raysly sur OpenCart

L'extension Raysly ajoute le formulaire d'offre instantanée à votre boutique OpenCart 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 OpenCart.

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.
• OpenCart 4.0.2.0 ou ultérieur (4.0.x), avec PHP 8.0 ou plus récent et les extensions curl et openssl.
• Votre boutique doit être servie en HTTPS sur le port par défaut.
• Le dossier storage/ doit être accessible en écriture par PHP (l'extension y conserve un fichier secret aléatoire dans storage/raysly/).

Installer et connecter

1. Obtenir le paquet de l'extension. Raysly fournit le paquet sous forme de fichier ZIP. Demandez la version actuelle au support Raysly : support@raysly.com.
2. Téléverser le paquet. Dans l'administration OpenCart, ouvrez Extensions → Installer, téléversez le fichier Raysly .ocmod.zip et cliquez sur Install.
3. Installer le module. Ouvrez Extensions → Extensions, choisissez Modules, repérez Raysly, cliquez sur Install (le plus vert), puis sur Edit (le crayon bleu). L'installation crée la table raysly_lead et enregistre les événements de l'extension (voir Extensions → Events, codes commençant par raysly_).
4. Cliquer sur Connect to Raysly. Sur la page de paramètres Raysly, cliquez sur Connect to Raysly, confirmez la boutique dans Raysly (vous pouvez vous connecter ou vous inscrire en chemin) et vous revenez sur la page qui affiche Connected to votre compte Raysly.
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. Ajouter le module à une mise en page (facultatif). Pour afficher le formulaire à un autre emplacement, ajoutez le module Raysly à une mise en page sous Design → Layouts.
7. Choisir quels clients du paiement deviennent des leads (facultatif). Cochez Lawful basis, puis Send opted-in checkout customers to my Raysly account as leads. Tant que les deux ne sont pas cochées, rien n'est envoyé.
8. Lier vos produits (facultatif). La carte Products contient 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é)

Sur la page de paramètres, utilisez l'option manuelle pour coller le tenant ID, l'hôte du widget (Settings → Website widget) et une clé avec l'autorisation leads:write (Settings → API keys). Le champ de la clé est en écriture seule.

Si vous supprimez l'extension

• Ouvrez d'abord Extensions → Modules → Raysly et cliquez sur Uninstall. Cela révoque la clé dans Raysly et supprime les événements, la table, les paramètres et le fichier secret.
• Ouvrez ensuite Extensions → Installer et désinstallez le paquet pour supprimer les fichiers.
• 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

L'extension est disponible en anglais, allemand, français, italien et grec (en-gb, de-de, fr-fr, it-it, el-gr).