WhatsApp Coexistence API — la guida completa

Odoo Community, on-premise. Odoo Online (SaaS) non accetta moduli di terze parti. L'istanza deve essere raggiungibile da internet in HTTPS, perché Meta consegna i messaggi in entrata a un webhook sul tuo dominio. Non serve nulla di Enterprise: né l'app WhatsApp nativa, né un abbonamento Enterprise. Funziona anche su Enterprise, ma è pensato per Community.

Una connessione WABA API non ha bisogno di un Tech Provider: basta la tua app da sviluppatore Meta, e nulla transita dalla RC Studio.

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

Cosa ottieni

• Coexistence, oppure connessione WABA API. Colleghi il numero della tua app WhatsApp Business con un QR code, o una connessione WABA API con la tua app Meta. Più numeri in un solo database, ciascuno con i suoi operatori e le sue aziende.
• Una casella di posta fatta per rispondere. Ricerca, filtri non letti, miei e chiusi, selettore per numero, aggiornamenti in tempo reale, spunte di consegna, media, risposte citate, reazioni, assegnazione, e i messaggi che il tuo team manda dal telefono rispecchiati nello stesso thread.
• Documenti da qualsiasi scheda. Un'azione Invia con WhatsApp su contatti, preventivi, fatture, consegne, lead, attività, eventi, appuntamenti, ordini d'acquisto e ordini del punto vendita. Il modello si riempie dalla scheda e il report PDF viaggia come intestazione del documento.
• Modelli sincronizzati con Meta. Intestazione, corpo, piè di pagina e pulsanti come li definisce Meta. Ogni segnaposto è collegato a un campo della scheda, a un valore fisso, a un valore chiesto al momento dell'invio o al link del portale. Una libreria di esempi per le app che hai installato.
• Invii automatici. Un'azione server Invia modello WhatsApp che puoi far partire da qualsiasi regola di automazione.
• Ruoli, opt-out, nuovi tentativi. Gli operatori vedono solo i numeri a cui sono assegnati. Un cliente che risponde STOP finisce in lista nera. Gli invii falliti vengono ritentati, e ogni messaggio conserva il suo stato Meta e il codice di errore. Non viene mai cancellato nulla.

Un giro in cinque schermate

Più numeri in una sola casella, l'icona che li distingue, il filtro per numero e un modello inviato da un preventivo.

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 il Login Configuration ID 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.

Installare il modulo

• Assicurati che i pacchetti Python phonenumbers e requests siano disponibili per Odoo. Entrambi fanno parte del requirements.txt di Odoo, quindi un'installazione standard li ha già; Odoo si rifiuta di installare il modulo se mancano (un modulo Odoo non può lanciare pip al posto tuo). Se serve, installali nell'ambiente in cui gira Odoo e riavvia Odoo.
• Scompatta il modulo nella tua cartella addons e riavvia il servizio Odoo.
• Impostazioni → App → Aggiorna elenco app, cerca «WhatsApp» e installa WhatsApp Coexistence API.
• Dai ai tuoi utenti il permesso WhatsApp / Operatore o Responsabile.

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.

Le tre schermate 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 con un nuovo QR code.

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 il Login Configuration ID te li consegna quel fornitore. RC Studio non può ottenerli e non è responsabile se il fornitore non li fornisce.

• Scegli Coexistence e La tua app Meta Tech Provider.
• Compila App ID, App Secret e Login Configuration ID della tua app.
• 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.

Modalità C · Connessione WABA API

Non serve alcun Tech Provider. Nella tua app da sviluppatore Meta con il prodotto WhatsApp, copia App ID, App Secret, WhatsApp Business Account ID, Phone Number ID e un Access Token permanente (un token da utente di sistema con i permessi WhatsApp) nel numero, scegli Connessione WABA API (Cloud API) e premi Prova la connessione.

Webhook

