DM Champ Docs

Odoo

Para quem é isto? Empresas que utilizam o Odoo — o catálogo de produtos, o pipeline de CRM, as encomendas de venda — e que pretendem que o seu Agente de IA os utilize diretamente no chat. Se não utiliza o Odoo, pode ignorar esta página.

Utiliza um CRM ou ERP diferente? Qualquer sistema com uma API pode ser ligado: consulte Ligar uma Ferramenta que Não Listamos.

O Odoo é um conjunto de aplicações empresariais: Vendas, CRM, Inventário, Faturação e muitas outras, todas a funcionar numa única base de dados. Ligar o Odoo ao DM Champ permite que o seu Agente de IA realize três tarefas durante uma conversa normal, sem que ninguém precise de 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, stock, descrições, tudo lido em tempo real a partir do Odoo.
  • Encaminhar um lead para a sua equipa de vendas. Quando um cliente demonstra interesse de compra, a IA cria um lead (ou oportunidade) no seu CRM Odoo com um resumo do que o cliente pretende.
  • Informar um cliente sobre o estado da sua encomenda. Estado, artigos, faturação e progresso da entrega das encomendas do próprio cliente.

O que precisa

  • Odoo 14 ou superior: Odoo Online, Odoo.sh ou o seu próprio servidor.
  • Um utilizador do Odoo em nome do qual a IA irá atuar. O que esse utilizador pode ver e fazer no Odoo é o limite do que a IA pode ver e fazer. Um utilizador dedicado com acesso a Vendas, CRM e Inventário é o ideal; não precisa de um administrador.
  • A chave API desse utilizador. No Odoo, clique no nome do utilizador (canto superior direito) → PreferênciasSegurança da ContaNova Chave API. Dê-lhe um nome como “Agente de IA” e copie a chave: o Odoo mostra-a apenas uma vez.

Ligar o Odoo

  1. Na barra lateral esquerda, clique em Definições (ícone de engrenagem).
  2. Na barra lateral de Definições, sob o grupo Integrações, clique em CRM & ERP.
  3. No cartão Odoo, clique em Ligar.
A secção de definições de CRM & ERP com um cartão Disponível que mostra o mosaico do Odoo e um botão Ligar, e uma nota de que funciona com o Odoo 14 ou mais recente utilizando uma chave API de um dos seus utilizadores Odoo

Definições → CRM & ERP antes de ligar: um botão Ligar e o lembrete de que o que o utilizador Odoo ligado pode ver é o que a IA pode ver.

  1. Preencha o endereço do Odoo: o endereço onde inicia sessão, por exemplo https://acme.odoo.com. Pode colar o endereço completo do seu navegador.
  2. A Base de dados é opcional. Deixe em branco e detetaremos automaticamente se o seu servidor tiver apenas uma base de dados. Se o seu servidor tiver várias, ou ocultar a lista, escreva o nome: no Odoo Online, é normalmente a primeira parte do seu endereço (acme para acme.odoo.com).
  3. Preencha o login do utilizador Odoo (o e-mail com que esse utilizador inicia sessão) e a chave API do passo anterior.
  4. Clique em Ligar.
A caixa de diálogo Ligar Odoo com campos para endereço do Odoo, Base de dados, login do utilizador Odoo e chave API, cada um com uma dica por baixo, e botões Cancelar e Ligar

Tudo o que a ligação necessita, num único ecrã: o endereço onde inicia sessão, a base de dados (opcional), o utilizador Odoo em nome do qual a IA irá atuar e a chave API desse utilizador.

Verificação de Credenciais

Nada é guardado até que o Odoo confirme. Quando clica em Ligar, verificamos se o endereço é realmente um servidor Odoo, iniciamos sessão com o login e a chave API nessa base de dados e lemos o que o utilizador pode aceder nas aplicações de Produtos, CRM, Vendas e Inventário. Um endereço, base de dados, login ou chave incorretos, ou um utilizador sem acesso, são recusados imediatamente, com o motivo apresentado no ecrã.

Quando funciona, o cartão ligado mostra a empresa e a versão do Odoo, a base de dados à qual a IA está ligada e o utilizador em nome do qual atua.

A sua chave API é armazenada de forma encriptada e nunca mais é mostrada — nem a si, nem à sua equipa. Perdeu-a? Crie uma nova chave no Odoo e ligue novamente.

O que a IA pode fazer

O cartão ligado tem três interruptores. Os três estão ativos após a ligação; desative o que não pretende que a IA utilize:

  • Resposta a partir do catálogo de produtos — nomes de produtos, preços, impostos, stock e descrições.
  • Criar leads no CRM — novas leads ou oportunidades a partir de conversas.
  • Consultar as encomendas de um cliente — estado da encomenda e da entrega.

