Receita de integração

Integração do WhatsApp com Odoo, sem a Business API

Via API REST + webhooks; automações do Odoo ou middlewareÚltima verificação: agosto de 2026

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

A chamada HTTP a partir de uma automação do 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."
}

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

Perguntas frequentes

O Odoo tem integração nativa com o WhatsApp?

Sim, um conector oficial baseado na WhatsApp Business API, com aprovação de modelos e tarifas da Meta por mensagem. Esta receita é o outro caminho: o seu número atual pelo Spun, conectado ao Odoo por HTTP, sem modelos nem tarifas por mensagem.

O Odoo consegue enviar mensagens de WhatsApp sem a Business API?

Sim: uma regra de automação ou uma ação de servidor do Odoo (ou Zapier/Make/n8n no meio) chama o endpoint send-message do Spun, e a mensagem sai do número de WhatsApp que você já usa.

Conversas do WhatsApp podem criar leads no Odoo?

Sim: os webhooks de saída do Spun disparam em mensagens recebidas, contatos novos ou etiquetas atribuídas, e o seu middleware ou um webhook de entrada do Odoo os transforma em registros crm.lead. Filtrar por etiqueta mantém o lixo fora do pipeline.

Com quais versões do Odoo isso funciona?

Com qualquer versão que consiga fazer uma chamada HTTP de saída a partir de uma automação (as ações de servidor fazem isso há anos; o Odoo 17+ adiciona webhooks nativos), e com qualquer versão se você fizer a ponte pelo Zapier, Make ou n8n.

O lado do WhatsApp, resolvido

O Spun opera o WhatsApp da sua equipe no número que você já tem: caixa de entrada compartilhada, respostas com IA, difusões e a API que esta receita usa. Preço fixo a partir de R$249 por mês, com teste grátis.

Comece grátis: 7 dias com tudo incluído

Ver todas as integrações