Skip to content

Latest commit

 

History

History
296 lines (193 loc) · 9.25 KB

File metadata and controls

296 lines (193 loc) · 9.25 KB

📘 Manuale d'Uso — Offers Platform

Questo documento spiega come utilizzare la piattaforma per creare, configurare e inviare offerte commerciali ai clienti via Email e WhatsApp.


Indice

  1. Accesso e ruoli
  2. Dashboard
  3. Prodotti
  4. Clienti
  5. Segmenti (Tag)
  6. Offerte
  7. Configurare l'Email
  8. Inviare un'offerta
  9. Integrazione Mailchimp
  10. WhatsApp
  11. Impostazioni

1. Accesso e Ruoli

Accedi con email e password fornite dall'amministratore.

Esistono due tipi di utenti:

Ruolo Permessi
Admin Accesso completo: gestisce utenti, prodotti, tutti i clienti e tutte le offerte
Account Manager Vede solo i propri clienti e le proprie offerte

2. Dashboard

La schermata principale mostra un riepilogo rapido:

  • Numero di offerte attive
  • Ultime offerte create
  • Stato degli invii recenti

Dalla sidebar a sinistra puoi navigare in tutte le sezioni.


3. Prodotti

La sezione Prodotti contiene il catalogo completo dei prodotti disponibili per le offerte.

Ogni prodotto ha:

  • Nome e immagine
  • Codice HAR e codice articolo
  • Dimensioni (diametro vaso, altezza)
  • Prezzo base

⚠️ Nella piattaforma compaiono solo i prodotti con stato approvato. Se un prodotto non appare, contatta l'amministratore.


4. Clienti

In Customers trovi la lista dei tuoi clienti. Per ogni cliente sono disponibili:

  • Nome, email, telefono
  • Lingua e paese
  • Account Manager di riferimento
  • Tag assegnati
  • Percentuale di commissione default

Puoi filtrare i clienti per tag, lingua, paese e account manager usando i menu in cima alla lista.


5. Segmenti (Tag)

I Segmenti ti permettono di raggruppare i clienti per invii mirati.

Creare un segmento

  1. Vai su Segments nella sidebar
  2. Clicca New Tag
  3. Inserisci un nome (es. Cliente VIP Olanda) e scegli un colore identificativo
  4. Clicca Save

Aggiungere clienti a un segmento

  1. Clicca sul nome del segmento per aprirlo
  2. Nella lista clienti, spunta quelli da includere
  3. Clicca Save Customers

Quando crei un'offerta, selezionando un segmento vengono aggiunti automaticamente tutti i clienti del gruppo.


6. Offerte

Creare una nuova offerta

Vai su Offers → Create. Il form è diviso in 4 blocchi:


Blocco 1 — Informazioni generali

Campo Descrizione
Offer Name Nome interno dell'offerta (non visibile ai clienti)
Subject Oggetto dell'email che riceveranno i clienti
Status Draft = bozza; Scheduled = pianificata con data e ora
Scheduled At Data e ora di invio (solo se status = Scheduled)
Recurrence Frequenza di ripetizione: None / Daily / Weekly / Monthly
Channel Canale di invio: Email / WhatsApp / Entrambi
Template HTML Opzionale — HTML personalizzato per override del template

Blocco 2 — Selezione Prodotti

Viene mostrata una griglia con tutti i prodotti approvati.

  • Clicca su un prodotto per selezionarlo (appare il bordo colorato e la spunta ✓)
  • Clicca di nuovo per deselezionarlo
  • Usa la barra di ricerca in cima per trovare un prodotto per nome, codice HAR o codice articolo

Quando un prodotto è selezionato, si espandono due campi:

Campo Descrizione
Commission % Percentuale di commissione da aggiungere al prezzo base
Extra Fee Costo aggiuntivo fisso in €
Final Price Calcolato automaticamente: (prezzo base × (1 + commissione%)) + extra fee

✅ Devi selezionare almeno 1 prodotto per poter salvare l'offerta.


Blocco 3 — Segmenti

Vengono mostrati i segmenti disponibili come bottoni colorati.

  • Clicca un segmento per attivarlo → tutti i suoi clienti vengono aggiunti alla selezione
  • Clicca di nuovo per deselezionarlo → i clienti vengono rimossi
  • Puoi attivare più segmenti insieme

Blocco 4 — Selezione Clienti

Tabella con tutti i clienti, filtrabile per:

  • Tag, Lingua, Paese, Account Manager

Puoi:

  • Spuntare i clienti uno ad uno
  • Usare la checkbox in cima per selezionare/deselezionare tutti i clienti visibili
  • Combinare segmenti + selezione manuale

Il contatore (X selected) si aggiorna in tempo reale.


Salvare l'offerta

Clicca Save Offer in fondo al form. L'offerta viene salvata come bozza o pianificata in base allo status scelto.


7. Configurare l'Email

Dopo aver creato un'offerta, puoi personalizzare l'aspetto dell'email.