Estas definições aplicam-se a todos os agentes que tenham o Odoo ativado. Se o utilizador ligado não conseguiu aceder a uma das aplicações quando efetuou a ligação (por exemplo, se o Inventário não estiver instalado), o cartão indicará isso mesmo abaixo desse interruptor.

Pausar ou desligar

  • Pausar impede que qualquer agente utilize o Odoo, mantendo a ligação configurada. Ativar volta a ligá-lo.
  • Desligar remove a ligação completamente. As leads que a IA já criou permanecem no Odoo. Pode voltar a ligar mais tarde com os mesmos detalhes.

Ativar o Odoo para um Agente de IA

Ligar o Odoo não altera o que a sua IA faz por enquanto. Ative-o por agente:

  1. Clique em Agentes de IA na barra lateral e abra o Agente.
  2. Aceda ao passo Capacidades da IA e desloque-se até ao cartão Odoo. O cartão só aparece depois de o Odoo estar ligado.
  3. Ative Utilizar o Odoo nas conversas deste agente. A gravação é imediata.

O cartão lista o que este agente pode agora fazer, com base nos interruptores em Definições → CRM & ERP. Um agente de suporte e um agente de vendas na mesma conta podem diferir: ative-o para aquele que deve utilizar 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 stock ou “vendem X”, a IA pesquisa no seu catálogo Odoo antes de responder. Analisa os produtos marcados como Pode ser Vendido no Odoo, correspondendo ao nome do produto, à referência interna e ao código de barras, e responde com o preço e a moeda, se o imposto está incluído, o nível de stock para produtos armazenáveis e a descrição de vendas. Se não houver correspondência, pede ao cliente outro nome ou um código de produto em vez de adivinhar.

Leads

Quando um cliente demonstra interesse real de compra — pede um orçamento, quer ser contactado, quer encomendar algo que a IA não consegue concluir no chat, pede uma demonstração — a IA recolhe o que a sua equipa de vendas necessita (o quê exatamente, quantidade, quando, orçamento se for oferecido, nome e e-mail) e cria um registo no seu CRM Odoo:

  • Uma lead se o seu CRM utilizar a fase de Leads (CRM → Configuração → Definições → Leads), caso contrário, uma oportunidade no seu pipeline.
  • O número de telefone, e-mail e nome do cliente são retirados do contacto em DM Champ, e o registo é associado ao cliente correspondente no Odoo, quando este existe.
  • Se esse cliente já tiver uma lead ou oportunidade aberta, a IA adiciona o novo pedido como uma nota, em vez de criar um duplicado.

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

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

Estado da Encomenda

Quando um cliente pergunta onde está a sua encomenda, o que encomendou ou se já foi enviada, a IA procura as suas encomendas no Odoo e responde com a referência da encomenda, o estado (orçamento, confirmado, concluído ou cancelado), a data, o total, os artigos, a faturação e o progresso da entrega com um número de seguimento, caso a sua transportadora o forneça.

A IA mostra ao cliente apenas as suas próprias encomendas:

  • No WhatsApp, SMS e outros canais telefónicos, as encomendas são associadas ao número a partir do qual o cliente está a escrever (e ao e-mail no seu contacto, se existir).
  • No chat do seu site, onde a identidade de ninguém é verificada, a IA solicita tanto a referência da encomenda como o endereço de e-mail com o qual a encomenda foi feita, e mostra a encomenda apenas quando ambos coincidem.

Não existe forma de a IA listar encomendas de outras pessoas ou procurar uma encomenda apenas pela referência.


É bom saber

  • Um Odoo por conta. Se gere várias empresas em bases de dados Odoo separadas, ligue aquela que o seu Agente deve utilizar.
  • O utilizador Odoo é o limite. A IA vê exatamente o que esse utilizador consegue ver. Dê ao utilizador acesso às aplicações de Vendas, CRM e Inventário no Odoo, e nada que a IA não deva tocar.
  • O Odoo permanece a fonte de verdade. Nada do Odoo é copiado para o DM Champ; cada resposta lê o Odoo em tempo real nesse momento.
  • Os números de telefone são correspondidos de forma flexível. Um cliente cujo número está guardado no Odoo como 06 12 34 56 78 é encontrado mesmo quando escreve a partir de +31 6 12345678.
  • Odoo inacessível? A IA pede desculpa, responde ao que pode a partir da sua base de conhecimento e alerta a sua equipa se o cliente precisar de uma resposta imediata.

Próximos Passos

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