# WhatsApp Business Platform for vtenext (WASB) # Introduzione e Requisiti **Introduzione** Il plugin WASB per VTENEXT integra la piattaforma WhatsApp Business Platform (WASB) con VTENEXT, consentendo un'interazione diretta con clienti, contatti e lead attraverso il canale WhatsApp, nel rispetto delle normative Meta. Questa integrazione permette di: - Avviare e ricevere conversazioni direttamente su VTENEXT. - Sincronizzare le risposte in tempo reale. - Aprire automaticamente un ticket per ogni conversazione ricevuta. - Sincronizzare anagrafiche tra WASB e VTENEXT in modo bidirezionale. Per quanto riguarda i costi, il plugin segue le regole commerciali previste dai plugin standard di vtenext. **Requisiti** Per un corretto funzionamento del plugin è necessario che il numero di cellulare del contatto sia compilato nel campo dedicato in anagrafica VTENEXT e sia univoco per evitare errori di associazione. # Installazione del Plugin su WASB Il plugin per VTENEXT è già disponibile tra le configurazioni di sistema di WASB e richiede: - URL del CRM - Utente CRM predefinito per la sincronizzazione - API Key dell’utente [![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2025-02/scaled-1680-/2mDimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2025-02/2mDimage.png) [![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2025-02/scaled-1680-/JU1image.png)](https://usermanual.vtenext.com/uploads/images/gallery/2025-02/JU1image.png) # Installazione del Plugin su vtenext 1. Caricare il file ZIP ricevuto nella sezione **Impostazioni > Gestione Moduli**. 2. Selezionare il file dal proprio dispositivo. 3. Confermare l’avvio dell’importazione. 4. Una volta completata, premere **Fine**. 5. Verranno installati due nuovi moduli: **WASB Template e WASB Conversazioni**. [![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2025-02/scaled-1680-/GNaimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2025-02/GNaimage.png) [![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2025-02/scaled-1680-/r3Eimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2025-02/r3Eimage.png) [![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2025-02/scaled-1680-/m7oimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2025-02/m7oimage.png) [![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2025-02/scaled-1680-/S2qimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2025-02/S2qimage.png) # Configurazione del Plugin su vtenext Nel pannello **Impostazioni Admin**, sarà disponibile una sezione dedicata con i seguenti parametri: - **Token WASB:** fornito da BPMConsulting, necessario per la sincronizzazione. - **Utente di riferimento VTENEXT:** lo stesso utilizzato nel plugin WASB. - **Apertura Ticket automatica:** se attivata, apre un ticket per ogni conversazione ricevuta (se un ticket è già aperto per lo stesso utente, la conversazione si aggancia a esso). - **Prefisso predefinito:** consente di impostare " + " o "00" come prefisso internazionale per i numeri di telefono ricevuti. - **Finestra temporale:** definisce l’arco temporale (in giorni) per sincronizzare contatti e messaggi sulla base della data di ultima modifica. - **Cron Jobs:** consente di impostare la frequenza di sincronizzazione per: - Recupero automatico di contatti, messaggi e template da WASB. - Chiusura automatica delle conversazioni dopo 24 ore dalla creazione (secondo il modello di fatturazione Meta). [![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2025-02/scaled-1680-/lvWimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2025-02/lvWimage.png) # Funzionamento del Modulo Ticket Se la **funzione di apertura ticket** è attivata, quando un cliente invia un messaggio tramite WASB: 1. Se il numero non è già presente in anagrafica, viene creato un nuovo lead. 2. La conversazione viene associata all’anagrafica. 3. Viene aperto un ticket correlato alla conversazione. [![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2025-02/scaled-1680-/cxPimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2025-02/cxPimage.png) Le conversazioni seguono la stessa logica di gestione dei ticket provenienti dal **Portale Clienti**: - Il primo messaggio viene salvato nel campo **Descrizione**. - I messaggi successivi vengono registrati nei **Commenti**. - Gli stati seguono la logica **In attesa di risposta / Risposto dal cliente**. [![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2025-02/scaled-1680-/Fe5image.png)](https://usermanual.vtenext.com/uploads/images/gallery/2025-02/Fe5image.png) Se una conversazione supera le 24 ore, la risposta avviene tramite un **Template approvato da Meta**. # Modulo Conversazioni WASB Il modulo Conversazioni WASB è: - Integrabile nei processi VTENEXT. - Relazionabile con qualsiasi modulo nativo o personalizzato di VTENEXT. - Sincronizzabile con la rubrica WASB mediante processi e funzioni SDK. [![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2025-02/scaled-1680-/gqbimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2025-02/gqbimage.png) # Funzioni SDK Disponibili Nel pacchetto vengono automaticamente installate **4 Field Action** (si riconoscono dal prefisso WASB): [![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2025-02/scaled-1680-/6wqimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2025-02/6wqimage.png) - **Invia Template** permette di inviare tramite il modulo Conversazioni WASB un messaggio basato su modulo Template WASB (e quindi approvato da Meta) - **Invia Anagrafica** consente la creazione di un’anagrafica da vtenext a WASB (specificando la sorgente vtenext tra Lead, Contatto, Azienda) - **Crea Link Locale Documento** viene utilizzato con l’invio di messaggi con un allegato. Questa funziona copia temporaneamente un documento vtenext in una cartella pubblica via url rendendo così possibile a WhatsApp il recupero del file, per poi eliminarlo successivamente con la funzione successiva (WhatsApp una volta agganciato il documento lo importa in una sua area locale e quindi non è più necessario lasciare il documento “pubblico”. Inoltre viene resa disponibile una **SDK Action per l’invio a WASB di un messaggio**. La funzione verifica automaticamente se ci sono nuove righe non sincronizzate nel campo tabella presente sul modulo Conversazioni WASB e provvede all’invio immediato. [![image.png](https://usermanual.vtenext.com/uploads/images/gallery/2025-02/scaled-1680-/8xiimage.png)](https://usermanual.vtenext.com/uploads/images/gallery/2025-02/8xiimage.png) # Processi vtenext Sono disponibili a standard 3 Processi vtenext completi ed abbinati ai seguenti moduli: 1. **Processo gestione Ticket – MODULO Ticket** Provvede all’invio automatico di un commento attraverso il canale WASB. Controlla autonomamente se una conversazione attiva è relazionata al Ticket altrimenti utilizza il template Utility associato al Ticket per inviare un messaggio al cliente 2. **Processo di Invio da Conversazione WASB - MODULO Conversazioni WASB** Provvede all’invio di un messaggio all’interno di una conversazione 3. **Processo di creazione Anagrafica - MODULO Contatti** Provvede all’invio dei dati di un’anagrafica direttamente su WASB.