Installare Raysly su Magento

Il modulo Raysly (Raysly_Connect) aggiunge il modulo per l'offerta immediata al negozio Magento 2 o Adobe Commerce e può inviare alla pipeline di lead di Raysly i clienti del checkout che hanno dato il consenso. Prodotti, checkout e fatture restano in Magento.

Questo connettore è in beta. Raysly continua a emettere offerte e fatture come oggi; l'inoltro della fatturazione resta disattivato finché il connettore è in beta.

Prima di iniziare

• È necessario un account Raysly. Se non ne ha ancora uno, crei prima un account Raysly.
• Magento Open Source o Adobe Commerce 2.4.x (consigliata la 2.4.4 o successiva) con PHP 8.1 o successivo, con le estensioni PHP curl, json e mbstring.
• Il negozio deve essere servito tramite HTTPS sulla porta predefinita (il collegamento in un clic lo richiede; il collegamento manuale con chiave no).
• Il server web deve poter raggiungere Raysly tramite HTTPS ed è necessario l'accesso da riga di comando per eseguire bin/magento.

Installazione e collegamento

1. Ottenere il pacchetto del modulo. Raysly fornisce il pacchetto come file ZIP. Richiedere la versione corrente al supporto Raysly all'indirizzo support@raysly.com.
2. Installare i file del modulo. Richiedere il pacchetto con Composer (finché non è pubblicato, servire il file ZIP da un repository Composer "artifact": composer config repositories.raysly artifact /path/to/artifacts, poi composer require raysly/module-connect:0.1.0), oppure decomprimerlo in app/code/Raysly/Connect.
3. Abilitare il modulo. Eseguire bin/magento module:enable Raysly_Connect, poi bin/magento setup:upgrade, poi in modalità production bin/magento setup:di:compile e bin/magento setup:static-content:deploy -f, e infine bin/magento cache:flush. In modalità developer bastano module:enable, setup:upgrade e cache:flush.
4. Fare clic su Connect to Raysly. Nell'admin aprire Raysly → Raysly settings (oppure Stores → Configuration → Raysly) e fare clic su Connect to Raysly. Accedere o registrarsi in Raysly e confermare questo negozio. Si viene riportati al negozio, che completa l'handshake e poi reindirizza all'admin. Aprire di nuovo Raysly settings per vedere lo stato.
5. Aggiungere il negozio all'elenco del widget. In Raysly aggiungere l'indirizzo del negozio all'elenco in Settings → Website widget, così che il modulo possa caricarsi lì.
6. Scegliere quali clienti del checkout diventano lead (facoltativo). In Lead bridge impostare Send leads to Raysly su Yes e I confirm a lawful basis for sharing su Yes. Finché entrambi non sono impostati non viene inviato nulla.
7. Collegare i prodotti (facoltativo). Nella sezione Product sync fare clic su Sync my products to Raysly. Cosa viene condiviso esattamente è descritto nella guida all'uso.

Cosa può e non può fare il collegamento

Al momento del collegamento Raysly crea per questo negozio una chiave API che può solo creare lead (autorizzazione leads:write) e la invia in modo sicuro al plugin o al modulo. La chiave non può leggere né modificare prodotti, prezzi, ordini, clienti o impostazioni. Nessuna chiave transita in un URL e non è mai necessario copiarne o incollarne una. Scollegare nel negozio revoca la chiave in Raysly.

Collegamento manuale (avanzato)

In Connect manually (advanced) incollare il tenant ID, la chiave con l'autorizzazione leads:write (Settings → API keys) e il widget host (Settings → Website widget).

Se si rimuove il modulo

• Disconnect revoca la chiave in Raysly e la elimina dal negozio, qualunque sia la risposta di Raysly.
• bin/magento module:uninstall --remove-data Raysly_Connect fa lo stesso.
• Una chiave incollata a mano non viene revocata dal negozio: revocarla in Settings → API keys.

Lingue

Il modulo è disponibile in inglese, tedesco, francese, italiano e greco.