Saltar para o conteúdo principal

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 ou escrever para hola@chatnorris.ai.
  • Pelo menos um agente criado no ChatNorris. Se você ainda não tem um, siga Criar um agente.
  • 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).
  • Função Owner ou Admin na sua organização do ChatNorris.
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), 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.
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.
Se a sua instância não tiver o módulo correspondente instalado, esse recurso aparece desabilitado.
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.
Uma única loja por agente. Um agente pode ter apenas uma loja ativa para consultar pedidos e estoque (por exemplo, Odoo ou WooCommerce). 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.
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 na conversa.
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) 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.
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.

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.
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

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 ou escreva para hola@chatnorris.ai.
A sua instância não tem instalado o módulo de que esse recurso precisa (veja a tabela de 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.
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.
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.
Não. Cada provedor admite uma única conexão por agente. Se você precisar conectar instâncias diferentes, use agentes separados.