WhatsApp Business Platform for vtenext (WASB)

• Introduzione e Requisiti
• Installazione del Plugin su WASB
• Installazione del Plugin su vtenext
• Configurazione del Plugin su vtenext
• Funzionamento del Modulo Ticket
• Modulo Conversazioni WASB
• Funzioni SDK Disponibili
• Processi vtenext

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

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.

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).

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.

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.

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.

Funzioni SDK Disponibili

Nel pacchetto vengono automaticamente installate 4 Field Action (si riconoscono dal prefisso WASB):

• 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.

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.