WhatsApp

WhatsApp è un'app di messaggistica istantanea e voice-over-IP che permette agli utenti di inviare messaggi, effettuare chiamate e condividere contenuti. Le aziende possono utilizzare WhatsApp Business per comunicare con i propri clienti via testo, inviare documenti e fornire supporto. Questa documentazione copre l'integrazione di un Account WhatsApp Business (WABA) con Laundry ERP.

La connessione di un Account WhatsApp Business al database Laundry ERP abilita le seguenti funzionalità:

• Inviare e ricevere messaggi WhatsApp direttamente dal database Laundry ERP.
• Creare e inviare modelli pre-approvati con segnaposto/variabili dinamiche, come:
  • Preventivi dall'app Vendite.
  • Ricevute e fatture dall'app Punto Vendita.
  • Biglietti dall'app Eventi.

L'integrazione WhatsApp supporta due flussi: iniziato dall'azienda e iniziato dal cliente. Un'azienda può avviare una discussione inviando un modello a uno o più clienti. Se il cliente risponde entro 15 giorni, una finestra di chat Discussioni si apre per iniziare la conversazione.

Se un cliente avvia la conversazione inviando un messaggio al numero WhatsApp pubblico dell'azienda, Laundry ERP apre una chat di gruppo con tutti gli operatori responsabili del canale WhatsApp.

Configurazione WhatsApp in Meta

WhatsApp è gestito da Meta, la società madre di Facebook. L'integrazione WhatsApp di Laundry ERP utilizza una connessione API standard configurata in Meta:

1. Crea un account business Meta.
2. Crea un account sviluppatore Meta.
3. Configura un'app e un prodotto WhatsApp nella console sviluppatori Meta.
4. Testa la connessione API.

Una volta connessa l'API WhatsApp, gli utenti Laundry ERP possono inviare e ricevere messaggi tramite l'applicazione Discussioni.

Creare un account business Meta

Per creare un account business con Meta, naviga su Meta Business Suite. Clicca Crea account, inserisci il nome dell'azienda, il nome dell'amministratore e un indirizzo email aziendale. Clicca Avanti e conferma l'indirizzo email nella finestra pop-up. Dopo la conferma, clicca Fine.

Segui le istruzioni nell'email inviata da Facebook per confermare la creazione dell'account business.

Creare un'app sviluppatore Meta per Laundry ERP

Nella dashboard Meta Developer, accedi con l'account sviluppatore Meta. Se non è ancora configurato un account, collega un account Facebook per creare un account sviluppatore Meta.

Dopo aver effettuato l'accesso, clicca Le mie App nell'angolo in alto a destra, poi clicca Crea App per configurare una nuova applicazione Meta.

Dettagli app

Inserisci Laundry ERP nel campo Nome App e l'indirizzo email dello sviluppatore nel campo Email di contatto app, quindi clicca Avanti.

Selezionare il tipo di app

Nella sezione Casi d'uso, sotto Filtra per, seleziona Altri, poi seleziona Altri e clicca Avanti. Nella pagina Seleziona un tipo di app, seleziona Business e clicca Avanti.

Selezionare il portafoglio business

Sotto Portafoglio business, clicca il menu a discesa e seleziona il profilo dell'account business Meta. Rivedi gli accordi, poi clicca Crea app.

Aggiungere un prodotto WhatsApp all'app

Naviga nella dashboard Meta Developer e clicca sull'app in fase di configurazione. Sotto Aggiungi prodotti alla tua app, vai su WhatsApp e clicca Configura.

Sotto Seleziona un Account Meta Business, seleziona il business Meta da configurare e clicca Continua.

Avvio rapido API WhatsApp

Una volta configurati gli account Meta e l'app, clicca Continua per procedere alla pagina Quickstart di WhatsApp. Dalla pagina Configurazione API, nella sezione Invia e ricevi messaggi, sotto Passo 1 Seleziona numeri di telefono, clicca il menu a discesa accanto a A, seleziona Gestisci elenco numeri di telefono e aggiungi fino a cinque numeri WhatsApp validi come destinatari.

Inviare un messaggio di test tramite terminale

