DM Champ Docs

Odoo

Para quem é isto? Empresas que utilizam o Odoo — o catálogo de produtos, o pipeline de CRM, pedidos de venda — e desejam que seu Agente de IA os utilize diretamente no chat. Se você não usa o Odoo, pode pular esta página.

Usa um CRM ou ERP diferente? Qualquer sistema com uma API ainda pode ser conectado: veja Conectando uma Ferramenta que Não Listamos.

Odoo é um conjunto de aplicativos de negócios: Vendas, CRM, Estoque, Faturamento e muitos outros, todos operando em um único banco de dados. Conectar o Odoo ao DM Champ permite que seu Agente de IA faça três coisas dentro de uma conversa normal, sem que ninguém precise criar um webhook ou uma função personalizada:

  • Responder a perguntas sobre produtos do seu catálogo. Nomes, preços com a moeda e impostos corretos, estoque, descrições, tudo lido em tempo real do Odoo.
  • Encaminhar um lead para sua equipe de vendas. Quando um cliente demonstra interesse de compra, a IA cria um lead (ou oportunidade) no seu CRM do Odoo com um resumo do que ele deseja.
  • Informar ao cliente onde está o pedido dele. Status, itens, faturamento e progresso da entrega para os pedidos do próprio cliente.

O que você precisa

  • Odoo 14 ou mais recente: Odoo Online, Odoo.sh ou seu próprio servidor.
  • Um usuário do Odoo pelo qual a IA agirá. O que esse usuário pode ver e fazer no Odoo é o limite do que a IA pode ver e fazer. Um usuário dedicado com acesso a Vendas, CRM e Estoque funciona melhor; você não precisa de um administrador.
  • A chave de API desse usuário. No Odoo, clique no nome do usuário (canto superior direito) → PreferênciasSegurança da ContaNova Chave de API. Dê um nome como “Agente de IA” e copie a chave: o Odoo a exibe apenas uma vez.

Conectando o Odoo

  1. Na barra lateral esquerda, clique em Settings (ícone de engrenagem).
  2. Na barra lateral de Settings, sob o grupo Integrations, clique em CRM & ERP.
  3. No cartão Odoo, clique em Connect.
A seção de configurações de CRM & ERP com um cartão Disponível mostrando o bloco do Odoo e um botão Conectar, e uma nota de que funciona com o Odoo 14 ou mais recente usando uma chave de API de um dos seus usuários do Odoo

Settings → CRM & ERP antes de conectar: um botão Conectar e o lembrete de que o que o usuário conectado do Odoo pode ver é o que a IA pode ver.

  1. Preencha o endereço do Odoo: o endereço onde você faz login, por exemplo https://acme.odoo.com. Colar o endereço completo do seu navegador é suficiente.
  2. Banco de dados é opcional. Deixe vazio e nós o detectaremos quando seu servidor tiver um único banco de dados. Se o seu servidor tiver vários, ou ocultar a lista, digite o nome: no Odoo Online, geralmente é a primeira parte do seu endereço (acme para acme.odoo.com).
  3. Preencha o login do usuário do Odoo (o e-mail com o qual o usuário faz login) e a chave de API da etapa acima.
  4. Clique em Conectar.
A caixa de diálogo Conectar Odoo com campos para endereço do Odoo, Banco de dados, login do usuário do Odoo e chave de API, cada um com uma dica abaixo, e botões Cancelar e Conectar

Tudo o que a conexão precisa, em uma tela: o endereço onde você faz login, o banco de dados (opcional), o usuário do Odoo pelo qual a IA agirá e a chave de API desse usuário.

Verificação de Credenciais

Nada é salvo até que o Odoo confirme. Quando você clica em Conectar, verificamos se o endereço é realmente um servidor Odoo, fazemos login com o usuário e a chave de API nesse banco de dados e lemos o que o usuário pode acessar nos aplicativos de Produtos, CRM, Vendas e Estoque. Um endereço incorreto, um banco de dados incorreto, um login ou chave incorretos, ou um usuário sem acesso é recusado imediatamente, com o motivo exibido na tela.

Quando funciona, o cartão conectado mostra a empresa e a versão do Odoo, a qual banco de dados a IA está conectada e por qual usuário ela age.

Sua chave de API é armazenada criptografada e nunca mais é exibida — nem para você, nem para sua equipe. Perdeu? Crie uma nova chave no Odoo e conecte novamente.

O que a IA pode fazer

O cartão conectado possui três interruptores. Todos os três ficam ativados após a conexão; desative o que você não deseja que a IA acesse:

  • Resposta do catálogo de produtos — nomes de produtos, preços, impostos, estoque e descrições.
  • Criar leads no CRM — novos leads ou oportunidades a partir de conversas.
  • Consultar os pedidos do próprio cliente — status do pedido e da entrega.

Isso se aplica a cada agente que tem o Odoo ativado. Se o usuário conectado não conseguiu acessar um dos aplicativos quando você se conectou (por exemplo, o Inventário não está instalado), o cartão informará isso abaixo desse botão.

