# 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](connecting-other-tools.md). 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ências** → **Segurança da Conta** → **Nova 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**. ::: master-only
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.

::: 4. 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. 5. 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`). 6. Preencha o **login do utilizador Odoo** (o e-mail com que esse utilizador inicia sessão) e a **chave API** do passo anterior. 7. Clique em **Ligar**. ::: master-only
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](../ai-agents/ai-agents.md) — configure o Agente que utilizará o Odoo. - [Base de Conhecimento](../ai-automation/faq-management.md) — 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](connecting-other-tools.md) — para qualquer aspeto relacionado com o Odoo que as três capacidades acima não cubram (funções personalizadas, webhooks, a API).