WhatsApp Integrazione con LenoChat

Prerequisiti prima di iniziare

Prima di poter collegare WhatsApp a LenoChat, hai bisogno di alcune cose pronte. Questi sono requisiti imposti da Meta (la società dietro WhatsApp) piuttosto che da LenoChat, quindi devi averli pronti prima di iniziare la configurazione.

• Un account Facebook Business Manager — devi avere accesso amministrativo al Business Manager che possedrà il WhatsApp Business Account. Se la tua azienda non ha ancora un account Business Manager, creane uno business.facebook.com prima di procedere.
• Un numero di telefono valido — è il numero su cui i clienti ti scriveranno. Deve essere un numero di telefono registrato dall'azienda, non personale. Il numero non può essere già registrato con l'app mobile normale WhatsApp o WhatsApp Business — se lo è, devi prima rimuoverlo da quelle app.
• Verifica del numero di telefono — durante il processo di configurazione, Meta invierà un codice di verifica al numero tramite SMS o chiamata vocale. Assicurati di avere accesso a messaggi o chiamate su quel numero.
• Uno spazio di lavoro LenoChat — hai bisogno di un account LenoChat attivo. L'integrazione WhatsApp è disponibile su tutti i piani, incluso il piano gratuito.

Guida Passo dopo Passo alla Connessione

L'intero processo di connessione avviene all'interno della dashboard LenoChat e in una finestra popup dove ti autentichi con Meta. Segui attentamente questi passaggi per collegare il tuo numero WhatsApp aziendale.

• Passo 1: Accedi alla dashboard LenoChat e clicca su Impostazioni nella barra laterale di navigazione a sinistra.
• Passo 2: Seleziona Integrazioni dal menu delle impostazioni. La pagina Integrazioni mostra tutti i canali disponibili, inclusi WhatsApp, Instagram e Facebook Messenger.
• Passo 3: Trova la sezione WhatsApp nella pagina Integrazioni. Se non hai ancora collegato WhatsApp, vedrai un pannello con il logo WhatsApp, una lista di prerequisiti e un pulsante Connessione WhatsApp.
• Passo 4: Clicca sul pulsante Collega WhatsApp. Si apre una nuova finestra popup che ti indirizza alla pagina di accesso Facebook di Meta.
• Passo 5: Accedi al tuo account Facebook che ha accesso amministrativo al tuo Facebook Business Manager. Se sei già loggato, il popup salta automaticamente questo passaggio.
• Passo 6: Concedi i permessi richiesti. LenoChat richiede due permessi: whatsapp_business_messaging (per inviare e ricevere messaggi per tuo conto) e business_management (per accedere ai dettagli del tuo WhatsApp conto aziendale). Clicca su Continua per approvare.
• Passo 7: Seleziona il tuo WhatsApp Conto Business. Se ne hai già uno, sceglilo dalla lista. In caso contrario, Meta ti guiderà nella creazione di un nuovo WhatsApp Account Business durante questo processo.
• Passo 8: Scegli il numero di telefono che vuoi collegare. Puoi selezionare un numero verificato esistente dal tuo WhatsApp Conto Business o registrarne uno nuovo. Se si registra un nuovo numero, Meta invierà un codice di verifica tramite SMS o chiamata vocale — inserisci il codice per verificare.
• Passo 9: Completa la configurazione guidata inserendo i dati della tua azienda (nome aziendale, categoria, descrizione) come richiesto da Meta. Questi dettagli appaiono nel tuo profilo WhatsApp Business che i clienti vedono.
• Passo 10: Una volta completata la configurazione, la finestra pop-up si chiude automaticamente e la dashboard della LenoChat si aggiorna mostrando il numero di WhatsApp collegato. Vedrai una conferma che mostra il nome e il numero di telefono della tua azienda verificati nella sezione WhatsApp della pagina Integrazioni.

Gestione dei numeri WhatsApp connessi

