
# 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](connecting-other-tools.md).

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 <span data-t="appName">DM Champ</span> 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ências** → **Segurança da Conta** → **Nova 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**.

::: master-only
<figure><img src="../.gitbook/assets/v2-settings-odoo.png" alt="A seção de configurações de CRM &amp; 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"><figcaption><p>Settings → CRM &amp; 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.</p></figcaption></figure>
:::

4. 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.
5. **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`).
6. 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.
7. Clique em **Conectar**.

::: master-only
<figure><img src="../.gitbook/assets/v2-odoo-connect-modal.png" alt="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"><figcaption><p>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.</p></figcaption></figure>
:::

### 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 <span data-t="appName">DM Champ</span>, 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 <span data-t="appName">DM Champ</span>; 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](../ai-agents/ai-agents.md) — configure o Agente que usará o Odoo.
- [Base de Conhecimento](../ai-automation/faq-management.md) — 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](connecting-other-tools.md) — para qualquer coisa relacionada ao Odoo que as três habilidades acima não cubram (funções personalizadas, webhooks, a API).
