Modalità Coesistenza WhatsApp: Guida alla Connessione Passo dopo Passo

Riepilogo

La modalità Coesistenza ti permette di utilizzare la WhatsApp Business mobile app e la WhatsApp Cloud API simultaneamente sullo stesso numero di telefono. Questo significa che puoi continuare a chattare con i clienti direttamente dal tuo telefono sfruttando al contempo le potenti funzionalità API di WhatsTeam come messaggi automatizzati, chatbot, integrazioni CRM e campagne di messaggistica in blocco.

Questa guida ti accompagna attraverso tutto ciò che devi sapere prima di abilitare la Coesistenza, il processo di connessione passo dopo passo, le considerazioni sui prezzi e i suggerimenti per la risoluzione dei problemi.

Informazioni Importanti Prima di Iniziare

La modalità Coesistenza è una funzionalità potente, ma comporta specifici cambiamenti di comportamento e limitazioni che devi comprendere prima di abilitarla. Leggi questa sezione attentamente per evitare problemi imprevisti dopo l'integrazione.


Punti Chiave da Comprendere

• La Coesistenza è attualmente in beta. Meta sta sviluppando attivamente questa funzionalità, il che significa che alcuni comportamenti potrebbero cambiare nel tempo.
• Entrambi i canali condividono lo stesso numero. I messaggi inviati tramite l'app mobile e tramite l'API provengono entrambi dallo stesso numero di telefono. I clienti vedono un singolo thread di conversazione.
• I messaggi API hanno priorità. Quando sia l'app mobile che l'API tentano di rispondere alla stessa conversazione, la risposta dell'API viene consegnata e la risposta dell'app mobile potrebbe essere soppressa.
• Non tutte le funzionalità dell'app mobile vengono preservate. Alcune funzionalità che funzionano sull'app mobile si comporteranno diversamente o diventeranno non disponibili una volta abilitata la Coesistenza.
• La fatturazione si applica ai messaggi API. I messaggi inviati tramite la WhatsApp Cloud API via WhatsTeam sono soggetti ai prezzi basati sulle conversazioni di Meta. I messaggi inviati direttamente dall'app mobile rimangono gratuiti.

Modifiche alle Funzionalità Dopo l'Integrazione

Una volta abilitata la modalità Coesistenza, le seguenti funzionalità sulla WhatsApp Business mobile app saranno interessate:

Modifica e Revoca dei Messaggi

• Modifica: I messaggi inviati dall'app mobile possono ancora essere modificati entro la finestra di modifica standard di 15 minuti di WhatsApp. Tuttavia, i messaggi inviati tramite l'API non possono essere modificati dopo la consegna.
• Revoca (Elimina per Tutti): I messaggi inviati dall'app mobile possono essere revocati come di consueto. I messaggi inviati tramite l'API non possono essere revocati dall'interfaccia dell'app mobile.


Messaggi Effimeri

• Le impostazioni dei messaggi effimeri configurate sull'app mobile si applicheranno alla conversazione. Tuttavia, i messaggi inviati tramite l'API non ereditano automaticamente il timer dei messaggi effimeri.
• Se un cliente abilita i messaggi effimeri dal suo lato, tutti i messaggi nella conversazione (sia app che API) saranno soggetti al timer.

Media a Visualizzazione Singola

• Le foto e i video a visualizzazione singola inviati dall'app mobile funzionano come previsto per il destinatario.
• L'API attualmente non supporta l'invio di media a visualizzazione singola. Qualsiasi media inviato tramite l'API verrà consegnato come media standard (persistente).


Posizione in Tempo Reale

• La condivisione della posizione in tempo reale dall'app mobile ai clienti funziona come previsto.
• L'API non supporta la ricezione o la visualizzazione dei dati di posizione in tempo reale. Se un cliente condivide la sua posizione in tempo reale, sarà visibile sull'app mobile ma non tramite la dashboard API/WhatsTeam.

Liste Broadcast

• Le liste broadcast create sull'app mobile rimangono funzionali.
• Tuttavia, per la messaggistica su larga scala, è fortemente raccomandato usare le funzionalità di campagna di WhatsTeam, poiché forniscono tracciamento della consegna, analytics e gestione dei template.


Requisiti

Prima di abilitare la modalità Coesistenza, assicurati di soddisfare tutti i seguenti requisiti:


1. WhatsApp Business App: Devi utilizzare l'app WhatsApp Business (non l'app WhatsApp consumer standard). L'app deve essere aggiornata all'ultima versione disponibile nello store del tuo dispositivo.

2. Numero di Telefono: Il numero di telefono deve essere attivamente registrato sulla WhatsApp Business app. Non eliminare o deregistrare il numero prima di iniziare questo processo.

3. Meta Business Account: Hai bisogno di un Meta Business Account (precedentemente Facebook Business Manager). Se non ne hai uno, verrà creato durante il processo di Embedded Signup.

4. Account WhatsTeam: Hai bisogno di un account WhatsTeam attivo. Registrati su whats.team se non ne hai uno.

5. Permessi Admin: Devi avere accesso come amministratore al Meta Business Account che sarà associato al WhatsApp Business Account.

6. Disabilita le Risposte Automatiche: Disattiva tutte le risposte automatiche nella WhatsApp Business app (Messaggi d'assenza, Messaggi di benvenuto) per prevenire conflitti con le automazioni API.

7. Connessione Internet Stabile: Sia il tuo telefono (per l'app mobile) che il tuo computer (per il processo di configurazione) necessitano di una connessione internet affidabile.

8. Browser Moderno: Usa Chrome, Firefox o Edge con i popup abilitati per il flusso di accesso Meta.

Guida alla Connessione Passo dopo Passo

Segui attentamente questi 18 passaggi per connettere il tuo numero WhatsApp Business a WhatsTeam usando la modalità Coesistenza.

Passaggio 1: Accedi a WhatsTeam

Apri il browser e vai su whats.team. Accedi con le tue credenziali WhatsTeam. Se non hai un account, creane uno prima.


Passaggio 2: Vai alle Connessioni WhatsApp

Una volta effettuato l'accesso, vai su Impostazioni dal menu di navigazione nella barra laterale sinistra. Poi clicca su Connessioni WhatsApp per visualizzare le tue connessioni attuali e aggiungerne una nuova.

Passaggio 3: Clicca Connetti un Nuovo Numero

Nella pagina Connessioni WhatsApp, clicca il pulsante Connetti un Nuovo Numero. Questo avvierà il flusso di Embedded Signup.


Passaggio 4: Seleziona la Modalità Coesistenza

Quando ti viene chiesto di scegliere un tipo di connessione, seleziona Coesistenza (Beta). Questa opzione permette al tuo numero di rimanere attivo sulla WhatsApp Business mobile app essendo contemporaneamente accessibile tramite l'API.


Passaggio 5: Accesso Facebook

Apparirà una finestra popup di accesso Meta. Inserisci le tue credenziali Facebook e accedi. Se hai l'autenticazione a due fattori abilitata sul tuo account Facebook, completa anche quel passaggio di verifica.

Passaggio 6: Concedi i Permessi

Dopo l'accesso, Meta ti chiederà di concedere i permessi a WhatsTeam. Rivedi attentamente l'elenco dei permessi e assicurati che tutte le caselle siano selezionate:

• Gestire il tuo WhatsApp Business Account
• Gestire i numeri di telefono del tuo WhatsApp Business Account
• Inviare e ricevere messaggi per tuo conto

Clicca Continua per concedere questi permessi.


Passaggio 7: Seleziona o Crea un Portfolio Business

Scegli un Portfolio Meta Business esistente dal menu a tendina, oppure creane uno nuovo cliccando Crea Nuovo. Inserisci il nome della tua attività e i dettagli se stai creando un nuovo portfolio.


Passaggio 8: Crea un WhatsApp Business Account

Seleziona Crea un nuovo WhatsApp Business Account o scegline uno esistente. Se ne crei uno nuovo, fornisci:

• Un nome visualizzato per la tua attività
• La categoria della tua attività
• Una descrizione della tua attività

Passaggio 9: Inserisci il Tuo Numero di Telefono

Inserisci il numero di telefono attualmente attivo sulla tua WhatsApp Business mobile app. Assicurati di includere il prefisso internazionale (es. +1 per gli Stati Uniti, +34 per la Spagna).


Passaggio 10: Verifica la Proprietà

WhatsApp invierà un codice di verifica al tuo numero. Puoi scegliere di riceverlo tramite:

• SMS: Un messaggio di testo con un codice a 6 cifre.
• Chiamata Vocale: Una chiamata automatizzata che legge il codice ad alta voce.

Inserisci il codice nel campo di verifica.

Passaggio 11: Conferma l'Abbinamento Coesistenza

Dopo la verifica, il sistema rileverà che il numero è attivo sulla WhatsApp Business app e confermerà l'abbinamento di Coesistenza. Dovresti vedere un messaggio di conferma che indica che il numero verrà connesso in modalità Coesistenza.


Passaggio 12: Rivedi le Impostazioni di Connessione

Rivedi tutte le impostazioni di connessione prima di finalizzare:

• Nome dell'attività e nome visualizzato
• Numero di telefono
• Modalità di connessione (Coesistenza)
• Portfolio Meta Business associato

Passaggio 13: Accetta Termini e Condizioni

Leggi e accetta i termini di servizio della WhatsApp Business API e i termini della piattaforma WhatsTeam. Questi coprono le politiche di messaggistica, la gestione dei dati e le linee guida d'uso.

Passaggio 14: Finalizza la Configurazione

Clicca il pulsante Completa Configurazione per completare il processo di connessione. Il sistema elaborerà la tua richiesta, il che richiede tipicamente da 30 secondi a 2 minuti.


Passaggio 15: Verifica la Connessione nella Dashboard

Una volta completata la configurazione, verrai reindirizzato alla dashboard WhatsTeam. La tua nuova connessione dovrebbe apparire con stato Connesso e un'etichetta Coesistenza.


Passaggio 16: Invia un Messaggio di Test

Dalla dashboard WhatsTeam, invia un messaggio di test per verificare che la connessione API funzioni:

1. Vai su Messaggistica o Chat.
2. Avvia una nuova conversazione con un numero di test.
3. Invia un semplice messaggio di testo.
4. Verifica che il messaggio venga consegnato e la risposta ricevuta.

Passaggio 17: Verifica che l'App Mobile Funzioni Ancora

Apri la WhatsApp Business app sul tuo telefono e conferma:

• L'app funziona ancora normalmente.
• Puoi ancora inviare e ricevere messaggi.
• Le tue conversazioni esistenti sono intatte.
• Puoi vedere i messaggi inviati tramite l'API (potrebbero apparire con un leggero ritardo).


Passaggio 18: Configura le Automazioni API

Ora che entrambi i canali sono connessi, configura le tue automazioni API in WhatsTeam:

1. Configura i flussi chatbot se desiderato.
2. Configura le regole di risposta automatica (queste sovrascriveranno le risposte automatiche a livello di app).
3. Configura i webhook di notifica per i messaggi in arrivo.
4. Configura le assegnazioni degli agenti del tuo team.


Prezzi

La modalità Coesistenza segue il modello di prezzi standard della WhatsApp Business API con alcune distinzioni importanti:


Messaggi API (Tramite WhatsTeam)

• Conversazioni avviate dall'azienda: Si applicano i prezzi standard di Meta basati sulla categoria della conversazione (Marketing, Utilità, Autenticazione o Servizio).
• Conversazioni avviate dall'utente: Attualmente gratuite per le prime 1.000 conversazioni al mese. Dopodiché si applicano le tariffe standard per conversazione.
• Messaggi template: Devono utilizzare template pre-approvati e vengono fatturati alla tariffa delle conversazioni avviate dall'azienda.

Messaggi dell'App Mobile

• Messaggi diretti dall'app: I messaggi inviati direttamente dalla WhatsApp Business mobile app non comportano addebiti API.
• Avvertenza importante: Se un'automazione API risponde a una conversazione avviata tramite l'app mobile, quella risposta automatizzata verrà fatturata come conversazione API.

Tariffe della Piattaforma WhatsTeam

Le tariffe della piattaforma WhatsTeam vengono addebitate separatamente dai prezzi basati sulle conversazioni di Meta. Visita whats.team/pricing per i dettagli del piano attuale e i volumi di messaggi inclusi.

Risoluzione dei Problemi

Conflitti nelle Risposte Automatiche

Il problema più comune nella modalità Coesistenza è il conflitto tra le risposte automatiche della WhatsApp Business mobile app e le automazioni API di WhatsTeam.


Sintomi

• I clienti ricevono risposte duplicate: una dalla risposta automatica dell'app e una dall'automazione API.
• Le risposte si contraddicono (es. orari di apertura diversi o informazioni diverse).
• Il flusso della conversazione risulta disgiunto per il cliente.

Soluzione

1. Disabilita tutte le risposte automatiche nella WhatsApp Business app:

   • Apri l'app e vai su Impostazioni > Strumenti Business.
   • Disattiva Messaggio d'assenza.
   • Disattiva Messaggio di benvenuto.
   • Rimuovi o disabilita le Risposte rapide che potrebbero essere attivate automaticamente.

2. Centralizza le automazioni in WhatsTeam:

   • Configura tutte le risposte automatizzate tramite la dashboard WhatsTeam.
   • Questo assicura una singola fonte di verità per tutte le interazioni automatizzate.

3. Forma il tuo team:

   • Se i membri del team usano l'app mobile per rispondere manualmente, assicurati che controllino prima la dashboard WhatsTeam per vedere se un'automazione API ha già risposto.
   • Stabilisci protocolli chiari su chi risponde tramite quale canale.

Messaggi che Non Appaiono sull'App Mobile

Se i messaggi inviati tramite l'API non sono visibili sull'app mobile:

• Assicurati che la WhatsApp Business app sia aggiornata all'ultima versione.
• Controlla la connessione internet del telefono.
• Chiudi forzatamente e riapri l'app.
• Attendi fino a 30 secondi, poiché può esserci un breve ritardo di sincronizzazione.

Cadute della Connessione

Se la connessione Coesistenza cade inaspettatamente:

• Controlla la dashboard WhatsTeam per avvisi sullo stato della connessione.
• Verifica di non aver effettuato il logout da WhatsApp Business sul telefono.
• Assicurati che il telefono sia connesso a internet.
• Se il problema persiste, riconnetti tramite la dashboard WhatsTeam senza eliminare il numero dall'app mobile.

Domande Frequenti

1. Perderò la cronologia dei messaggi quando abilito la Coesistenza?

No. La cronologia dei messaggi esistente sulla WhatsApp Business mobile app rimarrà intatta. La modalità Coesistenza non elimina né modifica le tue conversazioni esistenti. Tuttavia, i messaggi inviati tramite l'API prima che la Coesistenza fosse abilitata non appariranno retroattivamente sull'app mobile.


2. Come funziona la finestra di messaggistica di 24 ore nella Coesistenza?

La finestra di messaggistica di 24 ore si applica solo ai messaggi API. Quando un cliente ti invia un messaggio, si apre una finestra di 24 ore durante la quale puoi rispondere liberamente tramite l'API senza utilizzare un template. Dopo la chiusura della finestra, devi utilizzare un messaggio template approvato per riavviare la conversazione tramite l'API. I messaggi inviati direttamente dall'app mobile non sono soggetti a questa restrizione della finestra.

3. Cosa succede alle conversazioni in corso quando abilito la Coesistenza?

Le conversazioni in corso sull'app mobile continuano normalmente. Una volta che la Coesistenza è attiva, i nuovi messaggi in arrivo saranno visibili sia sull'app mobile che nella dashboard WhatsTeam. Puoi scegliere di rispondere da entrambi i canali. Se un'automazione API è configurata, risponderà automaticamente a meno che tu non abbia impostato regole specifiche per impedirlo.

4. I messaggi vengono sincronizzati tra l'app mobile e l'API in tempo reale?

I messaggi vengono sincronizzati con un ritardo molto breve, tipicamente sotto i 5 secondi. I messaggi in arrivo dai clienti appaiono sia sull'app mobile che nella dashboard WhatsTeam quasi simultaneamente. I messaggi in uscita inviati da un canale appariranno sull'altro canale entro pochi secondi. Tuttavia, alcuni metadati (come le conferme di lettura attivate dall'app) potrebbero non propagarsi alla dashboard API.


5. Posso disabilitare la Coesistenza e tornare alla modalità solo app mobile?

Sì. Puoi disconnettere la connessione API dalla dashboard WhatsTeam in qualsiasi momento senza influire sulla tua app mobile. Vai su Impostazioni > Connessioni WhatsApp, seleziona il numero e clicca Disconnetti. La tua WhatsApp Business app continuerà a funzionare normalmente dopo la disconnessione. Nota che tutte le automazioni API, i flussi chatbot e le integrazioni smetteranno di funzionare una volta disconnessi.