Pausando ou desconectando

  • Pausar impede que qualquer agente use o Odoo, mantendo a conexão configurada. Ativar liga novamente.
  • Desconectar remove a conexão completamente. Os leads que a IA já criou permanecem no Odoo. Você pode se conectar novamente mais tarde com os mesmos detalhes.

Ativando o Odoo para um Agente de IA

Conectar o Odoo ainda não altera o que sua IA faz. Ative por agente:

  1. Clique em Agentes de IA na barra lateral e abra o Agente.
  2. Vá para a etapa Habilidades de IA e role até o cartão Odoo. O cartão só aparece quando o Odoo está conectado.
  3. Ative Usar o Odoo nas conversas deste agente. Isso é salvo imediatamente.

O cartão lista o que este agente agora pode fazer, com base nas chaves sob Settings → CRM & ERP. Um agente de suporte e um agente de vendas na mesma conta podem ser diferentes: ative para aquele que deve usar o Odoo.


O que a IA pode fazer

Perguntas sobre Produtos

Quando um cliente pergunta sobre um produto, um preço, se algo está em estoque ou “vocês vendem X”, a IA pesquisa em seu catálogo do Odoo antes de responder. Ela analisa produtos marcados como Pode ser Vendido no Odoo, correspondendo ao nome do produto, referência interna e código de barras, e responde com o preço e a moeda, se o imposto está incluído, o nível de estoque para produtos estocáveis e a descrição de vendas. Se nada corresponder, ela solicita ao cliente outro nome ou código de produto em vez de adivinhar.

Leads

Quando um cliente demonstra real interesse de compra — pede um orçamento, quer ser chamado, quer pedir algo que a IA não pode concluir no chat, pede uma demonstração — a IA coleta o que sua equipe de vendas precisa (o que exatamente, quantos, quando, orçamento se oferecido, nome e e-mail) e cria um registro em seu CRM do Odoo:

  • Um lead se o seu CRM usa o estágio de Leads (CRM → Configuração → Configurações → Leads), caso contrário, uma oportunidade em seu pipeline.
  • O número de telefone, e-mail e nome do cliente são obtidos do contato em DM Champ, e o registro é vinculado ao cliente correspondente no Odoo, quando existir.
  • Se esse cliente já tiver um lead ou oportunidade em aberto, a IA adiciona a nova solicitação como uma nota nele, em vez de criar uma duplicata.

O registro carrega um título como “Orçamento para 20 cadeiras de escritório” e um resumo escrito para sua equipe, além de uma nota com o canal de onde a conversa veio.

Testar um agente no playground nunca cria nada no Odoo: a IA informa o que teria criado.

Status do Pedido

Quando um cliente pergunta onde está o seu pedido, o que ele pediu ou se ele já foi enviado, a IA consulta os pedidos dele no Odoo e responde com a referência do pedido, status (cotação, confirmado, concluído ou cancelado), data, total, itens, faturamento e progresso da entrega com um número de rastreamento, quando fornecido pela sua transportadora.

A IA só mostra ao cliente os seus próprios pedidos:

  • No WhatsApp, SMS e outros canais de telefone, os pedidos são correspondidos ao número de onde o cliente está escrevendo (e ao e-mail em seu contato, se houver um).
  • No chat do seu site, onde a identidade de ninguém é verificada, a IA solicita tanto a referência do pedido quanto o endereço de e-mail com o qual o pedido foi feito, e mostra o pedido apenas quando ambos correspondem.

Não há como a IA listar pedidos de outras pessoas ou pesquisar um pedido apenas pela referência.


É bom saber

  • Um Odoo por conta. Se você gerencia várias empresas em bancos de dados Odoo separados, conecte aquele que seu Agente deve usar.
  • O usuário do Odoo é o limite. A IA vê exatamente o que aquele usuário pode ver. Dê ao usuário acesso aos aplicativos de Vendas, CRM e Inventário no Odoo, e nada que a IA não deva acessar.
  • O Odoo permanece como a fonte da verdade. Nada do Odoo é copiado para o DM Champ; cada resposta lê o Odoo ao vivo naquele momento.
  • Números de telefone são correspondidos de forma flexível. Um cliente cujo número está salvo no Odoo como 06 12 34 56 78 ainda é encontrado quando ele escreve de +31 6 12345678.
  • Odoo inacessível? A IA pede desculpas, responde o que pode a partir da sua base de conhecimento e alerta sua equipe se o cliente precisar de uma resposta imediatamente.

Próximos passos

  • Agentes de IA — configure o Agente que usará o Odoo.
  • Base de Conhecimento — adicione suas políticas, prazos de entrega e regras de devolução para que a IA também possa responder sobre o catálogo.
  • Conectando uma Ferramenta que Não Listamos — para qualquer coisa relacionada ao Odoo que as três habilidades acima não cubram (funções personalizadas, webhooks, a API).