Integrazione WordPress

Business Messaging for WbizTool è il plugin WordPress ufficiale. Invia messaggi WhatsApp dal tuo numero collegato quando succede qualcosa sul tuo sito: un ordine WooCommerce cambia stato, una prenotazione WP Amelia viene riprogrammata o cancellata, oppure viene inviato un modulo Contact Form 7.

Prima di iniziare#

• Un account Wbiztool con un numero WhatsApp collegato in Impostazioni WhatsApp.
• Il tuo Client ID e la tua chiave API da Impostazioni → Chiavi API.
• Il WhatsApp Client ID del numero da cui inviare, mostrato in Impostazioni WhatsApp.

Installare il plugin#

1. Installa da WordPress

   Nell'amministrazione di WordPress, vai su Plugins → Add New (in italiano: Plugin → Aggiungi nuovo), cerca Business Messaging for WbizTool, fai clic su Install Now (Installa ora) e poi su Activate (Attiva). Puoi anche scaricarlo dalla directory dei plugin di WordPress e caricare il file zip da Plugins → Add New → Upload Plugin (Plugin → Aggiungi nuovo → Carica plugin). Se il caricamento non riesce (ad esempio per un limite di dimensione dei file), decomprimi il file e copia la cartella business-messaging-for-wbiztool in /wp-content/plugins/ tramite FTP, poi attiva il plugin in Plugins (Plugin).

2. Apri le impostazioni del plugin

   Nella barra laterale dell'amministrazione compare un nuovo menu WbizTool con quattro pagine: Settings (impostazioni), Templates (modelli), Test Messages (messaggi di prova) e Logs (registri).

Configurare il plugin#

1. Inserisci le credenziali API

   In WbizTool → Settings, nella sezione API Configuration (configurazione API), compila Client ID, API Key e WhatsApp Client ID, poi fai clic su Test Connection (verifica connessione).

   Con credenziali corrette, Test Connection mette in coda un vero messaggio di prova verso il numero segnaposto 10000000000, che quindi compare nella cronologia dei messaggi di Wbiztool. Non può essere consegnato e lì risulta non riuscito; puoi ignorarlo. Se vedi Unable to connect to WbizTool API. Please check your internet connection. (impossibile connettersi all'API WbizTool), molto probabilmente il Client ID, la chiave API o il WhatsApp Client ID sono errati, oppure il tuo piano non ha più messaggi. Raramente indica un problema con la tua connessione a internet.

2. Imposta le opzioni generali

   In General Settings (impostazioni generali):

   • Default Country Code (prefisso internazionale predefinito): usato quando il paese di fatturazione di un ordine WooCommerce non può essere associato a un prefisso telefonico. Il valore predefinito è 1, quindi cambialo con il tuo paese principale, ad esempio 91.
   • Test Mode (modalità di prova): se attiva, i messaggi vengono scritti nel registro ma non inviati.
   • Admin Notifications (notifiche all'amministratore): questa casella non ha alcun effetto visibile nella versione 1.0.3, perché la pagina delle impostazioni non ha un campo per il numero di telefono dell'amministratore che utilizza. Per gli avvisi all'amministratore sugli invii dei moduli, usa le impostazioni di Contact Form 7 descritte più avanti.

3. Attiva integrazioni ed eventi

   In Integration Settings (impostazioni delle integrazioni), abilita ogni plugin che usi e seleziona gli eventi che devono inviare un messaggio. Un'integrazione mostra le sue opzioni solo quando il relativo plugin è attivo sul tuo sito. Fai clic su Save Settings (salva impostazioni).

4. Modifica i modelli dei messaggi

   In WbizTool → Templates, scegli la scheda WooCommerce, Amelia o Contact Form 7, seleziona un evento e modificane il testo. La pagina elenca le variabili che puoi usare e mostra un'anteprima in tempo reale. Reset (ripristina) riporta il testo predefinito.

5. Invia una prova

   In WbizTool → Test Messages, invia un messaggio al tuo numero per verificare che tutto funzioni, poi controlla WbizTool → Logs.

WooCommerce#

I messaggi vengono inviati al telefono di fatturazione dell'ordine. Il prefisso internazionale deriva dal paese di fatturazione; se quel paese non viene riconosciuto, si usa il Default Country Code.

Variabili dei modelli:

Esempio di modello:

Hi {customer_first_name},

Thank you for your order #{order_number}.
Total: {order_total}

Track your order: {order_url}

{store_name}

WP Amelia#

I messaggi vengono inviati al telefono del cliente indicato nella prenotazione. La pagina delle impostazioni elenca sei eventi:

• Booking Added (Frontend bookings): prenotazione aggiunta dal frontend
• Booking Rescheduled: prenotazione riprogrammata
• Booking Cancelled: prenotazione cancellata
• Appointment Added (Backend): appuntamento aggiunto dal backend
• Event Booking Saved: prenotazione evento salvata
• Event Booking Updated: prenotazione evento aggiornata

Variabili disponibili nei modelli Amelia:

Contact Form 7#

Quando un modulo viene inviato, il plugin può inviare un messaggio a te (l'amministratore), alla persona che ha compilato il modulo o a entrambi.

Il plugin individua nome, email, telefono e messaggio nel tuo modulo in base al nome del campo. Usa nomi comuni come your-name, your-email, your-phone (oppure phone, mobile, whatsapp), your-subject e your-message. La risposta automatica al cliente viene inviata solo se viene trovato un campo telefono. Chiedi il numero con il prefisso internazionale: il plugin riconosce solo alcuni prefissi e negli altri casi usa il Default Country Code.

Variabili dei modelli:

Ogni campo del modulo è disponibile anche con il proprio nome, con i trattini sostituiti da trattini bassi. Ad esempio, un campo chiamato your-city diventa {your_city}.

Esempio di notifica per l'amministratore:

New enquiry from {contact_name} ({contact_phone}) on {form_title}:
{message}

Le interruzioni di riga nel messaggio del visitatore vengono rimosse, quindi {message} arriva su una sola riga.

Registri#

WbizTool → Logs elenca i messaggi che il plugin ha tentato di inviare, con data, tipo di evento, integrazione, telefono, messaggio e stato. Usalo per verificare se un evento è stato attivato e se il messaggio è stato inviato. Non mostra perché un messaggio non è stato inviato.

Risoluzione dei problemi#

Per vedere gli errori PHP del plugin, attiva il log di debug di WordPress in wp-config.php. Gli errori vengono scritti in wp-content/debug.log. Disattivalo di nuovo quando hai finito.

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);