Diego × Bitconn × Odoo v19

Quem fala

Diego Ferreira Rodrigues

Diretor Técnico & Desenvolvedor

@diegofrodrigues · Ceará, Nordeste · BR

Bitconn Technology

Do suporte TI N1/N2/N3 a soluções cloud, desenvolvimento open-source e consultoria especializada — Odoo, Chatwoot, Nextcloud e mais.

bit + connected → soluções conectadas para empresas

Mundo do Pinguim

Linux-first em tudo — servidores, desenvolvimento e infra. Defensor do software livre com vivência real em ambientes de produção.

Desenvolvimento

Foco em Python — automações, integrações, módulos Odoo e ferramentas CLI que conectam sistemas empresariais sem overhead desnecessário.

Serviços TI → Cloud

Da triagem e suporte técnico a arquitetura cloud. Docker, Nginx, Ansible — infraestrutura reproduzível e escalável.

Open-Source no Core

Entrega de soluções baseadas em Odoo, Chatwoot, Nextcloud e outras plataformas abertas, customizadas para o contexto real dos clientes.

Stack & ferramentas

Python Odoo Chatwoot REST API WebSocket Linux Docker Nextcloud Nginx PostgreSQL Ansible Bash

Apresentação Técnica · Odoo v19

Automações Nativas
+ bitconn_webhook

Como maximizar o poder de integração do Odoo 19 combinando automações nativas com uma camada de API REST e Webhooks totalmente customizável.

Odoo v19 REST API Webhooks Server Actions n8n / Zapier Chatwoot Open Source · GPL-3

Diego Ferreira Rodrigues · Bitconn Technology

        
        POST /bitconn/webhook/<uuid>
         ·  {"model": "sale.order", "method": "create"}

Roteiro

O que vamos cobrir

Uma jornada das automações nativas até integrações avançadas com APIs externas.

01

Automações Nativas do Odoo v19

Server Actions, Flows, Regras agendadas e de registro

Fundação

02

Limitações das Automações Nativas

Onde o Odoo sozinho não chega

Gap

03

Módulo bitconn_webhook

Visão geral, arquitetura e recursos

Módulo

04

Inbound API REST

Endpoints, autenticação, payloads e exemplos

Inbound

05

Outbound Webhooks

Disparo via Server Actions e payloads avançados

Outbound

06–08

Integrações · n8n, Zapier, Chatwoot & Terminal

Ecossistema completo + WebSocket Terminal integrado

Avançado

01 · Fundação

Automações Nativas do Odoo v19

O Odoo v19 entrega ferramentas de automação low-code/no-code diretamente no core.

⚙️

Automated Actions

Executa lógica Python, muda campos, envia e-mails ao criar, editar ou excluir registros. Gatilhos configuráveis por modelo.

🕐

Ações Agendadas (Cron)

Rotinas periódicas: limpeza de dados, relatórios automáticos, sincronizações. Controle de frequência com interface visual.

📋

Server Actions

Ações personalizadas em Python executadas sob demanda ou por gatilhos. Base para toda a camada de automação customizada.

🔔

Notificações & E-mail

Envio automático de e-mails, mensagens no chatter e notificações push integradas ao fluxo de negócio nativo.

Evento de Registro

→

Regra de Automação

→

Server Action

→

Resultado

02 · Gap

Onde as automações nativas têm limite

Mesmo poderosas, as automações do Odoo sozinhas não cobrem integração com sistemas externos.

Cenário	Odoo Nativo	Com bitconn_webhook
Receber dados de apps externos via HTTP	✗ Sem endpoint público	✓ REST API com UUID
Criar registros via n8n / Zapier / Make	✗ Requer RPC completo	✓ JSON simples + Bearer
Receber eventos do Chatwoot	✗ Sem receptor nativo	✓ Webhook Inbound direto
Enviar payload ao salvar um registro	✗ Apenas e-mail nativo	✓ Outbound Webhook
Filtrar campos nested (M2O/O2M)	✗ Não disponível	✓ Engine de extração avançada
Autenticação simples por Secret Key	✗ Apenas XMLRPC/Sessão	✓ Bearer Token / Webhook-Key

⚡ Conclusão: As automações nativas são a base — o bitconn_webhook é a ponte que conecta o Odoo ao mundo externo.

03 · Módulo

bitconn_webhook

Módulo open-source GPL-3 para Odoo 18/19 com camada completa de integração bidirecional.

📥

Inbound

Endpoint HTTP seguro para receber dados de qualquer sistema externo via JSON