Sotto Passo 2 Invia messaggi con l'API, clicca Invia Messaggio per inviare un messaggio di test ai numeri aggiunti.

Configurazione WhatsApp in Laundry ERP

Per creare un URL di Callback e un Token di verifica Webhook, il numero di telefono, il token, l'ID app e l'ID account devono essere configurati in Laundry ERP.

In Laundry ERP, naviga su WhatsApp → Configurazione → Account WhatsApp Business e clicca Nuovo.

In un'altra scheda del browser, naviga nella Dashboard Meta Developer e seleziona Le mie App → WhatsApp → Configurazione API. Copia i seguenti valori dalla console Meta nei campi corrispondenti in Laundry ERP:

Per ottenere l'App Secret, naviga nella dashboard Meta Developer, seleziona l'app Laundry ERP, poi nel menu laterale sotto Impostazioni App, seleziona Base. Clicca Mostra accanto a App secret, inserisci la password dell'account, copia il valore e incollalo nel campo App Secret in Laundry ERP.

Per completare la configurazione, clicca Testa Connessione. Se la configurazione è corretta, un messaggio di successo in verde appare nell'angolo in alto a destra.

Configurare i webhook

Per configurare i webhook, naviga nella dashboard Meta Developer, seleziona l'app Laundry ERP, poi nel menu laterale clicca WhatsApp → Configurazione API. Vai su Passo 3: Configura webhook per ricevere messaggi e clicca Configura webhooks.

Nella pagina di configurazione webhook, clicca Modifica e aggiungi l'URL di Callback e il Token di verifica Webhook da Laundry ERP (disponibili in WhatsApp → Configurazione → Account WhatsApp Business nella sezione Ricezione Messaggi).

Aggiungere campi webhook

Nella sezione Campi webhook, clicca Gestisci e seleziona le seguenti caselle nella colonna Sottoscrivi:

• account_update
• message_template_quality_update
• message_template_status_update
• messages
• template_category_update

Clicca Fatto per confermare.

Aggiungere un numero di telefono

Per configurare il numero di telefono aziendale, naviga nella dashboard Meta Developer, seleziona l'app Laundry ERP, poi sotto WhatsApp clicca Configurazione API. Vai su Passo 5: Aggiungi un numero di telefono e clicca Aggiungi numero di telefono.

Inserisci il Nome azienda e il Sito web o pagina profilo dell'azienda, seleziona il paese, poi compila i dettagli del profilo WhatsApp Business. Inserisci il numero di telefono aziendale e completane la verifica.

Creare un token permanente

Dopo che la configurazione e i test sono completati, crea un token permanente per sostituire il token temporaneo.

Naviga su Meta Business Suite poi vai su Impostazioni business → Utente → Utenti di sistema. Seleziona un utente di sistema esistente o creane uno nuovo cliccando Aggiungi.

Clicca Aggiungi risorse, seleziona App sotto Seleziona tipo di risorsa, seleziona l'app Laundry ERP e attiva i permessi Controllo completo, poi clicca Salva modifiche.

Clicca Genera nuovo token, seleziona l'app Laundry ERP e imposta la scadenza. Aggiungi i seguenti permessi:

• business_management
• whatsapp_business_messaging
• whatsapp_business_management
• whatsapp_business_manage_events

Clicca Genera token, copia il valore e aggiorna il campo Token di accesso nell'account WhatsApp Business in Laundry ERP.

Andare in produzione con l'app Meta

L'app Meta deve essere impostata su Live nella dashboard Meta Developer. Clicca sull'app, poi attiva il campo Modalità App da Sviluppo a Live.

Modelli WhatsApp

I modelli WhatsApp permettono di memorizzare messaggi inviati frequentemente. Creando modelli per situazioni specifiche, gli utenti possono inviare messaggi pre-approvati senza dover comporre lo stesso testo ripetutamente.

Per accedere ai modelli WhatsApp, naviga su WhatsApp → Modelli.

Ogni modello ha tre schede:

