Coexistence for WhatsApp — la guida completa

Richiede Odoo Enterprise 17, 18, 19 o 20. Estende l'app WhatsApp nativa di Odoo, che esiste solo in Enterprise, quindi non si installa su Odoo Community. Odoo.sh e on-premise; non disponibile su Odoo Online. L'istanza deve essere raggiungibile da internet in HTTPS, perché Meta consegna i messaggi in entrata a un webhook sul tuo dominio.

Tieni il tuo numero sul telefono. Aggiungi Odoo sopra.

La strada normale verso la WhatsApp Cloud API ti chiede di rinunciare al tuo numero: una volta migrato, smette di funzionare nell'app WhatsApp Business del telefono. Per un'azienda che ha tutta la storia commerciale dentro quell'app, è un ostacolo insormontabile.

La Coexistence è la risposta ufficiale di Meta, e questo modulo la porta su Odoo. Scansioni un QR code e da quel momento lo stesso numero funziona in entrambi i posti contemporaneamente: i tuoi collaboratori continuano a rispondere dal telefono, e Odoo vede tutto.

Come funziona

• I messaggi che il tuo team scrive dal telefono compaiono in Odoo come messaggi in uscita nel thread del cliente, così la cronologia della conversazione è completa.
• I messaggi che mandano i clienti arrivano in Odoo tramite il webhook, esattamente come con un numero Cloud API dedicato.
• Anche Odoo può inviare: risposte dentro la finestra di 24 ore e modelli approvati.
• I tuoi contatti e fino a sei mesi di cronologia si possono importare una volta sola, al collegamento, con la sincronizzazione una tantum di Meta.

Cosa ottieni

• Il numero resta sul telefono. Il tuo team continua a rispondere dall'app WhatsApp Business. Non viene migrato nulla.
• Collegamento con QR code. L'Embedded Signup di Meta dentro Odoo. Niente SMS, niente numero nuovo, nessun identificativo da scrivere a mano.
• Le risposte dal telefono rispecchiate in Odoo. Gli echi in uscita arrivano nello stesso thread, deduplicati per id del messaggio, quindi nulla compare due volte.
• Tutto in Discussioni. Entrata e uscita in normali canali Discussioni, su normali contatti.
• Import della cronologia una tantum. Contatti e fino a sei mesi di conversazioni, importati al collegamento.
• Zero configurazione del webhook. L'account genera da sé la Callback URL e il Verify Token e si iscrive da solo.
• Più numeri, un solo database. Ogni numero è un account a sé, con i suoi utenti e la sua restrizione per azienda.
• Sette lingue. Inglese, spagnolo, portoghese, italiano, francese, tedesco e arabo.

Un giro in tre schermate

Requisiti

Due modi per avere il diritto di usare la Coexistence

La Coexistence di WhatsApp si attiva tramite l'Embedded Signup di Meta, che funziona solo attraverso un'app registrata presso Meta come Tech Provider e approvata per la funzionalità WhatsApp Business App Onboarding. Una semplice app da sviluppatore Meta non può farlo. Ci sono due modi per soddisfare questo requisito:

Con una licenza RC Studio. Compri una chiave di licenza, la incolli in Odoo e ti colleghi scansionando un QR code. Niente da registrare presso Meta, nessuna revisione dell'app, nessun dominio da dichiarare. La licenza è fatturata a parte rispetto a questo modulo e non è compresa nel suo acquisto.

Con la tua app Tech Provider, o quella di terzi. Questo modulo funziona con qualsiasi di esse. Inserisci l'App ID, l'App Secret e la Login Configuration che ti dà il tuo fornitore, e la connessione passa dalla sua app Meta invece che da quella di RC Studio. Quelle credenziali le emette quel fornitore, non RC Studio. RC Studio non può ottenerle per te e non è responsabile se il tuo fornitore non te le consegna, le revoca, te le fa pagare a parte o non è stato approvato da Meta per la funzionalità WhatsApp Business App Onboarding. Verifica con il tuo fornitore che riceverai un App ID, un App Secret e una Login Configuration di coexistence prima di acquistare questo modulo.

