Integrazione di ScuolaSemplice con WhatsApp Business
→ Scarica questa guida in formato PDF
Addon Premium, per maggiori informazioni sull’attivazione rivolgersi cortesemente all’indirizzo commerciale@blucloud.it
1. Creazione dell’account WhatsApp Business
Navigare all’indirizzo https://business.facebook.com/ ed accedere con le proprie credenziali di Facebook.
Dal menù a sinistra della pagina accedere alla sezione Account → Account WhatsApp.
Cliccare il pulsante in alto a destra Aggiungi e di seguito l’opzione Crea un nuovo account WhatsApp business.
Inserire di seguito il proprio nome di WhatsApp business secondo le indicazioni fornite da Meta, ed indicare la categoria per esempio Istruzione.
Compilare poi i seguenti campi facoltativi con le proprie informazioni: Descrizione dell’azienda, Sito web.
A questo punto inserire il proprio numero di telefono da associare al proprio account WhatsApp Business scegliendo l’opzione Aggiungi un nuovo numero (o scegliere l’opzione desiderata tra le due).
Inserire di seguito il codice ricevuto via SMS o tramite chiamata per validare il numero di cellulare inserito.
2. Creazione dell’account sviluppatore
Navigare all’indirizzo https://developers.facebook.com e cliccare su Get started.
Creare ora un nuovo account oppure utilizzare l’accesso al proprio account di Facebook come da immagine di seguito (consigliato)
Inserire il proprio numero di cellulare e di seguito il codice ricevuto via SMS per verificare l’account.
Confermare o aggiornare il proprio indirizzo email associato e terminare la procedura inserendo il proprio ruolo.
3. Creazione dell’App
Dopo aver terminato la creazione dell’account da sviluppatore cliccare nella prossima pagina il pulsante centrale Crea un’app e di seguito inserire un nome per la stessa (esempio ScuolaSemplice)
Di seguito indicare i casi d’uso relativi all’app che si sta creando, in questo caso servirà scegliere l’opzione Connettiti con i clienti tramite WhatsApp.
Dalla pagina successiva scegliere l’azienda da collegare se già presente (se è stata creata come indicato nel paragrafo 1 di questa guida) o altrimenti cliccare il pulsante Crea un portfolio business per crearne una nuova.
Cliccare il pulsante Avanti per scorrere prima alla sezione dei Requisiti e di seguito alla Panoramica.
Terminare la procedura cliccando il pulsante Vai alla dashboard.
Accedere dentro l’App appena creata (quindi sempre dalla pagina https://developers.facebook.com/apps) e cliccare su Personalizza il caso d’uso Connettiti con i clienti tramite WhatsApp.
Ora, se non è già stato fatto precedentemente all’indirizzo https://business.facebook.com, inserire/aggiornare i propri dati di pagamento.
Di seguito scorrere in basso alla sezione Configurazione e cliccare sul quadrante Webhooks.
Inserire ora nei campi URL di callback e Verifica il token i relativi dati che si possono reperire navigando alla sezione Configurazione → Configurazione WhatsApp di ScuolaSemplice e di seguito cliccando sul pulsante Configurazione webhook.
Nella parte sottostante attivare le 2 funzionalità attualmente utilizzabili con l’integrazione di WhatsApp Business e ScuolaSemplice, ossia business_status_update e messages.
A questo punto occorrerà effettuare nuovamente l’accesso all’indirizzo https://business.facebook.com/ per creare un utente tecnico di sistema che permetterà poi di generare un token permanente che dovrà essere inserito su ScuolaSemplice.
Dalla Sezione Utenti → Utenti di sistema cliccare il pulsante Aggiungi e di seguito compilare i campi relativi al nome ed al ruolo.
Cliccare successivamente il pulsante Genera Token e, dalla finestra successiva:
- selezionare l’App precedentemente creata
- specificare la scadenza (si consiglia MAI)
- Cliccare sul pulsante Genera token
- verificare l’account inserendo il codice ricevuto all’indirizzo email del proprio account di Meta
- copiare il token generato con l’apposito pulsante accanto
Assicurarsi di copiare il codice che dovrà essere successivamente inserito nel proprio ScuolaSemplice.
Recarsi ora alla sezione Account → App, entrare dentro la propria App e cliccare il pulsante Assegna persone.
Selezionare l’utenza tecnica creata per collegarla all’App ed assegnare tutti i permessi previsti.
Ora, la stessa identica operazione dovrà essere fatta da Account → Account WhatsApp, quindi cliccando su Aggiungi persone, scegliendo l’utenza tecnica ed attivando tutti i permessi previsti.
4. Riassunto dei dati generati nei propri account Meta da inserire su ScuolaSemplice
Attenzione: Rilvolgersi all’assistenza di BluCloud per inserire i seguenti dati nel proprio sistema ScuolaSemplice
- whatsapp.apiKey = : Token generato dalla sezione Sezione Utenti → Utenti di sistema di https://business.facebook.com
- whatsapp.phoneNumber = ID relativo al numero di cellulare verificato nel proprio account Whatspp Business.
Navigare su https://business.facebook.com/ ed accedere alla pagina Account → Account WhatsApp.
Quindi cliccare pulsante con i 3 punti e di seguito l’opzione WhatsApp Manager
Cliccare il pulsante con l’ingranaggio sul proprio numero per ottenere l’ID del numero di telefono
- whatsapp.wabaId = ID relativo al proprio account WhatsApp Business
Navigare su https://business.facebook.com/ ed accedere alla pagina Account → Account WhatsApp e copiare l’ID presente sotto al nome del proprio account
- whatsapp.webhookUrl (Già inserito come indicato al punto 3 della guida)
- whatsapp.webhookVerifyToken (Già inserito come indicato al punto 3 della guida)