📤

Outbound

Disparo de webhooks HTTP POST a partir de Server Actions com payload avançado

🖥️

Terminal

Terminal WebSocket integrado para debug e testes em tempo real dentro do Odoo

ESTRUTURA DO MÓDULO

📁 bitconn_webhook/
├── controllers/    # Endpoints HTTP
├── models/         # Modelos ORM
├── security/       # Regras de acesso
├── views/          # Interface Odoo
├── static/         # JS Terminal
└── __manifest__.py

STACK TÉCNICA

Python77.4% · ORM nativo Odoo

JavaScript18.9% · Terminal WS

CSS3.7% · UI módulo

LicençaGPL-3.0 · Open Source

04 · Inbound

API REST Inbound

Endpoints seguros para sistemas externos criarem, lerem, editarem e excluírem registros Odoo via JSON.

POST/bitconn/webhook/<uuid> → create / write / unlink / search / read

GET/bitconn/webhook/<uuid>/schema?model=&method=create

GET/bitconn/webhook/<uuid>/required?model=&values=

CRIAR REGISTRO · EXEMPLO

POST /bitconn/webhook/<uuid>
Authorization: Bearer <secret>

{
  "model": "res.partner",
  "method": "create",
  "values": {
    "name": "Cliente X",
    "email": "x@site.com"
  }
}

BUSCA COM CAMPOS NESTED

{
  "model": "sale.order",
  "method": "search",
  "domain": [["state","=","sale"]],
  "fields": ["id","name",{
    "partner_id":["id","name"]
  }]
}

✓ Bearer Token ✓ Webhook-Key header ✓ 401 em acesso inválido ✓ Modelos restritos ✓ M2O / O2M / M2M nested

05 · Outbound

Webhooks Outbound

Dispare chamadas HTTP POST para sistemas externos a partir de Server Actions do Odoo.

Evento Odoo

→

Server Action

→

Engine de Payload

→

HTTP POST

→

App Externo

Configuração no Webhook Form

● URL de destino (HTTPS recomendado)
● Headers customizados em JSON
● Placeholders {{ field_path }}
● Botão "Test" com log visual
● Suporte a relações nested

Exemplo de Payload

{
  "pedido": "{{name}}",
  "cliente": "{{partner_id.name}}",
  "total": "{{amount_total}}",
  "estado": "{{state}}"
}

🔗 Integra com Automated Actions — ao confirmar um pedido, dispara para logística, ERP ou Chatwoot automaticamente.

06–07 · Ecossistema

Integrações & Terminal WebSocket

Compatível com qualquer plataforma — com destaque para Chatwoot, peça central do stack da Bitconn.

PLATAFORMAS COMPATÍVEIS

n8n

Pack JSON incluso no módulo

Zapier

Webhooks HTTP Actions

Chatwoot

Inbound de conversas & contatos

Make

HTTP Module

Sistemas Próprios

Qualquer app com HTTP

E-commerce / ERPs

Sincronização bidirecional

CHATWOOT × ODOO · CASOS DE USO

● Novo contato → cria res.partner no Odoo

● Conversa encerrada → cria lead em crm.lead

● Pedido confirmado → notificação no Chatwoot

● Status de atendimento → atualiza campo customizado

TERMINAL WEBSOCKET

● Roda dentro do Odoo (porta 8765)
● Auth via JWT HMAC-SHA256
● Latência < 20ms vs ~50ms SSE
● Auto-instalação de dependências
● Docker, venv, pip — zero config

# Menu → Bitconn Webhook → Terminal

INFO bitconn_webhook.terminal:

  WebSocket server started

  on 127.0.0.1:8765

bitconn.sh $ ▌

08 · Conclusão

Automação sem fronteiras

As automações nativas do Odoo v19 são a base — o bitconn_webhook é a ponte para o mundo externo.

✓ Odoo como Hub

Centraliza dados e processos. Aceita dados de n8n, Zapier, Chatwoot e qualquer app com HTTP.

✓ Zero Dependência

Apenas ORM nativo do Odoo. Sem libs externas obrigatórias. Fácil de instalar e manter.

✓ Produção-Ready

HTTPS, Bearer Token, rotação de credenciais, restrição de modelos e log de respostas.

✓ Open Source

GPL-3, contribuições abertas. Roadmap: filas async, retry/backoff e allow-lists por campo.

Comece agora

Código aberto no GitHub · Pack n8n incluso · Integração Chatwoot documentada

⭐ github.com/diegofrodrigues/bitconn_webhook