Modalità A · Coexistence con licenza RC Studio (consigliata)

Tutta la configurazione è: incolla la chiave, premi Connetti, scansiona il QR. Niente da registrare presso Meta, nessuna revisione dell'app e nessun dominio da dichiarare, perché la finestra di Facebook gira sulla pagina di RC Studio.

I tre passaggi che vedi davvero, in modalità licenza

Meta consente una sola sincronizzazione dei contatti e una sola della cronologia per ogni collegamento. Se falliscono, l'unico modo per rifarle è scollegare il numero e ricollegarlo.

Modalità B · Coexistence con la tua app Tech Provider

Funziona con la tua app o con quella di qualsiasi altro fornitore. In entrambi i casi l'app deve essere approvata da Meta per la funzionalità WhatsApp Business App Onboarding, e l'App ID, l'App Secret e la Login Configuration te li consegna quel fornitore. RC Studio non può ottenerli e non è responsabile se il fornitore non li fornisce.

• Lascia vuota la licenza RC Studio.
• Compila App ID e App Secret della tua app.
• Compila Meta Login Configuration con l'identificativo della tua configurazione «Facebook Login for Business».
• Aggiungi il tuo dominio Odoo all'app Meta, in App domains e Allowed domains for the JavaScript SDK. Questo passaggio non ha API e va fatto a mano per ogni dominio.
• Premi Connetti con Coexistence e prosegui con il QR.

In modalità B non c'è la finestra di RC Studio: la finestra di Facebook si apre direttamente dalla tua pagina Odoo, sulla tua app.

Webhook

Non c'è nulla da incollare in Meta, in nessuna delle due modalità. L'account genera la propria Callback URL e il proprio Webhook Verify Token e li registra presso Meta come parte del collegamento del numero, iscrivendosi al campo messages e a smb_message_echoes. Se l'URL del tuo Odoo dovesse cambiare, il pulsante Reiscrivi webhook nel modulo account indica a Meta quello nuovo, e Rimuovi override del webhook annulla l'operazione.

Ruoli

Dove vivono le conversazioni

In Discussioni, esattamente dove le mette l'app WhatsApp di Odoo: un canale per cliente sul numero che ha ricevuto il messaggio. Rispondi da Discussioni con allegati, emoji, citazioni e reazioni. Questo modulo cambia il modo in cui si collega il numero, non il posto in cui rispondi.

Un elenco di conversazioni con ricerca, filtro non letti e selettore per numero non fa parte di questo modulo. Arriva da WhatsApp: Single Thread and Inbox, venduto e installato a parte; WhatsApp: Account Icon on Threads aggiunge l'icona colorata per numero. La Coexistence funziona senza nessuno dei due.

Rispondere da Discussioni

Le stesse conversazioni compaiono in Discussioni, sotto la categoria WhatsApp — comodo per chi vive già in Discussioni e preferisce non cambiare schermata. Quando un collega risponde dal telefono, la Coexistence rispecchia quel messaggio nello stesso canale come messaggio in uscita.

Inviare un modello da un documento

Ogni preventivo, fattura, documento di trasporto e contatto ha un pulsante WhatsApp nel chatter. Scegli il modello, controlla l'anteprima con i dati già sostituiti e invia. Il messaggio resta nel chatter del documento e nel thread del cliente.

Invii automatici

Impostazioni → Tecnico → Azioni server → Nuovo, tipo Invia WhatsApp, scegli il modello. Falla partire da una regola di automazione — alla conferma di un ordine, per esempio — oppure dal menu azioni di una vista elenco per inviare a molte schede in una volta.

Stati e nuovi tentativi

WhatsApp → Messaggi conserva ogni messaggio con il suo stato: in coda, inviato, consegnato, letto, risposto, errore o respinto, con il codice di errore di Meta quando c'è. Quelli falliti si possono rimandare selezionandoli ed eseguendo WhatsApp: rimanda messaggi falliti. Un cron ritenta la coda ogni ora.

