Richieste di Callback: configurazione e aiuto

Carica lo ZIP tramite "Modules" > "Module Manager" > "Upload a module" e installalo. Puoi anche inserire il modulo estratto in /modules/mprcallback e installarlo dall'elenco dei moduli. L'installazione crea le tabelle della coda, registra gli hook disponibili e aggiunge Richieste di chiamata al menu "Customer Service" o "Customers" disponibile per la tua versione di PrestaShop.

Controlla il widget nel tema effettivo, perché il posizionamento nell'intestazione e sulle pagine prodotto usa gli hook del tema.

Seleziona il negozio da configurare. Apri Richieste di chiamata > Impostazioni > Configurazione. Le schede sono Pianificazione, Posizionamento, Testi, Notifiche e Privacy e abusi. Anche l'orario settimanale e la coda delle richieste sono specifici di quel negozio.

Confermare il fuso orario e l'obiettivo di richiamo

In Pianificazione, controlla queste impostazioni prima di aggiungere gli orari di apertura:

Premi Salva. Un fuso orario errato o non disponibile può impedire al pianificatore di offrire fasce.

Inserire l'orario settimanale

Apri Richieste di chiamata > Orari di apertura. Aggiungi uno o più intervalli per ogni giorno lavorativo, usando orari HH:MM. Lascia vuoto un giorno quando sei chiuso. Salva l'orario.

Usa due intervalli per la pausa pranzo, ad esempio da 09:00 a 12:00 e da 13:00 a 17:00. Le fasce offerte rimangono all'interno di un intervallo di apertura. Seleziona oltre la mezzanotte per un intervallo come da 22:00 a 02:00, che termina il giorno successivo.

Finché non esiste un intervallo di apertura futuro valido, il modulo non può offrire una fascia e non accetta richieste di chiamata. Controlla il pannello di disponibilità sotto l'orario per vedere cosa verrebbe offerto ora a un visitatore.

Aggiungere eccezioni e festività

Usa una data di eccezione per chiudere un giorno o sostituirne l'intervallo di apertura. Un'eccezione prevale su quel giorno di calendario, inclusa la parte di un intervallo iniziato la sera precedente. Controlla gli orari notturni dopo aver aggiunto un'eccezione.

Scegli un paese e un anno per importare le festività come date di eccezione chiuse. Confronta le date importate con le festività effettivamente osservate dal team. Rimuovi o modifica un'eccezione quando deve tornare a valere il normale orario settimanale.

Il widget offre fasce concrete anziché un conto alla rovescia. Ogni fascia ha inizio, fine e scadenza salvati in UTC. Il fuso orario della pianificazione determina la dicitura locale. Modificare quel fuso in seguito non sposta la scadenza di una richiesta esistente.

Le fasce diverse da ASAP richiedono almeno 15 minuti di apertura utilizzabili. Fuori orario, la finestra spiega che le chiamate avvengono durante gli orari di apertura. La riga sul tempo abituale in minuti appare solo mentre il negozio è aperto.

Dopo aver modificato gli orari, controlla sia l'anteprima attuale della disponibilità sia una richiesta dal negozio. Un negozio aperto solo nel primo pomeriggio potrebbe non offrire le scelte Mattina o Più tardi oggi per lo stesso giorno, perché queste usano i limiti fissi di mezzogiorno e delle 16:00.

Configurare i pulsanti

Apri Impostazioni > Configurazione > Posizionamento.

Per le pagine di destinazione, scegli Solo sui prodotti, categorie e pagine selezionati o Ovunque tranne sui prodotti, categorie e pagine selezionati. Salva, poi seleziona i prodotti, le categorie o le pagine di contenuto nel selettore di entità sotto il modulo. Controlla una pagina selezionata e una non selezionata per verificare il risultato.

Posizionare un pulsante personalizzato

Abilita Hook personalizzato del tema, salva, poi aggiungi questo codice al template Smarty del tema desiderato:

{hook h='displayMprCallback'}

