Guida di configurazione

Integrazione WhatsApp con Odoo, senza la Business API

Tramite REST API + webhook; automazioni Odoo o middlewareUltima verifica: agosto 2026

Odoo ha un connettore WhatsApp proprio, ma si appoggia alla Business API: numero dedicato, approvazione dei template, costi Meta per messaggio. Se la tua attività vive già su un normale numero WhatsApp, c’è una seconda strada: Spun si collega a quel numero con un codice QR, e la REST API e i webhook in uscita di Spun si collegano a Odoo nel modo in cui Odoo preferisce comunicare, via HTTP.

Le regole di automazione e le azioni server di Odoo possono chiamare direttamente endpoint esterni (e da Odoo 17 in poi i webhook sono una funzionalità nativa), quindi per molti flussi non ti serve nemmeno un middleware; Zapier, Make o n8n restano l’opzione low-code.

1. Aggiornamenti su ordini, fatture e consegne su WhatsApp

Obiettivo: un evento di Odoo, ordine confermato, fattura registrata, consegna programmata, diventa un messaggio WhatsApp dal tuo numero reale.

  1. 1

    Crea una chiave API di Spun

    In Spun: “Impostazioni”, poi “Webhook”, poi “Gestisci Chiavi API”, poi “Nuova chiave”, con l’ambito per inviare messaggi. Conserva la chiave wap_ nei “Parametri di sistema” di Odoo o nelle credenziali del tuo middleware, mai scritta direttamente in un’azione.

  2. 2

    Attivala sull’evento di Odoo

    Usa una regola di automazione sul modello che ti interessa (cambio di stato di sale.order, account.move registrato) con un’azione server o un webhook che esegue la chiamata HTTP, oppure fai passare lo stesso trigger da Zapier/Make/n8n se preferisci non scrivere codice in Odoo.

  3. 3

    Chiama send-message

    POST /api/integrations/send-message con il numero del cliente preso dal record e il testo del tuo messaggio. Se il canale WhatsApp è offline per poco, il messaggio va in coda e parte alla riconnessione.

La chiamata HTTP da un’automazione Odoo
POST https://api.spun.com/api/integrations/send-message
Authorization: Bearer wap_YOUR_KEY
Content-Type: application/json

{
  "to": "9715512345678",
  "text": "Your order S00042 is confirmed. We'll message you here when it ships."
}

Esegui prima check-phone (fino a 20 numeri per chiamata) sugli elenchi di clienti importati, così le automazioni non partono mai verso numeri senza WhatsApp.

2. Lead WhatsApp nel CRM di Odoo

  1. 1

    Iscriviti agli eventi di Spun

    “Impostazioni”, poi “Webhook”, poi “Aggiungi webhook”, puntato al tuo middleware (o a un webhook in entrata di Odoo 17+ elaborato da un’azione server). Seleziona etichetta assegnata, contatto creato o messaggio in entrata.

  2. 2

    Filtra con un’etichetta

    Lascia che gli agenti segnino i potenziali clienti reali con un’etichetta “Nuovo lead” in Spun; solo quegli eventi creano record crm.lead, così la pipeline resta pulita.

  3. 3

    Crea il lead

    Mappa telefono, nome e testo del messaggio nel nuovo lead. Aggiungi l’id della chat WhatsApp in un campo personalizzato, così le automazioni future possono fare riferimento alla conversazione.

Cosa sapere prima di costruire

  • Non è un modulo dell’app store di Odoo: l’autenticazione è una chiave API statica in una chiamata HTTP, e le sottoscrizioni ai webhook di Spun si creano nelle Impostazioni di Spun.
  • Rispetto al connettore di Odoo: quello è ufficiale e basato su template, con costi Meta; questo è il tuo numero esistente, senza template, senza costi per messaggio e con i gruppi WhatsApp completi. Scegli in base al vincolo che ti pesa di più.
  • Limite di frequenza: 60 richieste API al minuto per chiave; raggruppa le verifiche dei numeri fino a 20 per chiamata.

Vedi anche: WhatsApp + Zapier e Make (forme dei payload e API completa) · WhatsApp + Google Sheets (registrazione nativa)

Domande frequenti

Odoo ha un’integrazione WhatsApp nativa?

Sì, un connettore ufficiale costruito sulla WhatsApp Business API, con approvazione dei template e costi Meta per messaggio. Questa ricetta è l’altra strada: il tuo numero esistente tramite Spun, collegato a Odoo via HTTP, senza template né costi per messaggio.

Odoo può inviare messaggi WhatsApp senza la Business API?

Sì: una regola di automazione o un’azione server di Odoo (oppure Zapier/Make/n8n nel mezzo) chiama l’endpoint send-message di Spun, e il messaggio parte dal numero WhatsApp che usi già.

Le conversazioni WhatsApp possono creare lead in Odoo?

Sì: i webhook in uscita di Spun scattano su messaggi in entrata, nuovi contatti o etichette assegnate, e il tuo middleware o un webhook in entrata di Odoo li trasforma in record crm.lead. Il filtro con le etichette tiene la spazzatura fuori dalla pipeline.

Con quali versioni di Odoo funziona?

Con qualsiasi versione in grado di fare una chiamata HTTP in uscita da un’automazione (le azioni server lo fanno da anni; Odoo 17+ aggiunge i webhook nativi), e con qualsiasi versione in assoluto se fai da ponte con Zapier, Make o n8n.

Il lato WhatsApp, già risolto

Spun gestisce il WhatsApp del tuo team sul numero che hai già: casella condivisa, risposte IA, invii broadcast e la API usata da questa ricetta. Prezzo fisso da €45 al mese, prova gratuita.

Inizia gratis: 7 giorni con tutto incluso

Vedi tutte le integrazioni