La finestra di 24 ore e l'opt-out

Ventiquattro ore dopo l'ultimo messaggio del cliente, WhatsApp consente solo i modelli. Il campo di scrittura si blocca e propone un pulsante per riaprire la conversazione con un modello. Se un cliente risponde STOP, UNSUBSCRIBE o STOP PROMOTIONS, Odoo mette il numero in lista nera e smette di inviargli messaggi. Sono le parole che riconosce l'app WhatsApp di Odoo.

Domande frequenti

Devo per forza usare RC Studio come Tech Provider? No. Hai tre possibilità e il modulo le supporta tutte. Uno: usare la tua app — ti registri presso Meta, la fai approvare per la funzionalità WhatsApp Business App Onboarding e diventi tu stesso Tech Provider. Due: passare da un qualsiasi Tech Provider terzo; il modulo funziona con tutti. Tre: usare il servizio Tech Provider di RC Studio, fatturato a parte rispetto a questo modulo. Quello che conta nei casi uno e due è che il fornitore deve consegnarti un App ID, un App Secret e una Login Configuration di coexistence. Senza questi tre valori l'Embedded Signup non può partire. RC Studio non può ottenerli per te e non è responsabile se un fornitore terzo li rifiuta, li revoca o li fa pagare a parte.

Funziona su Odoo Online (SaaS)? No. Odoo Online non accetta moduli di terze parti. Enterprise gira su Odoo.sh e on-premise. La tua istanza deve essere raggiungibile in HTTPS pubblico, perché Meta consegna i messaggi a un webhook sul tuo dominio.

Posso continuare a usare il numero sul telefono? Sì — è proprio il senso della Coexistence. Lo stesso numero vive nell'app WhatsApp Business e nella Cloud API allo stesso tempo. Il tuo team continua a rispondere dal telefono e Odoo vede tutto: i messaggi in entrata e le risposte scritte dal telefono, che arrivano come echi e compaiono nel thread come messaggi in uscita. Con la modalità Cloud API dedicata, il numero smette di funzionare sul telefono.

Perdo la cronologia quando mi collego? Con la Coexistence, Meta ti lascia importare i contatti e fino a sei mesi di cronologia una volta sola, durante il collegamento. Meta consente una sola sincronizzazione dei contatti e una della cronologia per collegamento; se falliscono, l'unico modo per rifarle è scollegare il numero e ricollegarlo.

C'è qualche limite da sapere prima di comprare? Sì, ed è di Meta, non del modulo. I messaggi che il tuo team scrive dal telefono partono così come sono e non possono essere intercettati né riscritti; l'API li riceve dopo, come echi. Se devi controllare il 100% del traffico in uscita, la scelta giusta è la Cloud API dedicata, non la Coexistence. L'app Meta ha inoltre una quota oraria di chiamate: se si esaurisce bisogna aspettare, e riprovare subito non fa che allungare l'attesa.

Quanto fa pagare Meta per i messaggi? Meta fattura per messaggio consegnato. I messaggi da modello sono tariffati in base alla categoria (marketing, utility, autenticazione) e al paese del cliente. Dal 1º ottobre 2026 Meta fattura anche le risposte libere inviate dentro la finestra di 24 ore (i messaggi di servizio), alla stessa tariffa dei messaggi di utility e autenticazione; fino ad allora sono gratuite. Ricevere messaggi resta gratuito. I dettagli e i listini sono sulla pagina dei prezzi di Meta. RC Studio non fa pagare per messaggio.

Il modulo manda i miei dati a un server della RC Studio? Solo al collegamento, e solo il minimo. I messaggi non passano mai da noi, né quelli che invii né quelli che ricevi. Il token commerciale vive nel tuo database, quindi il tuo Odoo parla direttamente con Meta, e quando si collega il numero il nostro servizio registra presso Meta l'indirizzo del tuo Odoo come destinazione delle consegne: Meta consegna direttamente alla tua istanza, su un URL segreto che conoscono solo Meta e il tuo Odoo. Il nostro servizio non espone nemmeno un endpoint per inviare o ricevere messaggi. Quello che passa da noi è il collegamento: l'app secret di Meta è nostro e non viene mai copiato nel tuo database, quindi siamo noi a scambiare l'autorizzazione di Meta con il tuo token di accesso e a consegnartelo. Tutto qui. Se preferisci che RC Studio non partecipi nemmeno al collegamento, il modulo funziona esattamente uguale con la tua app Meta.