Verifica che il tema includa ancora le risorse frontend del modulo e l'output della finestra di dialogo. Un hook personalizzato cambia il posizionamento; non aggira il targeting delle pagine né i controlli degli orari di apertura.

Modificare i testi tradotti

Usa la scheda Testi per modificare ogni lingua del negozio:

Conferma di riserva viene usata quando la risposta di successo non può indicare la fascia selezionata. Di norma la conferma descrive la fascia scelta.

Scegliere i destinatari delle notifiche

In Notifiche, imposta Notifica questi indirizzi con un elenco separato da virgole e salva. L'installazione copia l'indirizzo e-mail del negozio selezionato. Durante l'esecuzione, un elenco destinatari vuoto o inutilizzabile viene sostituito dall'e-mail di quel negozio, se valida.

Una nuova richiesta accettata mette in coda una notifica e tenta la consegna. I promemoria per i ritardi vengono gestiti dall'attività pianificata dopo il periodo di tolleranza. La consegna dipende dal servizio di posta in uscita di PrestaShop; una richiesta salvata è la registrazione principale dell'avvenuta acquisizione.

Configurare privacy e abusi

Il modulo controlla anche un honeypot, i tempi di invio, i dati firmati del modulo e l'origine. Per controllare gli abusi, memorizza hash IP con chiave anziché indirizzi IP in chiaro. Non verifica che un numero appartenga alla persona che lo inserisce.

L'unione dei duplicati è condizionale. La richiesta esistente deve essere ancora Nuova, entro il periodo per i duplicati e prima della scadenza. L'identità cliente deve corrispondere, quindi due clienti registrati con lo stesso numero restano separati. Un impegno abbreviato può creare una notifica separata di modifica della scadenza.

Apri Richieste di chiamata. Ogni riga mostra Stato, In ritardo, Telefono, Nome, Fascia richiesta, Chiamare entro, Provenienza, Note e Ricevuta, insieme all'ID della richiesta. Il numero è un link per avviare la chiamata. La provenienza può identificare la pagina o il prodotto da cui il visitatore ha richiesto la chiamata.

Usa Nuova, Chiamato, Nessuna risposta e Completato per seguire il lavoro. Puoi modificare stato e note direttamente nella riga, usare le azioni di riga oppure selezionare richieste per Segna come chiamato, Segna nessuna risposta o Segna come completato. Elimina selezionati rimuove definitivamente i dati personali delle richieste selezionate.

In ritardo viene calcolato quando carichi l'elenco. Si applica alle richieste Nuova e Nessuna risposta la cui scadenza salvata è passata. Non dipende da un job cron che imposti un indicatore di ritardo. Usa i filtri delle colonne per restringere l'elenco. Esporta CSV esporta il risultato filtrato attuale.

Gli indicatori riepilogativi sono Nuove oggi, In ritardo ora, Chiamate oggi e Tempo mediano di richiamo. Usali con gli orari effettivi Chiamare entro quando assegni il lavoro. Cambiare uno stato non effettua una telefonata; il personale usa il proprio servizio telefonico per contattare il visitatore.

L'accesso del personale segue i permessi del back office. Visualizzazione ed esportazione, modifica di stato o note ed eliminazione delle richieste richiedono i diritti corrispondenti. Anche le modifiche a orari e configurazione richiedono l'accesso in modifica.

L'installazione registra Invia promemoria per le richieste in ritardo ogni cinque minuti e Elimina le richieste scadute ogni giorno. Collega queste attività MPR condivise a un punto di accesso dello scheduler autenticato e funzionante nella tua installazione. Usa il suo URL o comando CLI effettivo e il token, poi verifica che entrambi i nomi delle attività compaiano nei risultati.

Questo modulo non include un proprio cron.php né un front controller cron. Se la tua installazione non ha un punto di accesso funzionante allo scheduler condiviso, predisponilo prima di affidarti a promemoria o conservazione. Un comando che punta a un /modules/mprcallback/cron.php inesistente non li eseguirà.