Una volta connessi, i tuoi numeri WhatsApp Business sono visualizzati in una tabella nella pagina Integrazioni, sotto la sezione WhatsApp. Ogni riga mostra il nome dell'azienda verificato e il numero di telefono. Puoi gestire i tuoi numeri collegati da questo pannello in qualsiasi momento.

• Visualizzazione dei numeri collegati — la sezione WhatsApp mostra una griglia con due colonne: Nome (il tuo WhatsApp Nome dell'azienda verificato) e Numero (il numero di telefono visualizzato, ad esempio +1 234 567 8900). Ogni riga rappresenta un numero di telefono collegato.
• Disconnettere un numero — ogni riga ha un pulsante Disconnetti. Clicca e conferma l'azione nella finestra di dialogo che appare. Disconnettersi rimuove il numero da LenoChat ma non influisce sul tuo account aziendale WhatsApp lato di Meta. Puoi ricollegare lo stesso numero in qualsiasi momento ripetendo i passaggi di configurazione.
• Riconnessione o aggiunta di numeri — per aggiungere un nuovo numero o ricollegare un numero precedentemente disconnesso, clicca di nuovo su Collega WhatsApp e segui lo stesso flusso di configurazione. LenoChat rimuove tutte le connessioni precedentemente memorizzate per il tuo workspace e le sostituisce con i numeri selezionati durante il nuovo flusso di connessione.
• Numeri multipli — se la tua azienda utilizza più di un numero WhatsApp (ad esempio, numeri separati per vendite e supporto), puoi collegarli tutti durante un unico flusso OAuth. Tutti i numeri selezionati durante la configurazione appariranno nella tabella e riceveranno i messaggi in modo indipendente.

Come appaiono WhatsApp messaggi nella tua casella di posta

Quando un cliente invia un messaggio WhatsApp al tuo numero collegato, questo arriva nella tua casella di posta LenoChat in pochi secondi. L'esperienza nella casella di posta per le conversazioni WhatsApp è quasi identica a quella delle chat dal vivo, con alcuni dettagli specifici WhatsApp.

• Badge del canale — ogni WhatsApp conversazione mostra un badge verde WhatsApp (codice colore #25D366) accanto al nome del visitatore, così gli agenti possono identificare istantaneamente il canale senza aprire la conversazione.
• Identità del visitatore — il nome visualizzato WhatsApp del cliente e il numero di telefono sono indicati come nome del visitante. Se il profilo WhatsApp del cliente include un nome, quel nome viene mostrato; altrimenti, viene utilizzato il numero di telefono.
• Tipi di messaggi — i messaggi di testo appaiono come bolle di chat standard. Le immagini inviate dal cliente sono visualizzate in miniatura su vista degli agenti a grandezza naturale. Gli allegati ai documenti (PDFs, fogli di calcolo, ecc.) appaiono come link a file scaricabili.
• Risposta — gli agenti digitano la loro risposta nello stesso campo di input del messaggio usato per tutti i canali e premono Invia. La risposta viene inviata all'app WhatsApp del cliente tramite il WhatsApp Business API. Non c'è differenza nel flusso di lavoro delle risposte rispetto alla chat dal vivo.
• Leno AI gestione — se Leno AI è abilitato per il tuo spazio di lavoro, i messaggi WhatsApp in arrivo vengono gestiti prima dall'IA, proprio come i messaggi in chat live. L'IA risponde usando la tua base di conoscenze addestrata. Se il cliente richiede un agente umano o l'IA non riesce a risolvere la query, la conversazione viene escalata alla coda degli agenti seguendo le regole di handoff configurate da tu.

WhatsApp Finestre di conversazione API Aziendale

Il WhatsApp Business API applica una finestra di servizio clienti di 24 ore su 24. Capire come funziona questa finestra è essenziale per gestire efficacemente le WhatsApp conversazioni in LenoChat.

• La finestra di 24 ore — quando un cliente ti invia un messaggio, si apre una finestra di servizio di 24 ore. Durante questa finestra, la tua azienda può inviare risposte illimitate a quel cliente senza costi aggiuntivi per messaggio (all'interno della tua quota mensile gratuita o del piano a pagamento).
• Scadenza finestra — se trascorrono 24 ore dall'ultimo messaggio del cliente senza che la tua azienda risponda, la finestra di servizio si chiude. Dopo di ciò, non puoi inviare ulteriori messaggi al cliente a meno che tu non utilizzi un modello di messaggio pre-approvato (i messaggi modello comportano costi separati da parte di Meta).
• Reengagement del cliente — la finestra si aeta ogni volta che il cliente invia un nuovo messaggio. Quindi, se un cliente ti scrive di nuovo dopo che la finestra è scaduta, si apre una nuova finestra di 24 ore e puoi rispondere liberamente di nuovo.
• Impatto su LenoChat — LenoChat invia risposte attraverso il WhatsApp API, quindi si applicano le stesse regole della finestra di 24 ore. Se un agente tenta di rispondere a una conversazione WhatsApp dopo che la finestra è scaduta, il messaggio potrebbe non essere consegnato. Assicurati che gli agenti rispondano tempestivamente alle WhatsApp conversazioni per rimanere entro la finestra di tempo.

Tipi di messaggio supportati

Configurazione del Webhook e dettagli tecnici

L'integrazione WhatsApp di LenoChat utilizza l'infrastruttura webhook di Meta per ricevere messaggi in tempo reale. Il webhook viene configurato automaticamente quando completi il flusso di connessione OAuth — non è necessaria una configurazione manuale del webhook da parte tua. Ecco cosa succede dietro le quinte, per riferimento tecnico.

• Verifica Webhook — quando il webhook viene registrato, Meta invia una richiesta di verifica al server di LenoChat. LenoChat risponde con il token di sfida corretto per confermare che l'endpoint è attivo e di proprietà di LenoChat.
• Consegna dei messaggi — ogni volta che un cliente invia un messaggio al tuo numero WhatsApp connesso, Meta consegna un payload webhook al server di LenoChat. Il payload include il contenuto del messaggio, le informazioni del mittente (numero di telefono e nome visualizzato), l'ID del numero di telefono ricevente e un identificatore unico del messaggio.
• Routing dei messaggi — LenoChat abbina l'ID del numero di telefono ricevente a quello connesso del tuo spazio di lavoro, crea o continua una conversazione nella tua casella di posta e pubblica il messaggio nella discussione. Se Leno AI è abilitato, l'IA elabora prima il messaggio.
• Messaggi in uscita — quando un agente o Leno AI invia una risposta, LenoChat chiama il WhatsApp Business API (Graph API v22.0) per consegnare il messaggio all'app WhatsApp del cliente. La chiamata API utilizza il token di accesso di lunga durata ottenuto durante la connessione OAuth.
• Gestione dei token — durante il flusso OAuth, LenoChat scambia il codice di autorizzazione per un token di breve durata, poi lo aggiorna a un token di lunga durata (valido per circa 60 giorni). LenoChat memorizza questo token in modo sicuro e lo utilizza per tutte le API chiamate per tuo conto.

Scollegare WhatsApp da LenoChat

Se devi disconnettere il tuo numero di WhatsApp da LenoChat — ad esempio, per collegarlo a una piattaforma diversa o per rimuovere completamente l'integrazione — segui questi passaggi.

• Passo 1: Vai su Impostazioni → Integrazioni nella dashboard LenoChat.
• Passo 2: Nella sezione WhatsApp, trova il numero di telefono che vuoi disconnettere.
• Passo 3: Clicca sul pulsante Disconnetti accanto a quel numero.
• Passo 4: Appare una finestra di dialogo di conferma. Clicca su Conferma per procedere con la disconnessione.
• Passo 5: Il numero viene rimosso da LenoChat. I nuovi messaggi in arrivo a quel numero non verranno più inviati nella tua casella di posta LenoChat. La cronologia delle conversazioni esistente per quel numero rimane nella tua casella di posta per riferimento, ma non verranno aggiunti nuovi messaggi.

WhatsApp Migliori Pratiche di Integrazione

Per ottenere il massimo dalla tua integrazione WhatsApp con LenoChat, segui queste pratiche consigliate che aiutano a mantenere la consegnabilità dei messaggi, la soddisfazione del cliente e la conformità alle politiche di Meta.

• Rispondi entro la finestra di 24 ore — rispondi sempre ai WhatsApp messaggi entro 24 ore dall'ultimo messaggio del cliente. Se perdi questa finestra, non puoi inviare ulteriori messaggi a meno che non usi un messaggio template. Leno AI può aiutare rispondendo immediatamente alle domande più comuni.
• Allena Leno AI con la tua base di conoscenze — se Leno AI gestisci WhatsApp conversazioni, assicurati che la tua base di conoscenze sia completa e aggiornata. WhatsApp clienti spesso si aspettano risposte rapide e accurate, e un'IA ben addestrata riduce significativamente i tempi di risposta.
• Usa un numero aziendale dedicato — evita di usare un numero personale per l'integrazione. Un numero registrato dall'azienda costruisce fiducia con i clienti e garantisce che il numero rimanga disponibile anche se i singoli membri del team cambiano.
• Monitora la tua valutazione di qualità WhatsApp Business — Meta assegna una valutazione di qualità (Alta, Media o Bassa) al tuo numero di telefono in base ai feedback dei clienti. Una valutazione di bassa qualità può comportare limiti di messaggistica o restrizioni all'account. Controlla regolarmente la tua valutazione di qualità in Meta Business Manager.
• Imposta gli orari di lavoro — imposta i tuoi orari di LenoChat per inviare messaggi automatici di lontananza quando il tuo team è offline. Questo gestisce le aspettative dei clienti e impedisce loro di aspettare indefinitamente una risposta.
• Completa il tuo profilo WhatsApp Business — compila nome aziendale, descrizione, indirizzo, email e sito web in Meta Business Manager. Un profilo completo appare più professionale e affidabile ai clienti che visualizzano i dati della tua azienda in WhatsApp.

Sicurezza e gestione dei dati

LenoChat gestisce WhatsApp dati con gli stessi standard di sicurezza applicati a tutti gli altri canali. Capire come i tuoi dati fluiscono tra Meta, LenoChat e i tuoi agenti è importante per la conformità e la tranquillità.

• Token OAuth — LenoChat memorizza il token di accesso di lunga durata ottenuto durante il flusso Meta OAuth. Questo gettone concede LenoChat permesso di inviare e ricevere messaggi per tuo conto. Il token viene memorizzato in modo sicuro sui server di LenoChat e non viene mai esposto al codice lato client o allo storage del browser.
• Contenuto dei messaggi — i messaggi vengono trasmessi tra Meta e LenoChat tramite connessioni HTTPS criptate. Il contenuto dei messaggi è memorizzato nel database di LenoChat come parte del thread di conversazione, soggetto alle stesse politiche di conservazione dei dati di tutti gli altri canali.
• Privacy dei numeri di telefono — i numeri dei clienti sono visibili agli agenti nella casella di posta in modo che possano identificare la conversazione. I numeri di telefono non vengono condivisi con terzi né utilizzati per altri scopi diversi dalla trasmissione dei messaggi e dal tracciamento delle conversazioni.
• Revoca dell'accesso — se disconnetti WhatsApp o elimini il tuo LenoChat workspace, il token memorizzato viene invalidato. Puoi anche revocare l'accesso a LenoChat direttamente da Meta Business Manager sotto Impostazioni aziendali → Integrazioni.

WhatsApp vs Altri Canali in LenoChat