• Corpo: memorizza il corpo del messaggio, che può contenere segnaposto per contenuto dinamico.
• Pulsanti: aggiunge pulsanti cliccabili/collegamenti in fondo al modello. I tipi disponibili sono: Risposta rapida, Visita sito web e Chiama numero.
• Variabili: elenca tutti i segnaposto nel modello e le variabili corrispondenti.

Creare modelli WhatsApp in Laundry ERP

Per creare un modello, vai su WhatsApp → Modelli e clicca Nuovo. Inserisci un Nome, seleziona una Lingua e l'Account WhatsApp Business. Sotto Si applica a, seleziona il modello a cui il modello dovrebbe applicarsi.

Cambia la Categoria in una delle seguenti:

• Marketing: promozioni o informazioni sulla tua azienda, prodotti o servizi.
• Utilità: messaggi su una transazione, un account, un ordine o una richiesta specifica del cliente.
• Autenticazione: password monouso per autenticare transazioni o login.

Nella scheda Corpo, configura il messaggio principale del modello.

Quando tutte le modifiche sono fatte, clicca Invia per approvazione per sottoporre il modello a Meta.

Segnaposto e variabili

Le variabili dinamiche fanno riferimento a campi specifici nel database Laundry ERP per produrre dati unici nel messaggio WhatsApp. Vengono aggiunte nel Corpo inserendo segnaposto nel testo: {{1}} per il primo, {{2}} per il secondo, e così via.

I segnaposto devono essere configurati nella scheda Variabili del modello prima dell'invio per approvazione. Modifica il Tipo in Campo del modello e seleziona il Campo corrispondente.

Approvazione modello Meta

Dopo l'aggiornamento delle variabili dinamiche, il modello deve essere re-inviato a Meta per l'approvazione. Clicca Invia per approvazione per avviare il processo.

Sincronizzazione modelli

I modelli devono essere sincronizzati nel database Laundry ERP una volta approvati dal team Meta. Naviga su WhatsApp → Configurazione → Account WhatsApp Business, seleziona la configurazione e clicca Sincronizza Modelli nella sezione Invio messaggi.

Creare modelli WhatsApp in Meta

Naviga su Meta Business Suite e vai su Strumenti account → Modelli di messaggio. Clicca Crea modello, seleziona la Categoria, inserisci il Nome e la Lingua, poi clicca Continua per configurare il modello.

Notifiche

Le notifiche in WhatsApp sono gestite come conversazioni di messaggi in Laundry ERP. Le impostazioni delle notifiche possono essere regolate navigando su WhatsApp → Configurazione → Account WhatsApp Business, selezionando l'account e scorrendo fino alla sezione Controllo.

Aggiungere utenti a una chat

Gli utenti possono essere aggiunti a una chat WhatsApp espandendo la finestra pop-up. Le conversazioni WhatsApp si trovano nell'app Discussioni. Seleziona una conversazione, poi clicca l'icona Aggiungi utente in alto a destra.

FAQ API WhatsApp

Verifica

Se l'app Meta richiede un livello di accesso avanzato ai permessi, potrebbe essere necessario completare una verifica aziendale completa, incluso l'invio di documenti aziendali ufficiali a Meta.

Errori modello

La modifica dei modelli può causare errori se non viene seguito il processo corretto.

Errore di validazione duplicato

Quando si sincronizzano i modelli, possono esistere modelli con lo stesso nome in Meta e in Laundry ERP, causando un errore di validazione duplicato. Per correggerlo, rinomina il modello duplicato in Laundry ERP e sincronizza nuovamente.

Errori token

Errore utente 190

Se il token temporaneo non viene sostituito con un token permanente, Laundry ERP visualizza un errore di sessione scaduta. Crea un token permanente per risolvere.

Errore utente 100

Se un Dipendente tenta di configurare il token permanente, potrebbe apparire un errore. Crea un utente di sistema Admin per risolvere.

Altro

• Il modello WhatsApp non può essere inviato a più contatti: assicurati che la funzionalità Multi-Template sia abilitata sul modello.
• Verificare perché un messaggio WhatsApp non è stato inviato: abilita le colonne Tipo di errore e Motivo errore sotto WhatsApp → Messaggi.