Non affidarti alle visite nel negozio per queste attività. Lo scheduler incluso esclude il meccanismo di ripiego attivato dai visitatori per le attività senza un'origine esplicitamente consentita, e queste definizioni non permettono tale meccanismo. Senza un'esecuzione consentita regolare, promemoria ed eliminazione automatica possono restare in sospeso anche se l'indicatore di ritardo della coda è corretto.

Gli hook GDPR ufficiali di PrestaShop supportano l'esportazione e la cancellazione delle richieste collegate a un cliente registrato. Le richieste degli ospiti necessitano di una ricerca separata, perché un ospite viene identificato dal numero e non da un account cliente.

In Impostazioni > Configurazione, usa Richieste degli ospiti per numero. Inserisci Numero di telefono, premi Cerca richieste, controlla le corrispondenze, poi usa l'azione di esportazione o cancellazione necessaria. La validazione accetta lo stesso formato del numero usato dal modulo pubblico. Controlla attentamente il numero prima di cancellare; anche un numero digitato male può essere valido.

Il negozio selezionato determina a quali richieste possono accedere queste schermate. Configura separatamente fuso orario, destinatari, posizionamenti e conservazione di ogni negozio.

Inviare la prima richiesta di prova

1. Salva il fuso orario del negozio e almeno un intervallo di apertura.
2. Apri un posizionamento abilitato nel negozio e attendi il caricamento delle fasce disponibili.
3. Inserisci un numero con prefisso nazionale o internazionale, scegli una fascia e accetta la dichiarazione di consenso. Il nome è facoltativo.
4. Invia e leggi la fascia promessa nella conferma.
5. Trova la richiesta in Richieste di chiamata. Confronta numero, provenienza e orario Chiamare entro, poi controlla la casella delle notifiche.
6. Cambia lo stato e aggiungi una nota. Verifica che il filtro dell'elenco ed Esporta CSV mostrino il record di prova desiderato.
7. Controlla i risultati dello scheduler per l'esecuzione di promemoria e pulizia.

Risolvere i problemi comuni

• Il pulsante non compare: controlla Pulsante flottante, Pagine prodotto, Intestazione o Hook personalizzato del tema, il targeting delle pagine, il negozio selezionato e gli hook del tema attivo.
• Le chiamate non sono disponibili: controlla Fuso orario del negozio, gli orari settimanali e le date di eccezione. Senza una fascia di apertura valida nell'orizzonte di ricerca, gli invii non sono disponibili.
• Manca una fascia per oggi: controlla i limiti fissi della mattina e dopo le 16:00 e l'intervallo utilizzabile richiesto. Un obiettivo ASAP deve rientrare prima della chiusura.
• Il modulo di richiesta scade: riaprilo o aggiorna gli orari offerti prima di inviarlo nuovamente.
• Un numero viene rifiutato: usa un prefisso nazionale supportato o un numero internazionale valido. L'accettazione del formato non conferma che il numero sia raggiungibile.
• Non arriva posta: controlla prima la richiesta salvata, poi Notifica questi indirizzi e la posta PrestaShop. I tempi dei promemoria richiedono anche il periodo di tolleranza e l'esecuzione cron consentita.
• Gli orari sembrano errati: controlla Fuso orario del negozio e confronta l'impegno salvato. Le richieste esistenti non si spostano quando modifichi le impostazioni di pianificazione.
• Le vecchie richieste rimangono: controlla Elimina le richieste dopo e i risultati dell'attività di pulizia. La conservazione viene gestita in lotti limitati, quindi un arretrato può richiedere più esecuzioni.

Esporta le richieste necessarie prima di disinstallare tramite "Module Manager". La disinstallazione rimuove richieste di chiamata, orari settimanali, date di eccezione, cronologia delle notifiche e impostazioni del modulo. Rimuove anche le attività pianificate e le voci di menu del modulo. Reinstallare non consente di recuperare la coda eliminata.