Installazione del modulo

Scarica il file ZIP del modulo SendApp WhatsApp Notifications dalla
pagina ufficiale o dal PrestaShop Addons Marketplace. Accedi alla tua
amministrazione PrestaShop e vai su Moduli → Module Manager → Carica
un modulo. Trascina lo ZIP nella zona di upload, attendi il caricamento
e clicca Installa. Al termine vedrai il modulo nell’elenco: clicca
Configura per accedere al pannello di setup.

Durante l’installazione il modulo crea automaticamente le tabelle del
database necessarie (coda messaggi, storico invii, subscribers, coda
product-view) e due stati ordine personalizzati per il flusso di
conferma cliente.

Scelta della piattaforma SendApp

Una novità della versione 2.0 è la possibilità di scegliere il backend
SendApp con cui il modulo comunicherà. Nel pannello Setup trovi il
radio button “SendApp platform” con due opzioni:

– SendApp Official (Cloud, singolo bearer token) – per chi ha un
account su official.sendapp.cloud e una numerazione WhatsApp
Business approvata da Meta. Autenticazione tramite singolo token.

– SendApp Agent (app.sendapp.ai, API key + token) – per chi usa la
piattaforma SendApp Agent. Autenticazione tramite la coppia API
key + token che si trovano nella sezione Developer Tools.

Il modulo memorizza la scelta e instrada automaticamente ogni chiamata
API (fetch template, sync, invio messaggio singolo, broadcast) verso
l’endpoint corretto della piattaforma selezionata.

Generazione delle credenziali

Accanto a ciascuna opzione del radio “SendApp platform” trovi un link
diretto alla pagina di generazione del token sulla piattaforma scelta:

– Se hai selezionato SendApp Official clicca su “Genera token”. Si
apre in nuova tab la pagina https://official.sendapp.cloud/developer-tools/access-tokens.
Accedi al tuo account, clicca Generate API key, copia il token con
l’icona della clipboard e incollalo nel campo “SendApp Official
Access Token” del modulo.

– Se hai selezionato SendApp Agent clicca su “Genera API key + token”.
Si apre in nuova tab la pagina https://app.sendapp.ai/api dove
troverai sia la API key che il token. Copiali e incollali nei due
rispettivi campi del modulo.

Compila anche il campo “Admin’s mobile phone” con il numero (o i
numeri separati da virgola) su cui vuoi ricevere le notifiche di
amministrazione. Salva: il modulo verifica subito le credenziali e
mostra un badge verde “Connected” con il numero di template approvati
caricati dal cloud.

Configurazione dei messaggi di notifica

Nel pannello “Templates e notifiche WhatsApp” trovi un’entry per
ciascun evento del negozio: nuovo ordine, nuovo cliente, prodotto
esaurito, carrello abbandonato, compleanno, cambio stato ordine, ecc.
Per ognuno puoi:

– Selezionare un template approvato da Meta dal menu a tendina.
– Mappare le variabili dinamiche del template (es. {{1}} = nome
cliente, {{2}} = totale ordine) ai placeholder PrestaShop
disponibili per quell’evento.
– Allegare un media URL se il template ha un header IMAGE/VIDEO/DOCUMENT.
– Indicare un testo libero di fallback usato solo se il template non
è disponibile (richiede sessione 24h aperta con il cliente).

Mentre clicchi sui campi, a destra compare un’anteprima live in stile
smartphone con sostituzione delle variabili in tempo reale: le
variabili compilate sono evidenziate in verde, quelle ancora vuote in
giallo. Se non hai ancora creato i template su Meta, clicca il
bottone “Crea nuovo template su SendApp Cloud” in fondo al pannello:
si apre la dashboard SendApp nella sezione template, dove puoi
crearli e attendere l’approvazione.

Scheduled Jobs (CRON)

Nel pannello “Scheduled Jobs (CRON)” puoi configurare le automazioni
temporali del modulo:

– Carrelli abbandonati: il modulo invia un messaggio WhatsApp ai
clienti che hanno lasciato prodotti nel carrello tra il tempo
minimo e il tempo massimo configurati (default 3 min – 5 ore).
– Auguri di compleanno: una volta al giorno il CRON invia gli auguri
a tutti i clienti che compiono gli anni con un eventuale codice
sconto inserito nel template.
– Product view: il modulo memorizza i prodotti visualizzati dai
clienti loggati e, dopo un cooldown configurabile, invia un
reminder WhatsApp con il link al prodotto e un eventuale incentivo.
– Coda messaggi ritardati: se attivi “Delayed sending” i messaggi
vengono accodati e processati a batch dal CRON sendNext.

Il pannello mostra gli URL CRON pronti all’uso, pre-popolati con il
secret token generato all’installazione. Basta aggiungerli al crontab
del server con la frequenza desiderata (esempio: ogni 6 ore per i
carrelli abbandonati, una volta al giorno per il compleanno).

Widget Click-to-Chat

Il modulo include un widget di chat fluttuante per il front-office
del tuo negozio, configurabile dal pannello “Click-to-Chat widget”:

– Posizione: bottom-right o bottom-left
– Logo aziendale: usa automaticamente il logo PrestaShop oppure
imposta un URL custom
– Titolo e sottotitolo del popup
– Lista operatori: una textarea pipe-delimited dove inserisci nome,
ruolo, telefono, avatar, stato online e messaggio precompilato
per ognuno

Quando il visitatore clicca il FAB verde con icona WhatsApp si apre
un popup con header brandizzato e card di ogni operatore (avatar
circolare, nome, ruolo, badge stato “Sono online” o “Torno presto”).
Click su un operatore apre WhatsApp web/app con il messaggio
precompilato. Il widget ha animazione pulse per attirare l’attenzione,
si chiude con tasto ESC o click esterno, è responsive ed accessibile.

Card “Invia messaggio WhatsApp al cliente”

Aprendo qualsiasi ordine in admin trovi una nuova card di invio
WhatsApp con due modalità:

– Template approvato: scegli un template, vedi l’anteprima live e
riempi le variabili cliccando le chip suggerite con i dati
dell’ordine (nome cliente, ID ordine, totale, corriere, prodotti).
– Testo libero: scrivi un messaggio diretto, valido solo se il
cliente ha interagito nelle ultime 24h (limite Meta).

Il numero del destinatario è precompilato dal campo phone_mobile del
cliente. Una validazione client+server impedisce invii silenziosi: se
manca template o body compare un banner rosso con il motivo specifico,
altrimenti un banner verde di conferma “Messaggio inoltrato”.

Anteprima dal vivo

A destra del pannello di configurazione c’è un mockup di smartphone
con header WhatsApp che mostra in tempo reale come appariranno i
messaggi sul telefono del cliente. Cliccando qualsiasi campo template
nei pannelli (settings, templates, single send, bulk send) la bolla
del messaggio si aggiorna istantaneamente con sostituzione delle
variabili e dei media header. Se selezioni un template con header
IMAGE viene mostrata l’immagine reale (con object-fit cover per
mantenere le proporzioni); con header VIDEO o DOCUMENT compaiono le
tile corrispondenti. L’anteprima è scopata in una sticky panel sulla
destra e segue lo scroll della pagina.

Campagne di marketing WhatsApp

Dal pannello “Marketing – Bulk Message” puoi inviare un messaggio
broadcast a una lista di numeri. Scegli un template, mappa le
variabili, opzionalmente alleghi un media URL e clicchi Invia.

Sotto al form trovi un bottone per ciascun gruppo clienti del
negozio: cliccandolo, la textarea destinatari viene precompilata
con tutti i numeri dei clienti di quel gruppo (deduplicati). Se hai
volumi alti attiva la modalità “Delayed sending” nel pannello CRON
per accodare i messaggi e rispettare i rate limit Meta.