Installare Raysly su OpenCart

L'estensione Raysly aggiunge il modulo per l'offerta immediata al negozio OpenCart e può inviare alla pipeline di lead di Raysly i clienti del checkout che hanno dato il consenso. Prodotti, checkout e fatture restano in OpenCart.

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.
• OpenCart 4.0.2.0 o successivo (4.0.x), con PHP 8.0 o successivo e le estensioni curl e openssl.
• Il negozio deve essere servito tramite HTTPS sulla porta predefinita.
• La cartella storage/ deve essere scrivibile da PHP (l'estensione conserva un file segreto casuale in storage/raysly/).

Installazione e collegamento

1. Ottenere il pacchetto dell'estensione. Raysly fornisce il pacchetto come file ZIP. Richiedere la versione corrente al supporto Raysly all'indirizzo support@raysly.com.
2. Caricare il pacchetto. Nell'admin di OpenCart aprire Extensions → Installer, caricare il file .ocmod.zip di Raysly e fare clic su Install.
3. Installare il modulo. Aprire Extensions → Extensions, scegliere Modules, trovare Raysly, fare clic su Install (il segno più verde), poi su Edit (la matita blu). L'installazione crea la tabella raysly_lead e registra gli eventi dell'estensione (vedere Extensions → Events, codici che iniziano con raysly_).
4. Fare clic su Connect to Raysly. Nella pagina delle impostazioni Raysly fare clic su Connect to Raysly, confermare il negozio in Raysly (è possibile accedere o registrarsi lungo il percorso) e si torna alla pagina che mostra Connected to il proprio account Raysly.
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. Aggiungere il modulo a un layout (facoltativo). Per mostrare il modulo in un'altra posizione, aggiungere il modulo Raysly a un layout in Design → Layouts.
7. Scegliere quali clienti del checkout diventano lead (facoltativo). Selezionare Lawful basis, poi Send opted-in checkout customers to my Raysly account as leads. Finché entrambi non sono selezionati non viene inviato nulla.
8. Collegare i prodotti (facoltativo). La scheda Products contiene 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)

Nella pagina delle impostazioni usare l'opzione manuale per incollare il tenant ID, il widget host (Settings → Website widget) e una chiave con l'autorizzazione leads:write (Settings → API keys). Il campo della chiave è in sola scrittura.

Se si rimuove l'estensione

• Aprire prima Extensions → Modules → Raysly e fare clic su Uninstall. Questo revoca la chiave in Raysly e rimuove gli eventi, la tabella, le impostazioni e il file del segreto.
• Poi aprire Extensions → Installer e disinstallare il pacchetto per eliminare i file.
• Una chiave incollata a mano non viene revocata dal negozio: revocarla in Settings → API keys.

Lingue

L'estensione è disponibile in inglese, tedesco, francese, italiano e greco (en-gb, de-de, fr-fr, it-it, el-gr).