O Odoo tem o próprio conector de WhatsApp, mas ele funciona sobre a Business API: número dedicado, aprovação de modelos e tarifas da Meta por mensagem. Se a sua empresa já trabalha com um número de WhatsApp comum, existe um segundo caminho: o Spun se conecta a esse número por QR code, e a API REST e os webhooks de saída dele se conectam ao Odoo do jeito que o Odoo gosta de conversar, por HTTP.
As regras de automação e as ações de servidor do Odoo podem chamar endpoints externos diretamente (e o Odoo 17 e versões posteriores têm webhooks nativos), então em muitos fluxos você nem precisa de middleware; Zapier, Make ou n8n continuam sendo a opção low-code.
1. Avisos de pedido, fatura e entrega no WhatsApp
Objetivo: um evento do Odoo, pedido confirmado, fatura lançada, entrega agendada, vira uma mensagem de WhatsApp enviada do seu número real.
- 1
Crie uma chave de API do Spun
No Spun: “Configurações”, depois “Webhooks”, depois “Gerenciar Chaves da API”, depois “Nova Chave”, com escopo para enviar mensagens. Guarde a chave wap_ nos parâmetros do sistema do Odoo ou nas credenciais do seu middleware, nunca escrita diretamente em uma ação.
- 2
Dispare no evento do Odoo
Use uma regra de automação no modelo que interessa (mudança de estado de sale.order, account.move lançado) com uma ação de servidor ou um webhook que faça a chamada HTTP, ou passe o mesmo gatilho pelo Zapier/Make/n8n se preferir não escrever código no Odoo.
- 3
Chame o send-message
Faça um POST em /api/integrations/send-message com o número do cliente tirado do registro e o texto da sua mensagem. Se o canal de WhatsApp ficar offline por um momento, a mensagem entra na fila e é enviada na reconexão.
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."
}Rode antes o check-phone (até 20 números por chamada) nas listas de clientes importadas, para que as automações nunca disparem para números sem WhatsApp.
2. Leads do WhatsApp no Odoo CRM
- 1
Assine os eventos do Spun
“Configurações”, depois “Webhooks”, depois “Adicionar Webhook”, apontando para o seu middleware (ou para um webhook de entrada do Odoo 17+ que uma ação de servidor processa). Selecione etiqueta atribuída, contato criado ou mensagem recebida.
- 2
Filtre por uma etiqueta
Deixe os agentes marcarem os prospects reais com uma etiqueta “Novo lead” no Spun; só esses eventos criam registros crm.lead, e o pipeline fica limpo.
- 3
Crie o lead
Mapeie o telefone, o nome e o texto da mensagem para o novo lead. Coloque o id do chat do WhatsApp em um campo personalizado, para que automações futuras possam fazer referência à conversa.
O que saber antes de montar
- Isto não é um módulo da loja de aplicativos do Odoo: a autenticação é uma chave de API fixa em uma chamada HTTP, e as assinaturas de webhook do Spun são criadas na tela “Configurações” do Spun.
- Em comparação com o conector do próprio Odoo: aquele é oficial e baseado em modelos, com tarifas da Meta; este usa o seu número atual, sem modelos, sem custo por mensagem e com grupos de WhatsApp completos. Escolha pela restrição que pesa mais para você.
- Limite de requisições: 60 requisições à API por minuto por chave; agrupe as verificações de números, até 20 por chamada.
Relacionado: WhatsApp + Zapier e Make (formatos de payload e a API completa) · WhatsApp + Google Sheets (registro nativo)