Ogni numero ha la sua Callback URL e il suo Verify Token nella scheda Webhook. In modalità coexistence Odoo li registra presso Meta come parte del collegamento del numero. Con una connessione WABA API, premi Iscrivi webhook per lasciare che sia Odoo a registrarli sul WhatsApp Business Account, oppure incollali a mano nell'app Meta sotto WhatsApp → Configurazione → Webhooks e iscriviti ai campi messages e message_template_status_update. Le consegne vengono verificate con la firma di Meta (il tuo App Secret) oppure, in modalità licenza, con l'URL segreto che conoscono solo Meta e il tuo Odoo.

Modelli

Premi Sincronizza modelli su un numero collegato per importare i modelli approvati su Meta, oppure Carica modelli di esempio per ottenere bozze per le app che hai installato (preventivo inviato, ordine confermato, fattura disponibile, consegna in arrivo, iscrizione a un evento, promemoria appuntamento, ricevuta, ordine d'acquisto, follow-up di lead e attività). Rivedi una bozza, collega i suoi segnaposto nella scheda Segnaposto e premi Invia a Meta; Odoo scopre l'esito della revisione tramite il webhook.

Ruoli

La casella di posta

WhatsApp → Casella di posta. Le conversazioni a sinistra, attività più recente in cima, con un campo di ricerca, i filtri Tutte / Non lette / Mie / Chiuse e, quando c'è più di un numero, un selettore. Il thread è a destra: rispondi con testo, emoji e allegati, cita un messaggio e guarda le spunte di consegna.

Se non scrivi nulla, il pulsante Invia diventa un microfono: premilo per registrare una nota vocale; il cliente la riceve come messaggio vocale, con l'icona del microfono e la tua foto profilo, riprodotta direttamente dalla bolla e non come file da scaricare. L'unica cosa che nessun invio via API può aggiungere è la forma d'onda, che la calcola solo il telefono che registra. Chrome, Edge e Firefox non hanno bisogno di nulla; su Safari il server deve avere ffmpeg. Le note vocali che manda il cliente si riproducono nel thread.

I nuovi messaggi arrivano in tempo reale; l'icona di WhatsApp nella barra in alto mostra quante conversazioni sono in attesa. Assegna a me e Chiudi tengono la lista pulita; il contatto e i documenti da cui è stato scritto al cliente sono a un clic.

Una conversazione per cliente e per numero

Tutto quello che un cliente scrive e tutto quello che gli mandi — dalla casella di posta, da un preventivo o da un'automazione — arriva nello stesso thread di quel numero aziendale. Il contatto viene riconosciuto dal numero di telefono; se il cliente scrive a due dei tuoi numeri, quelli sono due thread apposta, distinti dall'icona del numero. In modalità coexistence, le risposte che il tuo team manda dal telefono compaiono nel thread con l'indicazione «dal telefono».

Più numeri, una sola casella

Dai a ogni numero aziendale un'icona nella sua scheda. L'icona compare come distintivo su ogni conversazione di quel numero, così un thread commerciale e uno di assistenza con lo stesso cliente si distinguono a colpo d'occhio. Il selettore in cima alla lista mostra tutti i numeri o uno solo, e gli operatori vedono solo i numeri su cui sono elencati.

Inviare un documento

Su un contatto, un preventivo, una fattura, una consegna, un lead, un'attività, un'iscrizione a un evento, un appuntamento, un ordine d'acquisto o una ricevuta, apri il menu Azione e scegli Invia con WhatsApp; la stessa scorciatoia sta accanto a ogni campo telefono. Scegli il numero e il modello, compila i valori che il modello chiede, controlla l'anteprima e invia. Il report PDF del modello parte come documento, e nel chatter della scheda resta una nota con il link alla conversazione. Da una vista elenco, seleziona più schede e la stessa azione le manda tutte.

Invii automatici

In Impostazioni → Tecnico → Regole di automazione, aggiungi un'azione di tipo Invia modello WhatsApp e scegli il modello. Ogni scheda che soddisfa la regola riceve il suo messaggio, riempito dalla scheda, senza che nessuno clicchi.

La finestra di 24 ore e l'opt-out

Ventiquattro ore dopo l'ultimo messaggio del cliente, WhatsApp consente solo i modelli approvati. Il campo di scrittura lo segnala e propone Invia un modello, che riapre la conversazione. Se un cliente risponde STOP, UNSUBSCRIBE o BAJA (l'elenco lo modifichi tu nelle Impostazioni), il numero finisce in lista nera e non gli viene più inviato nulla finché non lo togli.