Quali dati conserva RC Studio? Tre cose, e solo finché il numero è collegato: l'app secret di Meta (lo teniamo noi proprio perché non debba mai essere copiato nel tuo database), la chiave di licenza che ti emettiamo e una copia criptata del tuo token WABA, necessaria per reiscrivere il webhook quando cambia l'URL del tuo Odoo e per lanciare la sincronizzazione iniziale. Quando ci chiedi di scollegare il numero, l'iscrizione della nostra app viene rimossa dalla tua WABA e l'intero record viene cancellato, token criptato compreso. Puoi anche togliere tu stesso l'override del webhook in qualsiasi momento, con il pulsante Rimuovi override del webhook nel modulo account. Il tuo token commerciale resta inoltre nel tuo Odoo, ed è questo che rende l'invio dei messaggi diretto e indipendente dal nostro servizio.

Il nostro numero e la nostra WABA restano sotto il nostro Business Portfolio? Sì, sempre. Il numero e la WABA sono tuoi e restano nel tuo Business Portfolio. Un Tech Provider fa solo da ponte tra la tua WABA e i servizi di Meta; non prende mai possesso di nulla. Anche Meta Business Suite continua a funzionare normalmente — la Coexistence affianca la Cloud API agli strumenti di Meta, non li sostituisce.

Possiamo provare prima in staging e poi passare in produzione? Sì, ed è l'ordine consigliato. Sul telefono non c'è alcuna interruzione. Lato Odoo, il passaggio in produzione cambia l'URL della tua istanza e con esso l'indirizzo dove Meta consegna gli eventi, quindi la licenza va rinnovata e il webhook reiscritto al nuovo URL — il modulo ha un pulsante apposta. Per i pochi minuti che serve, Odoo smette di inviare e ricevere; il telefono no. Nota che l'import una tantum della cronologia non si ripete quando sposti il numero.

Posso usare modelli già approvati in Meta? Sì. Usa il pulsante Sincronizza modelli nel modulo account.

E se Meta rifiuta la sincronizzazione con l'errore 133010? Vuol dire che il numero non è stato collegato come coexistence. Il pulsante Diagnostica numero nel modulo account lo verifica con una sola chiamata e ti dice se la connessione va rifatta.

Quali versioni di Odoo sono supportate, e in che lingue parla l'interfaccia? Odoo 17.0, 18.0, 19.0 e 20.0 — ogni versione si acquista separatamente sullo store di Odoo. L'interfaccia è disponibile in inglese, spagnolo, portoghese, italiano, francese, tedesco e arabo.

Supporto

Il supporto è incluso per chiunque acquisti il modulo. L'installazione e la configurazione lato Meta si possono contrattare a parte. Usa la pagina di supporto di questo modulo su Odoo Apps per tutto ciò che riguarda il tuo acquisto: arriva direttamente a noi e tiene lo scambio agganciato alla tua licenza.

Transito dei dati: i messaggi e i file viaggiano direttamente tra la tua istanza Odoo e la Cloud API di Meta, qualunque sia la modalità di connessione. Con una licenza RC Studio, il servizio Tech Provider di RC Studio interviene solo quando si collega il numero: emette il token di accesso di Meta e registra l'indirizzo del tuo Odoo come destinazione delle consegne. RC Studio non riceve né conserva il contenuto dei messaggi. Informativa sulla privacy.

WhatsApp è un marchio di Meta Platforms, Inc. RC Studio non è affiliata a Meta, né approvata o sponsorizzata da Meta. Questo modulo è pubblicato sotto la Odoo Proprietary License v1.0 (OPL-1).