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
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
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
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.
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
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
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
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)