Stati e nuovi tentativi

WhatsApp → Registro messaggi conserva ogni messaggio con il suo stato: in coda, inviato, consegnato, letto o fallito, con il codice di errore di Meta quando c'è. I fallimenti temporanei vengono ritentati da un cron ogni cinque minuti; quelli definitivi si possono rimandare dall'elenco. I messaggi non vengono mai cancellati: il registro e le conversazioni sono la tua cronologia.

Domande frequenti

Devo essere un Tech Provider di Meta? Solo per la coexistence. L'Embedded Signup di Meta per l'app WhatsApp Business funziona tramite un'app Tech Provider approvata per WhatsApp Business App Onboarding. Puoi usare l'app di RC Studio con una chiave di licenza, registrarti tu stesso come Tech Provider, oppure passare da un altro fornitore che ti consegni App ID, App Secret e Login Configuration. Una connessione WABA API non ha bisogno di nulla di tutto questo: basta la tua app da sviluppatore Meta.

Funziona su Odoo Online (SaaS) o su Odoo.sh? Odoo Online non accetta moduli di terze parti, quindi no. Questo modulo è pensato per Odoo Community on-premise. Dipende solo da moduli Community, quindi si installa anche su un progetto Odoo.sh; il supporto a Odoo.sh però non rientra in quello che testiamo.

Il telefono continua a funzionare dopo il collegamento? Sì, è proprio questo che significa coexistence. Il numero resta attivo nell'app WhatsApp Business; Odoo riceve tutto tramite la Cloud API e può anche inviare. I messaggi mandati dal telefono vengono rispecchiati in Odoo.

Dove vivono le conversazioni? C'entra Discussioni? Nei modelli di conversazione e messaggio propri del modulo, mostrati nella sua casella di posta. Discussioni non viene usato per i thread di WhatsApp.

I miei dati passano dalla RC Studio? No. In tutte e tre le modalità i messaggi viaggiano direttamente tra Meta e il tuo Odoo. Con una licenza RC Studio, il nostro servizio interviene solo quando si collega un numero: scambia l'autorizzazione di Meta con il token di accesso, lo consegna al tuo Odoo e registra presso Meta l'indirizzo del tuo Odoo come destinazione delle consegne. Da lì in poi Meta consegna ogni messaggio direttamente alla tua istanza, e l'invio parte dal tuo Odoo verso Meta con il tuo token. RC Studio non riceve né conserva il contenuto dei messaggi; tiene solo una copia criptata del token e i dati di connessione del numero finché non lo scolleghi.

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 (quelle che il tuo team scrive nella casella di posta), alla stessa tariffa dei messaggi di utility e autenticazione di quel paese; fino ad allora sono gratuite. Ricevere messaggi resta gratuito. Le tariffe esatte sono sulla pagina dei prezzi di Meta. RC Studio non fa pagare per messaggio.

Posso inviare un PDF? Una posizione? Una nota audio? Dalla casella di posta, dentro la finestra di 24 ore: testo, immagini, video, audio, documenti e risposte citate. Da una scheda: un modello la cui intestazione documento è il report PDF della scheda, oppure un file fisso. Posizioni, adesivi, reazioni e biglietti da visita vengono ricevuti e mostrati; in uscita una posizione è possibile solo come intestazione di un modello.

Più numeri, più aziende? Sì. Ogni numero aziendale ha i suoi operatori e le sue aziende autorizzate, i suoi modelli e le sue conversazioni. Gli operatori vedono solo i numeri su cui sono elencati.

Quali versioni di Odoo sono supportate, e in che lingue parla l'interfaccia? Odoo Community 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.

Il supporto è incluso? Sì, per chiunque acquisti il modulo. I bug si correggono senza costi; le nuove funzionalità e la configurazione lato Meta si preventivano a parte.

Supporto

Il supporto è incluso per chiunque acquisti il modulo. L'installazione, la configurazione lato Meta e la licenza Tech Provider di RC Studio 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).