> ## Documentation Index > Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt > Use this file to discover all available pages before exploring further. # Odoo > Como conectar seu ERP Odoo a um agente do ChatNorris para sincronizar leads com o CRM, consultar pedidos verificados, responder preço e estoque em tempo real, montar a compra com links da sua loja e criar e consultar tickets do Helpdesk. # Odoo Com a integração do Odoo, seu agente do ChatNorris trabalha com os dados reais do seu ERP **Odoo** (self-hosted, Odoo.sh ou Online). Conforme o que você ativar e os módulos que a sua instância tiver, o agente: * cria um contato e uma oportunidade no seu CRM do Odoo para cada lead novo que confirma; * informa o status de um pedido de venda, só depois de verificar que ele é do visitante; * procura produtos e variantes e responde o preço de venda e o estoque do momento; * monta com o visitante uma lista de compra e envia o link de cada produto na sua loja; * cria tickets no seu Helpdesk do Odoo, com confirmação do visitante, e consulta o status deles de forma verificada. Funciona no widget web, WhatsApp, Instagram, Messenger, Telegram, Email e na API. ## Requisitos * Uma conta do ChatNorris no plano **Premium**. O Odoo é exclusivo do Premium: no Free ou no Standard ele não aparece como conectável e a Ação aparece bloqueada como "Em breve" no seletor. Você pode ver os planos em [chatnorris.ai/pricing](https://chatnorris.ai/pricing) ou escrever para [**hola@chatnorris.ai**](mailto:hola@chatnorris.ai). * Pelo menos um agente criado no ChatNorris. Se você ainda não tem um, siga [Criar um agente](https://docs.chatnorris.ai/pt/guias/crear-agente-wizard.md). * Uma instância do Odoo (self-hosted, Odoo.sh ou Online), um usuário do Odoo e uma API key desse usuário. * Os módulos do Odoo de que cada recurso precisa (veja [Configurar a Ação](#configurar-a-ação)). * Função **Owner** ou **Admin** na sua organização do ChatNorris. > [!TIP] > > Se o seu Odoo não tem API disponível (por exemplo, o Odoo Online no plano Standard), você ainda pode importar os produtos e preços a partir do site público da sua loja com a fonte [Loja on-line (site público)](https://docs.chatnorris.ai/pt/guias/knowledge-base.md#loja-on-line-site-público), sem conectar nenhuma API. ## Conectar o Odoo Cada agente se conecta a uma instância do Odoo. A conexão é feita uma única vez em **Integrações** e é usada pela Ação Odoo. **1. Gere uma API key no Odoo** No Odoo, com o usuário que o ChatNorris vai usar, abra **Preferências → Segurança da conta → Nova chave de API** e copie a chave. **2. Abra o hub de Integrações do agente** No ChatNorris, entre em `Agentes → [seu agente] → Integrações` e escolha **Odoo**. **3. Preencha os dados e conecte** Informe a **URL da instância** (por exemplo `https://sua-empresa.odoo.com`), o **Banco de dados** (opcional: é detectado automaticamente se o seu servidor tiver apenas um), o **Usuário** e a **API key**, e clique em **Conectar**. **4. Teste a conexão** Use **Testar conexão** para confirmar que as credenciais funcionam. No detalhe da integração, **Detectado na última conexão/teste** mostra a edição (Enterprise ou Community), a versão e os módulos relevantes instalados no seu Odoo. A API key é salva criptografada: no hub só aparecem os últimos 4 caracteres. Se você trocá-la no Odoo, use **Substituir chave** no menu **···** da linha; a conexão continua sendo a mesma, então a Ação não é afetada. > [!TIP] > > Se você instalar um módulo no Odoo depois de conectar, clique novamente em **Testar conexão** para que o ChatNorris o detecte e habilite o recurso que precisa dele. ## Configurar a Ação Conectar o Odoo ainda não ativa nada. Para escolher o que o agente faz: **1. Crie a Ação Odoo** Entre em `Agentes → [seu agente] → Ações`, clique em **Nova ação** e escolha **Odoo**. **2. Ative os recursos disponíveis** Os recursos que você pode habilitar dependem dos módulos do Odoo instalados na sua instância (detectados automaticamente ao conectar). Veja a tabela abaixo. **3. Habilite a Ação e salve** Ative **Ação habilitada**: enquanto ela estiver desativada, nenhum recurso tem efeito. Salve as alterações. | Recurso | O que faz | Requer no Odoo | | - | - | - | | **Sincronizar leads com o Odoo CRM** | Sempre que um visitante confirma seus dados de contato pela primeira vez, um contato e uma oportunidade são criados automaticamente no seu CRM do Odoo. | Módulo CRM | | **Consultar status do pedido** | O visitante consulta o status de um pedido de venda informando o número do pedido e o email ou telefone da compra. No widget web, ele faz isso com o mesmo formulário incorporado do WooCommerce. | Módulo de Vendas | | **Consultar estoque e preço** | O agente procura produtos e variantes no seu Odoo e responde com o preço de venda e o estoque do momento, nunca com dados da base de conhecimento. | Módulo de Vendas (`sale`) | | **Montar compra** | O agente monta com o visitante uma lista de produtos da sua loja e, quando ele quer comprar, envia o link de cada produto. Não cria pedidos nem faz cobranças: o total final, o frete e o pagamento ficam por conta da sua loja. Requer ativar primeiro **Consultar estoque e preço**. | Módulo de loja on-line (`website_sale`) | | **Criar ticket de suporte** | O agente pode criar um ticket de suporte no seu Helpdesk do Odoo, só depois que o visitante confirmar explicitamente. | Módulo Helpdesk (Enterprise ou a versão da comunidade, `helpdesk_mgmt`) | | **Consultar status do ticket** | O agente pode informar o status de um ticket já criado por ele mesmo, depois de verificar a identidade do solicitante. | Módulo Helpdesk | Se a sua instância não tiver o módulo correspondente instalado, esse recurso aparece desabilitado. > [!WARNING] > > **Recomenda-se Claude Sonnet ou superior** como modelo principal do agente (**Configurações → IA**) se você ativar a consulta de pedidos ou os tickets. Esses recursos pedem confirmação explícita antes de criar um ticket ou revelar dados de um pedido ou ticket verificado. Em testes, o Haiku às vezes ignora a confirmação e responde como se o ticket já tivesse sido criado. O formulário da ação mostra esse aviso com um link para a configuração de IA. > [!NOTE] > > **Uma única loja por agente.** Um agente pode ter apenas uma loja ativa para consultar pedidos e estoque (por exemplo, Odoo ou [WooCommerce](https://docs.chatnorris.ai/pt/guias/woocommerce.md)). Se você tentar habilitar uma segunda, o ChatNorris pede que você desative primeiro a consulta de pedidos e de estoque da outra. O Odoo pode continuar ativo para leads e tickets junto com uma loja WooCommerce. ### Sincronizar leads com o Odoo CRM Quando o agente confirma um lead novo na conversa, também são criados um contato e uma oportunidade no seu CRM do Odoo (`crm.lead`). É automático: não depende do que o visitante disser. > [!NOTE] > > A sincronização de leads acontece uma única vez, no momento em que o visitante confirma seus dados pela primeira vez — se mais tarde ele completar dados adicionais (por exemplo, adicionar o telefone), esses dados não são sincronizados novamente de forma automática. ### Consultar status do pedido O visitante consulta o status de um pedido de venda informando o número do pedido e o email ou o telefone que usou na compra. O agente responde com o status do pedido, o total e os produtos. No **widget web**, quando o agente detecta que o visitante quer saber o status de um pedido, ele mostra um **formulário incorporado** dentro do chat com dois campos — **Número do pedido** e **Email ou telefone da compra**. O formulário e a resposta aparecem no idioma do widget (espanhol, inglês ou português), e ele é o mesmo para WooCommerce e Odoo. Enquanto o formulário estiver pendente, o visitante não pode escrever outra mensagem até preenchê-lo ou cancelá-lo. No **WhatsApp** e no **Instagram** (onde não há formulários incorporados), o agente pede esses mesmos dados de forma conversacional. Para proteger os dados dos seus clientes: * se os dados não corresponderem, o agente informa que não conseguiu verificar o pedido e pede que o visitante revise o número e o dado de contato — nunca mostra informações sem verificação; * um pedido que não existe e um dado que não corresponde recebem a mesma resposta, para que ninguém consiga adivinhar números de pedido; * depois de 5 tentativas com falha na mesma conversa, a consulta de pedidos é bloqueada. ### Consultar estoque e preço O agente procura produtos e variantes no seu Odoo e responde com o preço de venda e o estoque do momento. Ele consulta o Odoo toda vez que vai falar do preço ou do estoque de um produto, mesmo que já o tenha consultado antes na conversa: nunca responde com dados da base de conhecimento. Se o visitante pedir uma recomendação sem citar um produto ("o que você recomenda para 5 pessoas?"), o agente consulta o catálogo em tempo real e propõe uma ou duas opções concretas com o preço, evitando as que estão esgotadas. Com esse recurso ativo, a lista de fontes da **Base de conhecimento** também mostra a linha informativa **Catálogo do Odoo ao vivo**, com a etiqueta **Ao vivo** e o link **Ver ação**. Não é uma fonte: indica que o agente consulta preço e estoque direto no seu Odoo em cada conversa, então não ocupa caracteres nem precisa ser sincronizada. ### Montar compra Com **Montar compra** ativo, quando o visitante quer comprar, ele recebe um bloco 🛒 com cada linha (quantidade × produto = valor), um 🔗 link para a página de cada produto na sua loja e um **Total ≈** de referência, sem frete. Antes de enviá-lo, o agente revisa a lista: remove os produtos que não são mais vendidos, atualiza os preços e avisa sobre os que estão sem estoque. Se um produto não tiver página na sua loja, o agente indica ao visitante que o procure pelo nome. O ChatNorris não cria pedidos nem faz cobranças: o total final, o frete e o pagamento ficam por conta da sua loja. As mudanças no carrinho ficam registradas como [notas internas](https://docs.chatnorris.ai/pt/guias/conversaciones.md#notas-internas-do-carrinho) na conversa. > [!NOTE] > > Um agente usa uma loja via API ou via site público, não as duas. Se ele já tiver a Ação Odoo com consulta de pedidos, estoque ou compra ativa, o painel da fonte [Loja on-line (site público)](https://docs.chatnorris.ai/pt/guias/knowledge-base.md#loja-on-line-site-público) avisa você e leva você para **Ações**. ### Criar ticket de suporte O visitante pode pedir ajuda e, depois de confirmar, um ticket é criado no Helpdesk do Odoo (o oficial do Enterprise ou o da comunidade OCA, conforme o que estiver instalado na sua instância). Antes de criá-lo, o agente reúne o assunto, a descrição, o nome e o email do visitante, mostra um resumo e espera um "sim" explícito. * **Equipe de destino:** escolha a qual equipe do Helpdesk os tickets novos são atribuídos. Com **Automático (primeira equipe disponível)**, é usada a primeira equipe que o seu Odoo retornar. * **Quando criar um ticket:** instruções para o agente sobre quando oferecer suporte via ticket. Vem com um texto padrão que você pode editar; **Restaurar texto padrão** o recupera. As ações de tickets (Odoo, Zendesk e Freshdesk) seguem uma regra fixa, acima do que você escrever em **Quando criar um ticket**: * Se o visitante descrever um problema ou fizer uma pergunta **sem pedir um ticket**, o agente responde com a base de conhecimento. Se não conseguir resolver, ou se o visitante disser que a resposta não ajudou, ele oferece a criação do ticket. * Se o visitante **pedir um ticket diretamente**, o agente primeiro oferece ajuda (com a resposta, se a tiver, ou perguntando o que está acontecendo) e pergunta se ele ainda prefere o ticket. * O ticket é iniciado se o visitante insistir, se o agente já tentou e não tinha a informação, ou se a resposta não ajudou. Durante um fluxo de ticket, o agente não oferece o Lead Form nem a transferência para uma pessoa, para não confundir o visitante. E, se o visitante pedir para abrir um ticket ou um chamado de suporte, o agente usa esta ação em vez de transferir para uma pessoa com o [Human Handoff](https://docs.chatnorris.ai/pt/guias/chat-en-vivo-handoff.md). > [!WARNING] > > Os tickets são criados de verdade no seu Odoo, inclusive pelo Playground. Se o agente tiver esse recurso ativo, antes da primeira mensagem no Playground você verá o aviso **Este teste pode criar dados reais** com **Continuar** e **Cancelar**. ### Consultar status do ticket O visitante pode consultar o status de um ticket já criado por este agente, informando o número do ticket e o email que usou ao criá-lo. O agente só informa tickets que ele mesmo criou, e não qualquer ticket do seu Helpdesk. Consultar o status de um ticket existente não passa pela regra de "primeiro resolver". ## Créditos Conectar e testar o Odoo não consome créditos. Cada resposta do agente que consulta seu Odoo em tempo real (pedidos, ou preço e estoque) soma **0,5 crédito de IA** ao custo normal da resposta, uma única vez por resposta. Os testes no Playground não somam essa cobrança. Veja [Modelos de IA e créditos](https://docs.chatnorris.ai/pt/guias/modelos-ia-creditos.md). ## Pausar ou desconectar * **Pausar:** desative a chave **Ativa** da linha do Odoo em **Integrações**. A API key é mantida, mas a Ação não consegue chamar o seu Odoo até que você a reative. * **Desconectar:** no menu **···** ou no detalhe do Odoo, clique em **Desconectar**. A Ação Odoo é desativada, mas sua configuração é mantida, e a API key é apagada do ChatNorris. Para voltar a usar a Ação, conecte o Odoo novamente e reative-a. O que já foi criado no Odoo (contatos, oportunidades e tickets) permanece na sua instância. Se você não for mais usar a API key, apague-a em **Preferências → Segurança da conta** do seu usuário do Odoo. > [!NOTE] > > Excluir a Ação Odoo (botão **Excluir ação**) interrompe a sincronização de leads, a consulta de pedidos e a gestão de tickets com o Odoo, e não pode ser desfeito. ## Perguntas frequentes > [accordion] Por que não vejo o Odoo como opção? > > O Odoo é exclusivo do plano Premium — se a sua organização estiver no Free ou no Standard, ele não aparece como conectável nem como ação que pode ser criada. Confira os [planos](https://docs.chatnorris.ai/pt/guias/modelos-ia-creditos.md) ou escreva para [**hola@chatnorris.ai**](mailto:hola@chatnorris.ai). > [accordion] Um recurso aparece desabilitado > > A sua instância não tem instalado o módulo de que esse recurso precisa (veja a tabela de [Configurar a Ação](#configurar-a-ação)). Se você acabou de instalá-lo, teste a conexão novamente em **Integrações** para que o ChatNorris o detecte. **Montar compra**, além disso, precisa de **Consultar estoque e preço** ativo. > [accordion] O visitante preencheu o telefone depois e ele não chegou ao Odoo > > A sincronização de leads acontece uma única vez, quando o visitante confirma seus dados pela primeira vez. Os dados que ele adicionar depois não são sincronizados novamente de forma automática. > [accordion] Posso usar Odoo e WooCommerce no mesmo agente? > > Sim, mas só um dos dois pode consultar pedidos e estoque. O mais comum é deixar no Odoo os leads e os tickets, e no WooCommerce a consulta de pedidos e estoque. Veja [WooCommerce](https://docs.chatnorris.ai/pt/guias/woocommerce.md). > [accordion] Posso conectar duas instâncias do Odoo no mesmo agente? > > Não. Cada provedor admite uma única conexão por agente. Se você precisar conectar instâncias diferentes, use agentes separados. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.