Vai su Offers → [nome offerta] → Email Configuration.

Campo Descrizione
Banner URL URL di un'immagine da mostrare in cima all'email
Heading Titolo principale dell'email, con traduzione per lingua
Subtext Testo di supporto sotto il titolo, con traduzione per lingua
Preview Text Testo che appare nell'anteprima email del client di posta
Theme Colore del template: Purple o Green
Show Price Mostra o nasconde i prezzi nell'email
Week Number Numero settimana da visualizzare (opzionale)

Le traduzioni sono disponibili per: 🇳🇱 nl · 🇬🇧 en · 🇮🇹 it · 🇩🇪 de · 🇫🇷 fr · 🇪🇸 es

Anteprima email

Clicca Preview per vedere l'email come la riceverà il cliente. Puoi passare da una lingua all'altra e cambiare tema direttamente dall'anteprima.


8. Inviare un'Offerta

Alla pagina dettaglio dell'offerta trovi il pulsante Send Now.

Prima di inviare il sistema verifica automaticamente:

  • ✅ Almeno 1 prodotto selezionato
  • ✅ Almeno 1 cliente selezionato

Se una delle due condizioni manca, l'invio viene bloccato con un messaggio di errore.

L'invio avviene in background (coda) — non devi aspettare. Puoi monitorare lo stato nella sezione Send Logs nella pagina dell'offerta.


9. Integrazione Mailchimp

La piattaforma è collegata a Mailchimp per costruire e inviare campagne email professionali con il layout grafico di Mailchimp.

Come funziona

Segmento (Tag) → Audience Mailchimp → Campagna bozza → Editor Mailchimp → Invio

Step 1 — Configura Mailchimp (una volta sola)

Vai su Settings e inserisci:

  • API Key — da Mailchimp → Account → Extras → API keys
  • Server Prefix — es. us14 (visibile nell'URL quando sei loggato su Mailchimp)
  • From Name — nome mittente (es. Hamiplant)
  • From Email — indirizzo email mittente

Clicca Test Connection per verificare che tutto funzioni.

Step 2 — Esporta un Segmento come Audience

  1. Vai su Segments, apri il segmento che vuoi usare
  2. Clicca Import to Mailchimp
  3. La piattaforma crea automaticamente una nuova Audience su Mailchimp con lo stesso nome del segmento
  4. Tutti i clienti del segmento vengono aggiunti come contatti

💡 Se esporti lo stesso segmento più volte, l'Audience esistente viene aggiornata — non vengono creati duplicati.

⚠️ I clienti senza indirizzo email vengono saltati.

Step 3 — Crea la Campagna

Dall'offerta, clicca Send via Mailchimp. La piattaforma:

  1. Crea una campagna bozza su Mailchimp collegata all'Audience del segmento
  2. Carica automaticamente l'HTML del template email come contenuto
  3. Ti mostra il link diretto per aprirla su Mailchimp

Step 4 — Rifinisci e Invia da Mailchimp

Apri la bozza su Mailchimp con il link fornito. Da lì puoi:

  • Aggiustare layout, immagini e font con l'editor di Mailchimp
  • Vedere l'anteprima su mobile e desktop
  • Consultare le statistiche dopo l'invio (aperture, click, disiscrizioni)
  • Inviare la campagna

10. WhatsApp

Se il canale dell'offerta è WhatsApp o Both, il messaggio viene inviato anche via WhatsApp ai numeri di telefono dei clienti.

Il sistema usa WAHA (WhatsApp HTTP API). Per attivarlo è necessario che l'amministratore abbia configurato l'integrazione e collegato un numero WhatsApp.

Per inviare via WhatsApp i clienti devono avere il numero di telefono salvato nel profilo.


11. Impostazioni

Accessibili solo dall'Admin. Da qui si configurano:

  • Credenziali Mailchimp (API Key, Server Prefix, From Name, From Email)
  • Credenziali WhatsApp / WAHA
  • Impostazioni generali dell'applicazione

Riepilogo stati di un'offerta

Stato Significato
🟡 Draft Bozza salvata, non ancora inviata. Modificabile liberamente.
🔵 Scheduled Pianificata con data e ora di invio automatico.
🟢 Sent Inviata. Visibile nei Send Logs con dettagli per ogni cliente.

Domande frequenti

Il prodotto non appare nella griglia — perché? Il prodotto non è ancora stato approvato. Contatta l'amministratore.

Ho selezionato i clienti ma dopo il salvataggio non ci sono più. Assicurati di cliccare Save Offer e non semplicemente chiudere la pagina.

Il pulsante Send Now è disabilitato. Serve almeno 1 prodotto e 1 cliente selezionati sull'offerta.

Come vedo se l'email è stata consegnata? Vai sulla pagina dell'offerta e consulta la sezione Send Logs in fondo.

Posso modificare un'offerta già inviata? Sì, ma l'invio non verrà ripetuto automaticamente. Dovrai cliccare Send Now di nuovo.